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 ()
double	gtk_page_setup_get_top_margin ()
void	gtk_page_setup_set_top_margin ()
double	gtk_page_setup_get_bottom_margin ()
void	gtk_page_setup_set_bottom_margin ()
double	gtk_page_setup_get_left_margin ()
void	gtk_page_setup_set_left_margin ()
double	gtk_page_setup_get_right_margin ()
void	gtk_page_setup_set_right_margin ()
void	gtk_page_setup_set_paper_size_and_default_margins ()
double	gtk_page_setup_get_paper_width ()
double	gtk_page_setup_get_paper_height ()
double	gtk_page_setup_get_page_width ()
double	gtk_page_setup_get_page_height ()
GtkPageSetup *	gtk_page_setup_new_from_file ()
GtkPageSetup *	gtk_page_setup_new_from_key_file ()
GtkPageSetup *	gtk_page_setup_new_from_gvariant ()
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 ()
GVariant *	gtk_page_setup_to_gvariant ()

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

GtkPageSetup

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

    GObject
    ╰── GtkPageSetup

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

#include <gtk/gtk.h>

Описание

Объект 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;
}

Функции

gtk_page_setup_new ()

GtkPageSetup *
gtk_page_setup_new (void);

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

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

новый GtkPageSetup.

gtk_page_setup_copy ()

GtkPageSetup *
gtk_page_setup_copy (GtkPageSetup *other);

Копирует GtkPageSetup.

Параметры

other

копируемый GtkPageSetup

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

копию other .

[полная передача]

gtk_page_setup_get_orientation ()

GtkPageOrientation
gtk_page_setup_get_orientation (GtkPageSetup *setup);

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

Параметры

setup

GtkPageSetup

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

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

gtk_page_setup_set_orientation ()

void
gtk_page_setup_set_orientation (GtkPageSetup *setup,
                                GtkPageOrientation orientation);

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

Параметры

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

gtk_page_setup_get_paper_size ()

GtkPaperSize *
gtk_page_setup_get_paper_size (GtkPageSetup *setup);

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

Параметры

setup

GtkPageSetup

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

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

[передача отсутствует]

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

gtk_page_setup_get_top_margin ()

double
gtk_page_setup_get_top_margin (GtkPageSetup *setup,
                               GtkUnit unit);

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

Параметры

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

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

верхнее поле

gtk_page_setup_set_top_margin ()

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

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

Параметры

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

gtk_page_setup_get_bottom_margin ()

double
gtk_page_setup_get_bottom_margin (GtkPageSetup *setup,
                                  GtkUnit unit);

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

Параметры

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

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

нижнее поле

gtk_page_setup_set_bottom_margin ()

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

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

Параметры

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

gtk_page_setup_get_left_margin ()

double
gtk_page_setup_get_left_margin (GtkPageSetup *setup,
                                GtkUnit unit);

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

Параметры

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

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

левое поле

gtk_page_setup_set_left_margin ()

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

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

Параметры

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

gtk_page_setup_get_right_margin ()

double
gtk_page_setup_get_right_margin (GtkPageSetup *setup,
                                 GtkUnit unit);

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

Параметры

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

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

правое поле

gtk_page_setup_set_right_margin ()

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

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

Параметры

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

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

gtk_page_setup_get_paper_width ()

double
gtk_page_setup_get_paper_width (GtkPageSetup *setup,
                                GtkUnit unit);

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

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

Параметры

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

Возвращает

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

gtk_page_setup_get_paper_height ()

double
gtk_page_setup_get_paper_height (GtkPageSetup *setup,
                                 GtkUnit unit);

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

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

Параметры

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

Возвращает

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

gtk_page_setup_get_page_width ()

double
gtk_page_setup_get_page_width (GtkPageSetup *setup,
                               GtkUnit unit);

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

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

Параметры

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

Возвращает

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

gtk_page_setup_get_page_height ()

double
gtk_page_setup_get_page_height (GtkPageSetup *setup,
                                GtkUnit unit);

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

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

Параметры

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

Возвращает

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

gtk_page_setup_new_from_file ()

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

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

Параметры

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

Возвращает

восстановленную структуру GtkPageSetup

gtk_page_setup_new_from_key_file ()

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

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

Параметры

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

Возвращает

восстановленную структуру GtkPageSetup

gtk_page_setup_new_from_gvariant ()

GtkPageSetup *
gtk_page_setup_new_from_gvariant (GVariant *variant);

Десериализует настройки страницы из варианта a{sv} в формате, созданном функцией gtk_page_setup_to_gvariant().

Параметры

variant

вариант a{sv} GVariant

Возвращает

новый объект GtkPageSetup

[transfer full]

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	структура GtkPageSetup
file_name	имя файла для чтения настроек страницы.	[type filename]
error	место для возврата ошибки, или `NULL`.	[allow-none]

Возвращает

TRUE при успехе

gtk_page_setup_load_key_file ()

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

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

Параметры

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

Возвращает

TRUE при успехе

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 при успехе

gtk_page_setup_to_key_file ()

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

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

Параметры

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

gtk_page_setup_to_gvariant ()

GVariant *
gtk_page_setup_to_gvariant (GtkPageSetup *setup);

Сериализация параметров страницы в переменную a{sv}.

Возврат: (перенос нет): новый, плавающий, GVariant

Параметры

setup

a GtkPageSetup

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

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-old.gnome.org/gtk4/4.0/GtkPageSetup.html