GtkPrintSettings

GtkPrintSettings — Хранит параметры печати

Функции

void	(GtkPrintSettingsFunc) ()
GtkPrintSettings *	gtk_print_settings_new ()
GtkPrintSettings *	gtk_print_settings_copy ()
gboolean	gtk_print_settings_has_key ()
const gchar *	gtk_print_settings_get ()
void	gtk_print_settings_set ()
void	gtk_print_settings_unset ()
void	gtk_print_settings_foreach ()
gboolean	gtk_print_settings_get_bool ()
void	gtk_print_settings_set_bool ()
gdouble	gtk_print_settings_get_double ()
gdouble	gtk_print_settings_get_double_with_default ()
void	gtk_print_settings_set_double ()
gdouble	gtk_print_settings_get_length ()
void	gtk_print_settings_set_length ()
gint	gtk_print_settings_get_int ()
gint	gtk_print_settings_get_int_with_default ()
void	gtk_print_settings_set_int ()
const gchar *	gtk_print_settings_get_printer ()
void	gtk_print_settings_set_printer ()
GtkPageOrientation	gtk_print_settings_get_orientation ()
void	gtk_print_settings_set_orientation ()
GtkPaperSize *	gtk_print_settings_get_paper_size ()
void	gtk_print_settings_set_paper_size ()
gdouble	gtk_print_settings_get_paper_width ()
void	gtk_print_settings_set_paper_width ()
gdouble	gtk_print_settings_get_paper_height ()
void	gtk_print_settings_set_paper_height ()
gboolean	gtk_print_settings_get_use_color ()
void	gtk_print_settings_set_use_color ()
gboolean	gtk_print_settings_get_collate ()
void	gtk_print_settings_set_collate ()
gboolean	gtk_print_settings_get_reverse ()
void	gtk_print_settings_set_reverse ()

GtkPrintDuplex	gtk_print_settings_get_duplex ()
void	gtk_print_settings_set_duplex ()
GtkPrintQuality	gtk_print_settings_get_quality ()
void	gtk_print_settings_set_quality ()
gint	gtk_print_settings_get_n_copies ()
void	gtk_print_settings_set_n_copies ()
gint	gtk_print_settings_get_number_up ()
void	gtk_print_settings_set_number_up ()
GtkNumberUpLayout	gtk_print_settings_get_number_up_layout ()
void	gtk_print_settings_set_number_up_layout ()
gint	gtk_print_settings_get_resolution ()
void	gtk_print_settings_set_resolution ()
void	gtk_print_settings_set_resolution_xy ()
gint	gtk_print_settings_get_resolution_x ()
gint	gtk_print_settings_get_resolution_y ()
gdouble	gtk_print_settings_get_printer_lpi ()
void	gtk_print_settings_set_printer_lpi ()
gdouble	gtk_print_settings_get_scale ()
void	gtk_print_settings_set_scale ()
GtkPrintPages	gtk_print_settings_get_print_pages ()
void	gtk_print_settings_set_print_pages ()
GtkPageRange *	gtk_print_settings_get_page_ranges ()
void	gtk_print_settings_set_page_ranges ()
GtkPageSet	gtk_print_settings_get_page_set ()
void	gtk_print_settings_set_page_set ()
const gchar *	gtk_print_settings_get_default_source ()
void	gtk_print_settings_set_default_source ()
const gchar *	gtk_print_settings_get_media_type ()
void	gtk_print_settings_set_media_type ()
const gchar *	gtk_print_settings_get_dither ()
void	gtk_print_settings_set_dither ()
const gchar *	gtk_print_settings_get_finishings ()
void	gtk_print_settings_set_finishings ()

const gchar *	gtk_print_settings_get_output_bin ()
void	gtk_print_settings_set_output_bin ()
GtkPrintSettings *	gtk_print_settings_new_from_file ()
GtkPrintSettings *	gtk_print_settings_new_from_key_file ()
gboolean	gtk_print_settings_load_file ()
gboolean	gtk_print_settings_load_key_file ()
gboolean	gtk_print_settings_to_file ()
void	gtk_print_settings_to_key_file ()

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

	GtkPrintSettings
#define	GTK_PRINT_SETTINGS_PRINTER
перечисление	GtkPageOrientation
#define	GTK_PRINT_SETTINGS_ORIENTATION
#define	GTK_PRINT_SETTINGS_PAPER_FORMAT
#define	GTK_PRINT_SETTINGS_PAPER_WIDTH
#define	GTK_PRINT_SETTINGS_PAPER_HEIGHT
#define	GTK_PRINT_SETTINGS_USE_COLOR
#define	GTK_PRINT_SETTINGS_COLLATE
#define	GTK_PRINT_SETTINGS_REVERSE
перечисление	GtkPrintDuplex
#define	GTK_PRINT_SETTINGS_DUPLEX
перечисление	GtkPrintQuality
#define	GTK_PRINT_SETTINGS_QUALITY
#define	GTK_PRINT_SETTINGS_N_COPIES
#define	GTK_PRINT_SETTINGS_NUMBER_UP
перечисление	GtkNumberUpLayout
#define	GTK_PRINT_SETTINGS_NUMBER_UP_LAYOUT
#define	GTK_PRINT_SETTINGS_RESOLUTION
#define	GTK_PRINT_SETTINGS_RESOLUTION_X
#define	GTK_PRINT_SETTINGS_RESOLUTION_Y
#define	GTK_PRINT_SETTINGS_PRINTER_LPI
#define	GTK_PRINT_SETTINGS_SCALE
перечисление	GtkPrintPages
#define	GTK_PRINT_SETTINGS_PRINT_PAGES
структура	GtkPageRange
#define	GTK_PRINT_SETTINGS_PAGE_RANGES
перечисление	GtkPageSet
#define	GTK_PRINT_SETTINGS_PAGE_SET
#define	GTK_PRINT_SETTINGS_DEFAULT_SOURCE
#define	GTK_PRINT_SETTINGS_MEDIA_TYPE
#define	GTK_PRINT_SETTINGS_DITHER
#define	GTK_PRINT_SETTINGS_FINISHINGS
#define	GTK_PRINT_SETTINGS_OUTPUT_BIN
#define	GTK_PRINT_SETTINGS_OUTPUT_DIR
#define	GTK_PRINT_SETTINGS_OUTPUT_BASENAME
#define	GTK_PRINT_SETTINGS_OUTPUT_FILE_FORMAT
#define	GTK_PRINT_SETTINGS_OUTPUT_URI
#define	GTK_PRINT_SETTINGS_WIN32_DRIVER_EXTRA
#define	GTK_PRINT_SETTINGS_WIN32_DRIVER_VERSION

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

    GObject
    ╰── GtkPrintSettings

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

#include <gtk/gtk.h>

Описание

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

Также можно перечислить настройки, чтобы вы могли легко сохранить настройки для следующего запуска приложения или даже сохранить их в документе. Предопределенные ключи стараются использовать общие значения по возможности, чтобы перемещение такого документа между системами по-прежнему работало.

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

Функции

GtkPrintSettingsFunc ()

void
(*GtkPrintSettingsFunc) (const gchar *key,
                         const gchar *value,
                         gpointer user_data);

gtk_print_settings_new ()

GtkPrintSettings *
gtk_print_settings_new (void);

Создаёт новый объект GtkPrintSettings.

Возвращает

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

С: 2.10

gtk_print_settings_copy ()

GtkPrintSettings *
gtk_print_settings_copy (GtkPrintSettings *other);

Копирует объект GtkPrintSettings.

Параметры

other

объект GtkPrintSettings

Возвращает

новую скопированную копию other .

[transfer full]

С: 2.10

gtk_print_settings_has_key ()

gboolean
gtk_print_settings_has_key (GtkPrintSettings *settings,
                            const gchar *key);

Возвращает TRUE, если значение ассоциировано с key .

Параметры

settings	объект GtkPrintSettings
key	ключ

Возвращает

TRUE, если у key есть значение

С: 2.10

gtk_print_settings_get ()

const gchar *
gtk_print_settings_get (GtkPrintSettings *settings,
                        const gchar *key);

Ищет строковое значение, связанное с key .

Параметры

settings	объект GtkPrintSettings
key	ключ

Возвращает

строковое значение для key

С: 2.10

gtk_print_settings_set ()

void
gtk_print_settings_set (GtkPrintSettings *settings,
                        const gchar *key,
                        const gchar *value);

Связывает value с key .

Параметры

settings	объект GtkPrintSettings
key	ключ
value	строковое значение или `NULL`.	[allow-none]

С: 2.10

gtk_print_settings_unset ()

void
gtk_print_settings_unset (GtkPrintSettings *settings,
                          const gchar *key);

Удаляет любое значение, связанное с key. Это эквивалентно установке значения в NULL.

Параметры

settings	объект GtkPrintSettings
key	ключ

С: 2.10

gtk_print_settings_foreach ()

void
gtk_print_settings_foreach (GtkPrintSettings *settings,
                            GtkPrintSettingsFunc func,
                            gpointer user_data);

Вызывает func для каждой пары ключ-значение в settings .

Параметры

settings	объект GtkPrintSettings
func	функция для вызова.	[scope call]
user_data	данные пользователя для `func`

С: 2.10

gtk_print_settings_get_bool ()

gboolean
gtk_print_settings_get_bool (GtkPrintSettings *settings,
                             const gchar *key);

Возвращает логическое значение, представленное значением, связанным с key .

Строка “true” представляет TRUE, любая другая строка FALSE.

Параметры

settings	объект GtkPrintSettings
key	ключ

Возвращает

TRUE, если key сопоставлено со значением true.

С: 2.10

gtk_print_settings_set_bool ()

void
gtk_print_settings_set_bool (GtkPrintSettings *settings,
                             const gchar *key,
                             gboolean value);

Устанавливает key в булево значение.

Параметры

settings	объект GtkPrintSettings
key	ключ
value	булево значение

С: 2.10

gtk_print_settings_get_double ()

gdouble
gtk_print_settings_get_double (GtkPrintSettings *settings,
                               const gchar *key);

Возвращает двойное значение, связанное с key, или 0.

Параметры

settings	объект GtkPrintSettings
key	ключ

Возвращает

двойное значение key

С: 2.10

gtk_print_settings_get_double_with_default ()

gdouble
gtk_print_settings_get_double_with_default
                               (GtkPrintSettings *settings,
                                const gchar *key,
                                gdouble def);

Возвращает число с плавающей точкой, представленное значением, связанным с key, или default_val, если значение не представляет число с плавающей точкой.

Числа с плавающей точкой анализируются с помощью g_ascii_strtod().

Параметры

settings	объект GtkPrintSettings
key	ключ
def	значение по умолчанию

Возвращает

число с плавающей точкой, связанное с key

С: 2.10

gtk_print_settings_set_double ()

void
gtk_print_settings_set_double (GtkPrintSettings *settings,
                               const gchar *key,
                               gdouble value);

Устанавливает key в значение типа double.

Параметры

settings	a GtkPrintSettings
key	ключ
value	значение типа double

Since: 2.10

gtk_print_settings_get_length ()

gdouble
gtk_print_settings_get_length (GtkPrintSettings *settings,
                               const gchar *key,
                               GtkUnit unit);

Возвращает значение, связанное с key, интерпретируемое как длина. Возвращаемое значение преобразуется к units.

Параметры

settings	a GtkPrintSettings
key	ключ
unit	единица измерения возвращаемого значения

Возвращает

значение длины key, преобразованное к unit

Since: 2.10

gtk_print_settings_set_length ()

void
gtk_print_settings_set_length (GtkPrintSettings *settings,
                               const gchar *key,
                               gdouble value,
                               GtkUnit unit);

Связывает длину в единицах unit с key.

Параметры

settings	a GtkPrintSettings
key	ключ
value	длина
unit	единица измерения `length`

Since: 2.10

gtk_print_settings_get_int ()

gint
gtk_print_settings_get_int (GtkPrintSettings *settings,
                            const gchar *key);

Возвращает целочисленное значение key или 0.

Параметры

settings	a GtkPrintSettings
key	ключ

Возвращает

целочисленное значение key

Since: 2.10

gtk_print_settings_get_int_with_default ()

gint
gtk_print_settings_get_int_with_default
                               (GtkPrintSettings *settings,
                                const gchar *key,
                                gint def);

Возвращает значение key, интерпретируемое как целое число, или значение по умолчанию.

Параметры

settings	a GtkPrintSettings
key	ключ
def	значение по умолчанию

Возвращает

целочисленное значение key

Since: 2.10

gtk_print_settings_set_int ()

void
gtk_print_settings_set_int (GtkPrintSettings *settings,
                            const gchar *key,
                            gint value);

Устанавливает key в целочисленное значение.

Параметры

settings	a GtkPrintSettings
key	ключ
value	целое число

Since: 2.10

gtk_print_settings_get_printer ()

const gchar *
gtk_print_settings_get_printer (GtkPrintSettings *settings);

Функция для получения значения GTK_PRINT_SETTINGS_PRINTER.

Параметры

settings

a GtkPrintSettings

Возвращает

имя принтера

Since: 2.10

gtk_print_settings_set_printer ()

void
gtk_print_settings_set_printer (GtkPrintSettings *settings,
                                const gchar *printer);

Функция для установки GTK_PRINT_SETTINGS_PRINTER на printer.

Параметры

settings	a GtkPrintSettings
printer	имя принтера

Since: 2.10

gtk_print_settings_get_orientation ()

GtkPageOrientation
gtk_print_settings_get_orientation (GtkPrintSettings *settings);

Получение значения GTK_PRINT_SETTINGS_ORIENTATION, преобразованного в GtkPageOrientation.

Параметры

settings

a GtkPrintSettings

Возвращает

ориентацию

Since: 2.10

gtk_print_settings_set_orientation ()

void
gtk_print_settings_set_orientation (GtkPrintSettings *settings,
                                    GtkPageOrientation orientation);

Устанавливает значение GTK_PRINT_SETTINGS_ORIENTATION.

Параметры

settings	a GtkPrintSettings
orientation	ориентация страницы

Since: 2.10

gtk_print_settings_get_paper_size ()

GtkPaperSize *
gtk_print_settings_get_paper_size (GtkPrintSettings *settings);

Получение значения GTK_PRINT_SETTINGS_PAPER_FORMAT, преобразованного в GtkPaperSize.

Параметры

settings

a GtkPrintSettings

Возвращает

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

Since: 2.10

gtk_print_settings_set_paper_size ()

void
gtk_print_settings_set_paper_size (GtkPrintSettings *settings,
                                   GtkPaperSize *paper_size);

Устанавливает значение GTK_PRINT_SETTINGS_PAPER_FORMAT, GTK_PRINT_SETTINGS_PAPER_WIDTH и GTK_PRINT_SETTINGS_PAPER_HEIGHT.

Параметры

settings	a GtkPrintSettings
paper_size	размер бумаги

С: 2.10

gtk_print_settings_get_paper_width ()

gdouble
gtk_print_settings_get_paper_width (GtkPrintSettings *settings,
                                    GtkUnit unit);

Получает значение GTK_PRINT_SETTINGS_PAPER_WIDTH, преобразованное в unit .

Параметры

settings	a GtkPrintSettings
unit	единица измерения для возвращаемого значения

Возвращает

ширина бумаги в единицах unit

С: 2.10

gtk_print_settings_set_paper_width ()

void
gtk_print_settings_set_paper_width (GtkPrintSettings *settings,
                                    gdouble width,
                                    GtkUnit unit);

Устанавливает значение GTK_PRINT_SETTINGS_PAPER_WIDTH.

Параметры

settings	a GtkPrintSettings
width	ширина бумаги
unit	единицы измерения `width`

С: 2.10

gtk_print_settings_get_paper_height ()

gdouble
gtk_print_settings_get_paper_height (GtkPrintSettings *settings,
                                     GtkUnit unit);

Получает значение GTK_PRINT_SETTINGS_PAPER_HEIGHT, преобразованное в unit .

Параметры

settings	a GtkPrintSettings
unit	единица измерения для возвращаемого значения

Возвращает

высота бумаги в единицах unit

С: 2.10

gtk_print_settings_set_paper_height ()

void
gtk_print_settings_set_paper_height (GtkPrintSettings *settings,
                                     gdouble height,
                                     GtkUnit unit);

Устанавливает значение GTK_PRINT_SETTINGS_PAPER_HEIGHT.

Параметры

settings	a GtkPrintSettings
height	высота бумаги
unit	единицы измерения `height`

С: 2.10

gtk_print_settings_get_use_color ()

gboolean
gtk_print_settings_get_use_color (GtkPrintSettings *settings);

Получает значение GTK_PRINT_SETTINGS_USE_COLOR.

Параметры

settings

a GtkPrintSettings

Возвращает

использовать цвет или нет

С: 2.10

gtk_print_settings_set_use_color ()

void
gtk_print_settings_set_use_color (GtkPrintSettings *settings,
                                  gboolean use_color);

Устанавливает значение GTK_PRINT_SETTINGS_USE_COLOR.

Параметры

settings	a GtkPrintSettings
use_color	использовать цвет или нет

С: 2.10

gtk_print_settings_get_collate ()

gboolean
gtk_print_settings_get_collate (GtkPrintSettings *settings);

Получает значение GTK_PRINT_SETTINGS_COLLATE.

Параметры

settings

a GtkPrintSettings

Возвращает

сортировать ли отпечатанные страницы

С: 2.10

gtk_print_settings_set_collate ()

void
gtk_print_settings_set_collate (GtkPrintSettings *settings,
                                gboolean collate);

Устанавливает значение GTK_PRINT_SETTINGS_COLLATE.

Параметры

settings	a GtkPrintSettings
collate	сортировать ли вывод

С: 2.10

gtk_print_settings_get_reverse ()

gboolean
gtk_print_settings_get_reverse (GtkPrintSettings *settings);

Получает значение GTK_PRINT_SETTINGS_REVERSE.

Параметры

settings

a GtkPrintSettings

Возвращает

обратить ли порядок отпечатанных страниц

С: 2.10

gtk_print_settings_set_reverse ()

void
gtk_print_settings_set_reverse (GtkPrintSettings *settings,
                                gboolean reverse);

Устанавливает значение GTK_PRINT_SETTINGS_REVERSE.

Параметры

settings	a GtkPrintSettings
reverse	обратить ли порядок вывода

С: 2.10

gtk_print_settings_get_duplex ()

GtkPrintDuplex
gtk_print_settings_get_duplex (GtkPrintSettings *settings);

Получает значение GTK_PRINT_SETTINGS_DUPLEX.

Параметры

settings

a GtkPrintSettings

Возвращает

печатать ли в дуплексе

С: 2.10

gtk_print_settings_set_duplex ()

void
gtk_print_settings_set_duplex (GtkPrintSettings *settings,
                               GtkPrintDuplex duplex);

Устанавливает значение GTK_PRINT_SETTINGS_DUPLEX.

Параметры

settings	a GtkPrintSettings
duplex	значение GtkPrintDuplex

С: 2.10

gtk_print_settings_get_quality ()

GtkPrintQuality
gtk_print_settings_get_quality (GtkPrintSettings *settings);

Получает значение GTK_PRINT_SETTINGS_QUALITY.

Параметры

settings

a GtkPrintSettings

Возвращает

качество печати

С: 2.10

gtk_print_settings_set_quality ()

void
gtk_print_settings_set_quality (GtkPrintSettings *settings,
                                GtkPrintQuality quality);

Устанавливает значение GTK_PRINT_SETTINGS_QUALITY.

Параметры

settings	a GtkPrintSettings
quality	значение GtkPrintQuality

С: 2.10

gtk_print_settings_get_n_copies ()

gint
gtk_print_settings_get_n_copies (GtkPrintSettings *settings);

Получает значение GTK_PRINT_SETTINGS_N_COPIES.

Параметры

settings

a GtkPrintSettings

Возвращает

количество копий

С: 2.10

gtk_print_settings_set_n_copies ()

void
gtk_print_settings_set_n_copies (GtkPrintSettings *settings,
                                 gint num_copies);

Устанавливает значение GTK_PRINT_SETTINGS_N_COPIES.

Параметры

settings	a GtkPrintSettings
num_copies	количество копий

С: 2.10

gtk_print_settings_get_number_up ()

gint
gtk_print_settings_get_number_up (GtkPrintSettings *settings);

Получает значение GTK_PRINT_SETTINGS_NUMBER_UP.

Параметры

settings

a GtkPrintSettings

Возвращает

количество страниц на листе

С: 2.10

gtk_print_settings_set_number_up ()

void
gtk_print_settings_set_number_up (GtkPrintSettings *settings,
                                  gint number_up);

Устанавливает значение GTK_PRINT_SETTINGS_NUMBER_UP.

Параметры

settings	a GtkPrintSettings
number_up	количество страниц на листе

С: 2.10

gtk_print_settings_get_number_up_layout ()

GtkNumberUpLayout
gtk_print_settings_get_number_up_layout
                               (GtkPrintSettings *settings);

Получает значение GTK_PRINT_SETTINGS_NUMBER_UP_LAYOUT.

Параметры

settings

a GtkPrintSettings

Возвращает

макет страниц в режиме number-up

С: 2.14

gtk_print_settings_set_number_up_layout ()

void
gtk_print_settings_set_number_up_layout
                               (GtkPrintSettings *settings,
                                GtkNumberUpLayout number_up_layout);

Устанавливает значение GTK_PRINT_SETTINGS_NUMBER_UP_LAYOUT.

Параметры

settings	a GtkPrintSettings
number_up_layout	значение GtkNumberUpLayout

С: 2.14

gtk_print_settings_get_resolution ()

gint
gtk_print_settings_get_resolution (GtkPrintSettings *settings);

Получает значение GTK_PRINT_SETTINGS_RESOLUTION.

Параметры

settings

a GtkPrintSettings

Возвращает

разрешение в dpi

С: 2.10

gtk_print_settings_set_resolution ()

void
gtk_print_settings_set_resolution (GtkPrintSettings *settings,
                                   gint resolution);

Устанавливает значения GTK_PRINT_SETTINGS_RESOLUTION, GTK_PRINT_SETTINGS_RESOLUTION_X и GTK_PRINT_SETTINGS_RESOLUTION_Y.

Параметры

settings	a GtkPrintSettings
resolution	разрешение в dpi

С: 2.10

gtk_print_settings_set_resolution_xy ()

void
gtk_print_settings_set_resolution_xy (GtkPrintSettings *settings,
                                      gint resolution_x,
                                      gint resolution_y);

Устанавливает значения GTK_PRINT_SETTINGS_RESOLUTION, GTK_PRINT_SETTINGS_RESOLUTION_X и GTK_PRINT_SETTINGS_RESOLUTION_Y.

Параметры

settings	a GtkPrintSettings
resolution_x	горизонтальное разрешение в dpi
resolution_y	вертикальное разрешение в dpi

С: 2.16

gtk_print_settings_get_resolution_x ()

gint
gtk_print_settings_get_resolution_x (GtkPrintSettings *settings);

Получает значение GTK_PRINT_SETTINGS_RESOLUTION_X.

Параметры

settings

a GtkPrintSettings

Возвращает

горизонтальное разрешение в точках на дюйм (dpi)

С версии: 2.16

gtk_print_settings_get_resolution_y ()

gint
gtk_print_settings_get_resolution_y (GtkPrintSettings *settings);

Получает значение GTK_PRINT_SETTINGS_RESOLUTION_Y.

Параметры

settings

a GtkPrintSettings

Возвращает

вертикальное разрешение в точках на дюйм (dpi)

С версии: 2.16

gtk_print_settings_get_printer_lpi ()

gdouble
gtk_print_settings_get_printer_lpi (GtkPrintSettings *settings);

Получает значение GTK_PRINT_SETTINGS_PRINTER_LPI.

Параметры

settings

a GtkPrintSettings

Возвращает

разрешение в линиях на дюйм (lpi)

С версии: 2.16

gtk_print_settings_set_printer_lpi ()

void
gtk_print_settings_set_printer_lpi (GtkPrintSettings *settings,
                                    gdouble lpi);

Устанавливает значение GTK_PRINT_SETTINGS_PRINTER_LPI.

Параметры

settings	a GtkPrintSettings
lpi	разрешение в линиях на дюйм (lpi)

С версии: 2.16

gtk_print_settings_get_scale ()

gdouble
gtk_print_settings_get_scale (GtkPrintSettings *settings);

Получает значение GTK_PRINT_SETTINGS_SCALE.

Параметры

settings

a GtkPrintSettings

Возвращает

масштаб в процентах

С версии: 2.10

gtk_print_settings_set_scale ()

void
gtk_print_settings_set_scale (GtkPrintSettings *settings,
                              gdouble scale);

Устанавливает значение GTK_PRINT_SETTINGS_SCALE.

Параметры

settings	a GtkPrintSettings
scale	масштаб в процентах

С версии: 2.10

gtk_print_settings_get_print_pages ()

GtkPrintPages
gtk_print_settings_get_print_pages (GtkPrintSettings *settings);

Получает значение GTK_PRINT_SETTINGS_PRINT_PAGES.

Параметры

settings

a GtkPrintSettings

Возвращает

страницы для печати

С версии: 2.10

gtk_print_settings_set_print_pages ()

void
gtk_print_settings_set_print_pages (GtkPrintSettings *settings,
                                    GtkPrintPages pages);

Устанавливает значение GTK_PRINT_SETTINGS_PRINT_PAGES.

Параметры

settings	a GtkPrintSettings
pages	значение GtkPrintPages

С версии: 2.10

gtk_print_settings_get_page_ranges ()

GtkPageRange *
gtk_print_settings_get_page_ranges (GtkPrintSettings *settings,
                                    gint *num_ranges);

Получает значение GTK_PRINT_SETTINGS_PAGE_RANGES.

Параметры

settings	a GtkPrintSettings
num_ranges	место для хранения длины возвращаемого массива.	[out]

Возвращает

массив GtkPageRanges. Используйте g_free() для освобождения массива, когда он больше не нужен.

[array length=num_ranges][transfer full]

С версии: 2.10

gtk_print_settings_set_page_ranges ()

void
gtk_print_settings_set_page_ranges (GtkPrintSettings *settings,
                                    GtkPageRange *page_ranges,
                                    gint num_ranges);

Устанавливает значение GTK_PRINT_SETTINGS_PAGE_RANGES.

Параметры

settings	a GtkPrintSettings
page_ranges	массив GtkPageRanges.	[array length=num_ranges]
num_ranges	длина массива `page_ranges`

С версии: 2.10

gtk_print_settings_get_page_set ()

GtkPageSet
gtk_print_settings_get_page_set (GtkPrintSettings *settings);

Получает значение GTK_PRINT_SETTINGS_PAGE_SET.

Параметры

settings

a GtkPrintSettings

Возвращает

набор страниц для печати

С версии: 2.10

gtk_print_settings_set_page_set ()

void
gtk_print_settings_set_page_set (GtkPrintSettings *settings,
                                 GtkPageSet page_set);

Устанавливает значение GTK_PRINT_SETTINGS_PAGE_SET.

Параметры

settings	a GtkPrintSettings
page_set	значение GtkPageSet

С версии: 2.10

gtk_print_settings_get_default_source ()

const gchar *
gtk_print_settings_get_default_source (GtkPrintSettings *settings);

Получает значение GTK_PRINT_SETTINGS_DEFAULT_SOURCE.

Параметры

settings

объект GtkPrintSettings

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

значение по умолчанию

С: 2.10

gtk_print_settings_set_default_source ()

void
gtk_print_settings_set_default_source (GtkPrintSettings *settings,
                                       const gchar *default_source);

Устанавливает значение GTK_PRINT_SETTINGS_DEFAULT_SOURCE.

Параметры

settings	объект GtkPrintSettings
default_source	значение по умолчанию

С: 2.10

gtk_print_settings_get_media_type ()

const gchar *
gtk_print_settings_get_media_type (GtkPrintSettings *settings);

Получает значение GTK_PRINT_SETTINGS_MEDIA_TYPE.

Набор типов носителей определён в PWG 5101.1-2002 PWG.

Параметры

settings

объект GtkPrintSettings

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

тип носителя

С: 2.10

gtk_print_settings_set_media_type ()

void
gtk_print_settings_set_media_type (GtkPrintSettings *settings,
                                   const gchar *media_type);

Устанавливает значение GTK_PRINT_SETTINGS_MEDIA_TYPE.

Набор типов носителей определён в PWG 5101.1-2002 PWG.

Параметры

settings	объект GtkPrintSettings
media_type	тип носителя

С: 2.10

gtk_print_settings_get_dither ()

const gchar *
gtk_print_settings_get_dither (GtkPrintSettings *settings);

Получает значение GTK_PRINT_SETTINGS_DITHER.

Параметры

settings

объект GtkPrintSettings

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

используемое размытие

С: 2.10

gtk_print_settings_set_dither ()

void
gtk_print_settings_set_dither (GtkPrintSettings *settings,
                               const gchar *dither);

Устанавливает значение GTK_PRINT_SETTINGS_DITHER.

Параметры

settings	объект GtkPrintSettings
dither	используемое размытие

С: 2.10

gtk_print_settings_get_finishings ()

const gchar *
gtk_print_settings_get_finishings (GtkPrintSettings *settings);

Получает значение GTK_PRINT_SETTINGS_FINISHINGS.

Параметры

settings

объект GtkPrintSettings

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

оформления

С: 2.10

gtk_print_settings_set_finishings ()

void
gtk_print_settings_set_finishings (GtkPrintSettings *settings,
                                   const gchar *finishings);

Устанавливает значение GTK_PRINT_SETTINGS_FINISHINGS.

Параметры

settings	объект GtkPrintSettings
finishings	оформления

С: 2.10

gtk_print_settings_get_output_bin ()

const gchar *
gtk_print_settings_get_output_bin (GtkPrintSettings *settings);

Получает значение GTK_PRINT_SETTINGS_OUTPUT_BIN.

Параметры

settings

объект GtkPrintSettings

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

отсек вывода

С: 2.10

gtk_print_settings_set_output_bin ()

void
gtk_print_settings_set_output_bin (GtkPrintSettings *settings,
                                   const gchar *output_bin);

Устанавливает значение GTK_PRINT_SETTINGS_OUTPUT_BIN.

Параметры

settings	объект GtkPrintSettings
output_bin	отсек вывода

С: 2.10

gtk_print_settings_new_from_file ()

GtkPrintSettings *
gtk_print_settings_new_from_file (const gchar *file_name,
                                  GError **error);

Считывает параметры печати из file_name. Возвращает новый объект GtkPrintSettings с восстановленными параметрами или NULL в случае ошибки. Если файл не загрузился, ошибка устанавливается либо в GFileError, либо в GKeyFileError. См. gtk_print_settings_to_file().

Параметры

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

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

восстановленные GtkPrintSettings

С: 2.12

gtk_print_settings_new_from_key_file ()

GtkPrintSettings *
gtk_print_settings_new_from_key_file (GKeyFile *key_file,
                                      const gchar *group_name,
                                      GError **error);

Считывает параметры печати из группы group_name в key_file. Возвращает новый объект GtkPrintSettings с восстановленными параметрами или NULL, если произошла ошибка. Если файл не удалось загрузить, ошибка устанавливается либо в GFileError, либо в GKeyFileError.

Параметры

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

Возвращает

восстановленный GtkPrintSettings

С: 2.12

gtk_print_settings_load_file ()

gboolean
gtk_print_settings_load_file (GtkPrintSettings *settings,
                              const gchar *file_name,
                              GError **error);

Считывает параметры печати из file_name. Если файл не удалось загрузить, ошибка устанавливается либо в GFileError, либо в GKeyFileError. См. gtk_print_settings_to_file().

Параметры

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

Возвращает

TRUE при успехе

С: 2.14

gtk_print_settings_load_key_file ()

gboolean
gtk_print_settings_load_key_file (GtkPrintSettings *settings,
                                  GKeyFile *key_file,
                                  const gchar *group_name,
                                  GError **error);

Считывает параметры печати из группы group_name в key_file. Если файл не удалось загрузить, ошибка устанавливается либо в GFileError, либо в GKeyFileError.

Параметры

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

Возвращает

TRUE при успехе

С: 2.14

gtk_print_settings_to_file ()

gboolean
gtk_print_settings_to_file (GtkPrintSettings *settings,
                            const gchar *file_name,
                            GError **error);

Сохраняет параметры печати из settings в file_name. Если файл не удалось загрузить, ошибка устанавливается либо в GFileError, либо в GKeyFileError.

Параметры

settings	GtkPrintSettings
file_name	файл для сохранения.	[type filename]
error	место для записи ошибок, или `NULL`.	[allow-none]

Возвращает

TRUE при успехе

С: 2.12

gtk_print_settings_to_key_file ()

void
gtk_print_settings_to_key_file (GtkPrintSettings *settings,
                                GKeyFile *key_file,
                                const gchar *group_name);

Добавляет параметры печати из settings в key_file.

Параметры

settings	GtkPrintSettings
key_file	GKeyFile для сохранения параметров печати
group_name	группа для добавления настроек в `key_file`, или `NULL` для использования значения по умолчанию «Print Settings»

С: 2.12

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

GtkPrintSettings

typedef struct _GtkPrintSettings GtkPrintSettings;

GTK_PRINT_SETTINGS_PRINTER

#define GTK_PRINT_SETTINGS_PRINTER          "printer"

перечисление GtkPageOrientation

См. также gtk_print_settings_set_orientation().

Элементы

GTK_PAGE_ORIENTATION_PORTRAIT	Ориентация книжная.
GTK_PAGE_ORIENTATION_LANDSCAPE	Ориентация альбомная.
GTK_PAGE_ORIENTATION_REVERSE_PORTRAIT	Ориентация книжная (обратная).
GTK_PAGE_ORIENTATION_REVERSE_LANDSCAPE	Ориентация альбомная (обратная).

GTK_PRINT_SETTINGS_ORIENTATION

#define GTK_PRINT_SETTINGS_ORIENTATION      "orientation"

GTK_PRINT_SETTINGS_PAPER_FORMAT

#define GTK_PRINT_SETTINGS_PAPER_FORMAT     "paper-format"

GTK_PRINT_SETTINGS_PAPER_WIDTH

#define GTK_PRINT_SETTINGS_PAPER_WIDTH      "paper-width"

GTK_PRINT_SETTINGS_PAPER_HEIGHT

#define GTK_PRINT_SETTINGS_PAPER_HEIGHT     "paper-height"

GTK_PRINT_SETTINGS_USE_COLOR

#define GTK_PRINT_SETTINGS_USE_COLOR        "use-color"

GTK_PRINT_SETTINGS_COLLATE

#define GTK_PRINT_SETTINGS_COLLATE          "collate"

GTK_PRINT_SETTINGS_REVERSE

#define GTK_PRINT_SETTINGS_REVERSE          "reverse"

перечисление GtkPrintDuplex

См. также gtk_print_settings_set_duplex().

Элементы

GTK_PRINT_DUPLEX_SIMPLEX	Без дуплекса.
GTK_PRINT_DUPLEX_HORIZONTAL	Горизонтальный дуплекс.
GTK_PRINT_DUPLEX_VERTICAL	Вертикальный дуплекс.

GTK_PRINT_SETTINGS_DUPLEX

#define GTK_PRINT_SETTINGS_DUPLEX           "duplex"

перечисление GtkPrintQuality

См. также gtk_print_settings_set_quality().

Элементы

GTK_PRINT_QUALITY_LOW	Низкое качество.
GTK_PRINT_QUALITY_NORMAL	Нормальное качество.
GTK_PRINT_QUALITY_HIGH	Высокое качество.
GTK_PRINT_QUALITY_DRAFT	Эскизное качество.

GTK_PRINT_SETTINGS_QUALITY

#define GTK_PRINT_SETTINGS_QUALITY          "quality"

GTK_PRINT_SETTINGS_N_COPIES

#define GTK_PRINT_SETTINGS_N_COPIES         "n-copies"

GTK_PRINT_SETTINGS_NUMBER_UP

#define GTK_PRINT_SETTINGS_NUMBER_UP        "number-up"

перечисление GtkNumberUpLayout

Используется для определения расположения страниц на листе при печати нескольких страниц на листе.

Элементы

GTK_PRINT_SETTINGS_NUMBER_UP_LAYOUT

#define GTK_PRINT_SETTINGS_NUMBER_UP_LAYOUT "number-up-layout"

GTK_PRINT_SETTINGS_RESOLUTION

#define GTK_PRINT_SETTINGS_RESOLUTION       "resolution"

GTK_PRINT_SETTINGS_RESOLUTION_X

#define GTK_PRINT_SETTINGS_RESOLUTION_X     "resolution-x"

GTK_PRINT_SETTINGS_RESOLUTION_Y

#define GTK_PRINT_SETTINGS_RESOLUTION_Y     "resolution-y"

GTK_PRINT_SETTINGS_PRINTER_LPI

#define GTK_PRINT_SETTINGS_PRINTER_LPI      "printer-lpi"

GTK_PRINT_SETTINGS_SCALE

#define GTK_PRINT_SETTINGS_SCALE            "scale"

перечисление GtkPrintPages

См. также gtk_print_job_set_pages()

Элементы

GTK_PRINT_PAGES_ALL	Все страницы.
GTK_PRINT_PAGES_CURRENT	Текущая страница.
GTK_PRINT_PAGES_RANGES	Диапазон страниц.
GTK_PRINT_PAGES_SELECTION	Выбранные страницы.

GTK_PRINT_SETTINGS_PRINT_PAGES

#define GTK_PRINT_SETTINGS_PRINT_PAGES      "print-pages"

структура GtkPageRange

struct GtkPageRange {
  gint start;
  gint end;
};

См. также gtk_print_settings_set_page_ranges().

Элементы

gint `start`;	начало диапазона страниц.
gint `end`;	конец диапазона страниц.

GTK_PRINT_SETTINGS_PAGE_RANGES

#define GTK_PRINT_SETTINGS_PAGE_RANGES      "page-ranges"

Перечисление GtkPageSet

См. также gtk_print_job_set_page_set().

Элементы

GTK_PAGE_SET_ALL	Все страницы.
GTK_PAGE_SET_EVEN	Четные страницы.
GTK_PAGE_SET_ODD	Нечетные страницы.

GTK_PRINT_SETTINGS_PAGE_SET

#define GTK_PRINT_SETTINGS_PAGE_SET         "page-set"

GTK_PRINT_SETTINGS_DEFAULT_SOURCE

#define GTK_PRINT_SETTINGS_DEFAULT_SOURCE   "default-source"

GTK_PRINT_SETTINGS_MEDIA_TYPE

#define GTK_PRINT_SETTINGS_MEDIA_TYPE       "media-type"

GTK_PRINT_SETTINGS_DITHER

#define GTK_PRINT_SETTINGS_DITHER           "dither"

GTK_PRINT_SETTINGS_FINISHINGS

#define GTK_PRINT_SETTINGS_FINISHINGS       "finishings"

GTK_PRINT_SETTINGS_OUTPUT_BIN

#define GTK_PRINT_SETTINGS_OUTPUT_BIN       "output-bin"

GTK_PRINT_SETTINGS_OUTPUT_DIR

#define GTK_PRINT_SETTINGS_OUTPUT_DIR       "output-dir"

Ключ, используемый принтером «Печать в файл» для хранения каталога, в который должен быть записан вывод.

Since: 3.6

GTK_PRINT_SETTINGS_OUTPUT_BASENAME

#define GTK_PRINT_SETTINGS_OUTPUT_BASENAME  "output-basename"

Ключ, используемый принтером «Печать в файл» для хранения имени файла вывода без пути к каталогу и расширения файла.

Since: 3.6

GTK_PRINT_SETTINGS_OUTPUT_FILE_FORMAT

#define GTK_PRINT_SETTINGS_OUTPUT_FILE_FORMAT  "output-file-format"

Ключ, используемый принтером «Печать в файл» для хранения формата вывода. Поддерживаемые значения: «PS» и «PDF».

GTK_PRINT_SETTINGS_OUTPUT_URI

#define GTK_PRINT_SETTINGS_OUTPUT_URI          "output-uri"

Ключ, используемый принтером «Печать в файл» для хранения URI, в который должен быть записан вывод. Сам GTK+ поддерживает только URI «file://».

GTK_PRINT_SETTINGS_WIN32_DRIVER_EXTRA

#define GTK_PRINT_SETTINGS_WIN32_DRIVER_EXTRA   "win32-driver-extra"

GTK_PRINT_SETTINGS_WIN32_DRIVER_VERSION

#define GTK_PRINT_SETTINGS_WIN32_DRIVER_VERSION "win32-driver-version"

© 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/GtkPrintSettings.html