GtkPageSetup

GtkPageSetup — Хранит информацию о настройках страницы

Функции

GtkPageSetup *	gtk_page_setup_new ()
GtkPageSetup *	gtk_page_setup_copy ()
GtkPageOrientation	gtk_page_setup_get_orientation ()
void	gtk_page_setup_set_orientation ()
GtkPaperSize *	gtk_page_setup_get_paper_size ()
void	gtk_page_setup_set_paper_size ()
gdouble	gtk_page_setup_get_top_margin ()
void	gtk_page_setup_set_top_margin ()
gdouble	gtk_page_setup_get_bottom_margin ()
void	gtk_page_setup_set_bottom_margin ()
gdouble	gtk_page_setup_get_left_margin ()
void	gtk_page_setup_set_left_margin ()
gdouble	gtk_page_setup_get_right_margin ()
void	gtk_page_setup_set_right_margin ()
void	gtk_page_setup_set_paper_size_and_default_margins ()
gdouble	gtk_page_setup_get_paper_width ()
gdouble	gtk_page_setup_get_paper_height ()
gdouble	gtk_page_setup_get_page_width ()
gdouble	gtk_page_setup_get_page_height ()
GtkPageSetup *	gtk_page_setup_new_from_file ()
GtkPageSetup *	gtk_page_setup_new_from_key_file ()
gboolean	gtk_page_setup_load_file ()
gboolean	gtk_page_setup_load_key_file ()
gboolean	gtk_page_setup_to_file ()
void	gtk_page_setup_to_key_file ()

Типы и значения

GtkPageSetup

Иерархия объектов

    GObject
    ╰── GtkPageSetup

Файлы заголовков

#include <gtk/gtk.h>

Описание

Объект GtkPageSetup хранит размер страницы, ориентацию и отступы. Идея состоит в том, что вы можете получить один из этих параметров из диалогового окна настроек страницы, а затем передать его в GtkPrintOperation при печати. Преимущество разделения этой информации из GtkPrintSettings заключается в том, что эти параметры влияют на фактическое расположение на странице и, следовательно, должны быть установлены задолго до печати пользователем.

Отступы

Отступы, указанные в этом объекте, являются «отступами печати», то есть частями страницы, на которых принтер не может печатать. Они отличаются от отступов макета, используемых текстовым процессором; обычно они используются для определения минимального размера отступов макета.

Чтобы получить GtkPageSetup, используйте gtk_page_setup_new(), чтобы получить значения по умолчанию, или используйте gtk_print_run_page_setup_dialog(), чтобы отобразить диалоговое окно настроек страницы и получить результирующие настройки страницы.

Диалоговое окно настроек страницы

staticGtkPrintSettings*settings = NULL;
staticGtkPageSetup*page_setup = NULL;

staticvoid
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;
}

Поддержка печати была добавлена в GTK+ 2.10.

Функции

gtk_page_setup_new ()

GtkPageSetup *
gtk_page_setup_new (void);

Создаёт новый GtkPageSetup.

Возвращаемое значение

новый GtkPageSetup.

С версии: 2.10

gtk_page_setup_copy ()

GtkPageSetup *
gtk_page_setup_copy (GtkPageSetup *other);

Копирует GtkPageSetup.

Параметры

other

копируемый GtkPageSetup

Возвращаемое значение

копию other .

[transfer full]

С версии: 2.10

gtk_page_setup_get_orientation ()

GtkPageOrientation
gtk_page_setup_get_orientation (GtkPageSetup *setup);

Получает ориентацию страницы GtkPageSetup.

Параметры

setup

GtkPageSetup

Возвращаемое значение

ориентацию страницы

С версии: 2.10

gtk_page_setup_set_orientation ()

void
gtk_page_setup_set_orientation (GtkPageSetup *setup,
                                GtkPageOrientation orientation);

Устанавливает ориентацию страницы GtkPageSetup.

Параметры

setup	GtkPageSetup
orientation	значение GtkPageOrientation

С версии: 2.10

gtk_page_setup_get_paper_size ()

GtkPaperSize *
gtk_page_setup_get_paper_size (GtkPageSetup *setup);

Получает размер бумаги GtkPageSetup.

Параметры

setup

GtkPageSetup

Возвращаемое значение

размер бумаги.

[transfer none]

С версии: 2.10

gtk_page_setup_set_paper_size ()

void
gtk_page_setup_set_paper_size (GtkPageSetup *setup,
                               GtkPaperSize *size);

Устанавливает размер бумаги GtkPageSetup без изменения отступов. См. gtk_page_setup_set_paper_size_and_default_margins().

Параметры

setup	GtkPageSetup
size	GtkPaperSize

С версии: 2.10

gtk_page_setup_get_top_margin ()

gdouble
gtk_page_setup_get_top_margin (GtkPageSetup *setup,
                               GtkUnit unit);

Получает верхний отступ в единицах unit .

Параметры

setup	GtkPageSetup
unit	единица измерения возвращаемого значения

Возвращаемое значение

верхний отступ

С версии: 2.10

gtk_page_setup_set_top_margin ()

void
gtk_page_setup_set_top_margin (GtkPageSetup *setup,
                               gdouble margin,
                               GtkUnit unit);

Устанавливает верхний отступ GtkPageSetup.

Параметры

setup	GtkPageSetup
margin	новый верхний отступ в единицах `unit`
unit	единицы измерения для `margin`

С версии: 2.10

gtk_page_setup_get_bottom_margin ()

gdouble
gtk_page_setup_get_bottom_margin (GtkPageSetup *setup,
                                  GtkUnit unit);

Получает нижний отступ в единицах unit .

Параметры

setup	GtkPageSetup
unit	единица измерения возвращаемого значения

Возвращаемое значение

нижний отступ

С версии: 2.10

gtk_page_setup_set_bottom_margin ()

void
gtk_page_setup_set_bottom_margin (GtkPageSetup *setup,
                                  gdouble margin,
                                  GtkUnit unit);

Устанавливает нижний отступ GtkPageSetup.

Параметры

setup	GtkPageSetup
margin	новый нижний отступ в единицах `unit`
unit	единицы измерения для `margin`

С версии: 2.10

gtk_page_setup_get_left_margin ()

gdouble
gtk_page_setup_get_left_margin (GtkPageSetup *setup,
                                GtkUnit unit);

Получает левый отступ в единицах unit .

Параметры

setup	GtkPageSetup
unit	единица измерения возвращаемого значения

Возвращаемое значение

левый отступ

С версии: 2.10

gtk_page_setup_set_left_margin ()

void
gtk_page_setup_set_left_margin (GtkPageSetup *setup,
                                gdouble margin,
                                GtkUnit unit);

Устанавливает левый отступ GtkPageSetup.

Параметры

setup	GtkPageSetup
margin	новый левый отступ в единицах `unit`
unit	единицы измерения для `margin`

С версии: 2.10

gtk_page_setup_get_right_margin ()

gdouble
gtk_page_setup_get_right_margin (GtkPageSetup *setup,
                                 GtkUnit unit);

Получает правый отступ в единицах unit .

Параметры

setup	GtkPageSetup
unit	единица измерения возвращаемого значения

Возвращаемое значение

правый отступ

С версии: 2.10

gtk_page_setup_set_right_margin ()

void
gtk_page_setup_set_right_margin (GtkPageSetup *setup,
                                 gdouble margin,
                                 GtkUnit unit);

Устанавливает правую границу GtkPageSetup.

Параметры

setup	объект GtkPageSetup
margin	новая правая граница в единицах `unit`
unit	единицы измерения для `margin`

С версии: 2.10

gtk_page_setup_set_paper_size_and_default_margins ()

void
gtk_page_setup_set_paper_size_and_default_margins
                               (GtkPageSetup *setup,
                                GtkPaperSize *size);

Устанавливает размер бумаги для GtkPageSetup и изменяет поля в соответствии с новым размером.

Параметры

setup	объект GtkPageSetup
size	объект GtkPaperSize

С версии: 2.10

gtk_page_setup_get_paper_width ()

gdouble
gtk_page_setup_get_paper_width (GtkPageSetup *setup,
                                GtkUnit unit);

Возвращает ширину бумаги в единицах unit.

Обратите внимание, что эта функция учитывает ориентацию, но не поля. См. gtk_page_setup_get_page_width().

Параметры

setup	объект GtkPageSetup
unit	единицы измерения для возвращаемого значения

Возвращаемое значение

ширина бумаги.

С версии: 2.10

gtk_page_setup_get_paper_height ()

gdouble
gtk_page_setup_get_paper_height (GtkPageSetup *setup,
                                 GtkUnit unit);

Возвращает высоту бумаги в единицах unit.

Обратите внимание, что эта функция учитывает ориентацию, но не поля. См. gtk_page_setup_get_page_height().

Параметры

setup	объект GtkPageSetup
unit	единицы измерения для возвращаемого значения

Возвращаемое значение

высота бумаги.

С версии: 2.10

gtk_page_setup_get_page_width ()

gdouble
gtk_page_setup_get_page_width (GtkPageSetup *setup,
                               GtkUnit unit);

Возвращает ширину страницы в единицах unit.

Обратите внимание, что эта функция учитывает ориентацию и поля. См. gtk_page_setup_get_paper_width().

Параметры

setup	объект GtkPageSetup
unit	единицы измерения для возвращаемого значения

Возвращаемое значение

ширина страницы.

С версии: 2.10

gtk_page_setup_get_page_height ()

gdouble
gtk_page_setup_get_page_height (GtkPageSetup *setup,
                                GtkUnit unit);

Возвращает высоту страницы в единицах unit.

Обратите внимание, что эта функция учитывает ориентацию и поля. См. gtk_page_setup_get_paper_height().

Параметры

setup	объект GtkPageSetup
unit	единицы измерения для возвращаемого значения

Возвращаемое значение

высота страницы.

С версии: 2.10

gtk_page_setup_new_from_file ()

GtkPageSetup *
gtk_page_setup_new_from_file (const gchar *file_name,
                              GError **error);

Считывает настройки страницы из файла file_name. Возвращает новый объект GtkPageSetup с восстановленными настройками страницы, или NULL в случае ошибки. См. gtk_page_setup_to_file().

Параметры

file_name	имя файла для считывания настроек страницы.	[type filename]
error	место для возвращения ошибки или `NULL`.	[allow-none]

Возвращаемое значение

восстановленный объект GtkPageSetup

С версии: 2.12

gtk_page_setup_new_from_key_file ()

GtkPageSetup *
gtk_page_setup_new_from_key_file (GKeyFile *key_file,
                                  const gchar *group_name,
                                  GError **error);

Считывает настройки страницы из группы group_name в ключевом файле key_file. Возвращает новый объект GtkPageSetup с восстановленными настройками страницы или NULL в случае ошибки.

Параметры

key_file	объект GKeyFile для извлечения настроек страницы
group_name	имя группы в key_file для чтения, или `NULL` для использования имени по умолчанию «Настройка страницы».	[allow-none]
error	место для возвращения ошибки или `NULL`.	[allow-none]

Возвращаемое значение

восстановленный объект GtkPageSetup

С версии: 2.12

gtk_page_setup_load_file ()

gboolean
gtk_page_setup_load_file (GtkPageSetup *setup,
                          const char *file_name,
                          GError **error);

Читает настройки страницы из файла file_name. См. gtk_page_setup_to_file().

Параметры

setup	a GtkPageSetup
file_name	имя файла для чтения настроек страницы.	[type filename]
error	место для возврата ошибки или `NULL`.	[allow-none]

Возвращаемое значение

TRUE при успешном выполнении

С: 2.14

gtk_page_setup_load_key_file ()

gboolean
gtk_page_setup_load_key_file (GtkPageSetup *setup,
                              GKeyFile *key_file,
                              const gchar *group_name,
                              GError **error);

Читает настройки страницы из группы group_name в файле ключей key_file.

Параметры

setup	a GtkPageSetup
key_file	the GKeyFile для получения page_setup
group_name	имя группы в key_file для чтения, или `NULL` для использования имени по умолчанию «Page Setup».	[allow-none]
error	место для возврата ошибки или `NULL`.	[allow-none]

Возвращаемое значение

TRUE при успешном выполнении

С: 2.14

gtk_page_setup_to_file ()

gboolean
gtk_page_setup_to_file (GtkPageSetup *setup,
                        const char *file_name,
                        GError **error);

Эта функция сохраняет информацию из setup в file_name.

Параметры

setup	a GtkPageSetup
file_name	файл для сохранения.	[type filename]
error	место для возврата ошибок или `NULL`.	[allow-none]

Возвращаемое значение

TRUE при успешном выполнении

С: 2.12

gtk_page_setup_to_key_file ()

void
gtk_page_setup_to_key_file (GtkPageSetup *setup,
                            GKeyFile *key_file,
                            const gchar *group_name);

Эта функция добавляет настройки страницы из setup в key_file.

Параметры

setup	a GtkPageSetup
key_file	the GKeyFile для сохранения настроек страницы
group_name	группа для добавления настроек в `key_file`, или `NULL` для использования имени по умолчанию «Page Setup»

С: 2.12

Типы и значения

GtkPageSetup

typedef struct _GtkPageSetup GtkPageSetup;

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.20/GtkPageSetup.html