GtkPageSetup

描述 [src]

final class Gtk.PageSetup : GObject.Object
{
  /* No available fields */
}

GtkPageSetup 对象存储页面尺寸、方向和边距。

其理念是你可以从页面设置对话框中获取其中一个,然后在打印时将其传递给 GtkPrintOperation。将其从 GtkPrintSettings 中分离出来的优点在于,它们影响页面的实际布局,因此需要在用户打印很早之前对其进行设置。

边距

本对象中指定的边距为“打印边距”,即打印机无法打印在上面的页面部分。它们不同于文字处理器使用的布局边距;通常用于确定布局边距的最小尺寸。

要获取 GtkPageSetup,请使用 gtk_page_setup_new() 获取默认值,或使用 gtk_print_run_page_setup_dialog() 显示页面设置对话框并接收结果页面设置。

页面设置对话框

static GtkPrintSettings *settings = NULL;
static GtkPageSetup *page_setup = NULL;

static void
do_page_setup (void)
{
  GtkPageSetup *new_page_setup;

  if (settings == NULL)
    settings = gtk_print_settings_new ();

  new_page_setup = gtk_print_run_page_setup_dialog (GTK_WINDOW (main_window),
                                                    page_setup, settings);

  if (page_setup)
    g_object_unref (page_setup);

  page_setup = new_page_setup;
}

层次结构

hierarchy this GtkPageSetup ancestor_0 GObject ancestor_0--this

祖先

构造函数

gtk_page_setup_new

创建新的 GtkPageSetup

gtk_page_setup_new_from_file

从文件 file_name 读取页面设置。

gtk_page_setup_new_from_gvariant

从 a{sv} 变量反序列化页面设置。

gtk_page_setup_new_from_key_file

从密钥文件 key_file 中的组 group_name 读取页面设置。

实例方法

gtk_page_setup_copy

复制 GtkPageSetup

gtk_page_setup_get_bottom_margin

unit 为单位获取底部边距。

gtk_page_setup_get_left_margin

unit 为单位获取左边距。

gtk_page_setup_get_orientation

获取 GtkPageSetup 的页面方向。

gtk_page_setup_get_page_height

unit 为单位返回页面高度。

gtk_page_setup_get_page_width

返回以 unit 为单位的页面宽度。

gtk_page_setup_get_paper_height

返回以 unit 为单位的纸张高度。

gtk_page_setup_get_paper_size

获取 GtkPageSetup 的纸张大小。

gtk_page_setup_get_paper_width

返回以 unit 为单位的纸张宽度。

gtk_page_setup_get_right_margin

获取以 unit 为单位的右边界。

gtk_page_setup_get_top_margin

获取以 unit 为单位的上边界。

gtk_page_setup_load_file

从文件 file_name 读取页面设置。

gtk_page_setup_load_key_file

从密钥文件 key_file 中的组 group_name 读取页面设置。

gtk_page_setup_set_bottom_margin

设置 GtkPageSetup 的下边界。

gtk_page_setup_set_left_margin

设置 GtkPageSetup 的左边界。

gtk_page_setup_set_orientation

设置 GtkPageSetup 的页面方向。

gtk_page_setup_set_paper_size

设置 GtkPageSetup 的纸张大小,不改变边距。

gtk_page_setup_set_paper_size_and_default_margins

设置 GtkPageSetup 的纸张大小,并根据新纸张大小修改边距。

gtk_page_setup_set_right_margin

设置 GtkPageSetup 的右边界。

gtk_page_setup_set_top_margin

设置 GtkPageSetup 的上边界。

gtk_page_setup_to_file

此函数将 setup 中的信息保存到 file_name

gtk_page_setup_to_gvariant

将页面设置序列化到 a{sv} 变体。

gtk_page_setup_to_key_file

此函数将 setup 中的页面设置添加到 key_file

Methods 继承自 GObject (43)

有关方法的完整列表,请参阅 GObject

信号

信号继承自 GObject (1)
GObject::notify

当某个属性通过 g_object_set_property()、g_object_set() 等等将值设置为其值时,notify 信号将发出到某个对象。