GtkPrintUnixDialog
GtkPrintUnixDialog — Диалоговое окно печати
Функции
Свойства
| int | текущая-страница | Чтение / Запись |
| gboolean | встраивание-настроек-страницы | Чтение / Запись |
| gboolean | имеет-выделение | Чтение / Запись |
| GtkPrintCapabilities | ручные-возможности | Чтение / Запись |
| GtkPageSetup * | настройки-страницы | Чтение / Запись |
| GtkPrintSettings * | настройки-печати | Чтение / Запись |
| GtkPrinter * | выбранный-принтер | Чтение |
| gboolean | поддержка-выделения | Чтение / Запись |
Типы и значения
| struct | GtkPrintUnixDialog |
| enum | GtkPrintCapabilities |
Иерархия объектов
GObject
╰── GInitiallyUnowned
╰── GtkWidget
╰── GtkContainer
╰── GtkBin
╰── GtkWindow
╰── GtkDialog
╰── GtkPrintUnixDialog
Реализованные интерфейсы
GtkPrintUnixDialog реализует AtkImplementorIface и GtkBuildable.
Включаемые файлы
#include <gtk/gtkunixprint.h>
Описание
GtkPrintUnixDialog реализует диалог печати для платформ, не предоставляющих родного диалога печати, например, Unix. Он может использоваться почти так же, как любой другой диалог GTK+, но с потерей портативности, предлагаемой высокоуровневым API печати.
Для печати с помощью GtkPrintUnixDialog, необходимо использовать gtk_print_unix_dialog_get_selected_printer() для получения объекта GtkPrinter и использовать его для создания объекта GtkPrintJob с помощью gtk_print_job_new().
GtkPrintUnixDialog использует следующие значения ответа:
GTK_RESPONSE_OK: для кнопки «Печать»GTK_RESPONSE_APPLY: для кнопки «Предварительный просмотр»GTK_RESPONSE_CANCEL: для кнопки «Отмена»
Поддержка печати была добавлена в GTK+ 2.10.
GtkPrintUnixDialog как GtkBuildable
Реализация GtkPrintUnixDialog интерфейса GtkBuildable предоставляет доступ к своим внутренним дочерним элементам с именем «notebook».
Пример фрагмента определения пользовательского интерфейса GtkPrintUnixDialog:
<object class="GtkPrintUnixDialog" id="dialog1">
<child internal-child="notebook">
<object class="GtkNotebook" id="notebook">
<child>
<object class="GtkLabel" id="tabcontent">
<property name="label">Content on notebook tab</property>
</object>
</child>
<child type="tab">
<object class="GtkLabel" id="tablabel">
<property name="label">Tab label</property>
</object>
<packing>
<property name="tab_expand">False</property>
<property name="tab_fill">False</property>
</packing>
</child>
</object>
</child>
</object>Узлы CSS
GtkPrintUnixDialog имеет единственный узел CSS с именем printdialog.
Функции
gtk_print_unix_dialog_new ()
GtkWidget * gtk_print_unix_dialog_new (const gchar *title,GtkWindow *parent);
Создаёт новый GtkPrintUnixDialog.
Параметры
title | Заголовок диалога или | [allow-none] |
parent | Родительский диалог или | [allow-none] |
Возвращает
новый GtkPrintUnixDialog
С версии: 2.10
gtk_print_unix_dialog_set_page_setup ()
void gtk_print_unix_dialog_set_page_setup (GtkPrintUnixDialog *dialog,GtkPageSetup *page_setup);
Устанавливает параметры страницы для GtkPrintUnixDialog.
Параметры
dialog | ||
page_setup |
С версии: 2.10
gtk_print_unix_dialog_get_page_setup ()
GtkPageSetup *
gtk_print_unix_dialog_get_page_setup (GtkPrintUnixDialog *dialog); Получает параметры страницы, используемые GtkPrintUnixDialog.
Параметры
dialog |
Возвращает
параметры страницы dialog .
[transfer none]
С версии: 2.10
gtk_print_unix_dialog_set_current_page ()
void gtk_print_unix_dialog_set_current_page (GtkPrintUnixDialog *dialog,gint current_page);
Устанавливает номер текущей страницы. Если current_page не равно -1, это позволяет выбрать текущую страницу для диапазона печатаемых страниц.
Параметры
dialog | ||
current_page | номер текущей страницы. |
С версии: 2.10
gtk_print_unix_dialog_get_current_page ()
gint
gtk_print_unix_dialog_get_current_page
(GtkPrintUnixDialog *dialog); Получает номер текущей страницы из GtkPrintUnixDialog.
Параметры
dialog |
Возвращает
номер текущей страницы dialog
С версии: 2.10
gtk_print_unix_dialog_set_settings ()
void gtk_print_unix_dialog_set_settings (GtkPrintUnixDialog *dialog,GtkPrintSettings *settings);
Устанавливает GtkPrintSettings для GtkPrintUnixDialog. Обычно используется для восстановления сохранённых параметров печати из предыдущей операции печати перед отображением диалога печати.
Параметры
dialog | ||
settings | a GtkPrintSettings, или | [allow-none] |
С версии: 2.10
gtk_print_unix_dialog_get_settings ()
GtkPrintSettings *
gtk_print_unix_dialog_get_settings (GtkPrintUnixDialog *dialog); Получает новый объект GtkPrintSettings, представляющий текущие значения в диалоге печати. Обратите внимание, что это создаёт новый объект, и вам нужно его уничтожить, если вы не хотите его хранить.
Параметры
dialog |
Возвращает
новый объект GtkPrintSettings со значениями из dialog
С версии: 2.10
gtk_print_unix_dialog_get_selected_printer ()
GtkPrinter *
gtk_print_unix_dialog_get_selected_printer
(GtkPrintUnixDialog *dialog); Возвращает выбранный принтер.
Параметры
dialog |
Возвращает
выбранный принтер.
[transfer none]
С версии: 2.10
gtk_print_unix_dialog_add_custom_tab ()
void gtk_print_unix_dialog_add_custom_tab (GtkPrintUnixDialog *dialog,GtkWidget *child,GtkWidget *tab_label);
Добавляет пользовательскую вкладку в диалог печати.
Параметры
dialog | ||
child | виджет, который нужно поместить на пользовательскую вкладку | |
tab_label | виджет, используемый в качестве метки вкладки |
С версии: 2.10
gtk_print_unix_dialog_set_support_selection ()
void gtk_print_unix_dialog_set_support_selection (GtkPrintUnixDialog *dialog,gboolean support_selection);
Устанавливает возможность диалога печати на печать выделения.
Параметры
dialog | ||
support_selection |
|
С версии: 2.18
gtk_print_unix_dialog_get_support_selection ()
gboolean
gtk_print_unix_dialog_get_support_selection
(GtkPrintUnixDialog *dialog); Получает значение свойства “support-selection”.
Параметры
dialog |
Возвращает
является ли печать выделения поддерживаемой приложением
С версии: 2.18
gtk_print_unix_dialog_set_has-selection ()
void gtk_print_unix_dialog_set_has_selection (GtkPrintUnixDialog *dialog,gboolean has_selection);
Устанавливает, существует ли выделение.
Параметры
dialog | объект GtkPrintUnixDialog | |
has_selection |
|
С версии: 2.18
gtk_print_unix_dialog_get_has-selection ()
gboolean
gtk_print_unix_dialog_get_has_selection
(GtkPrintUnixDialog *dialog); Получает значение свойства “has-selection”.
Параметры
dialog | объект GtkPrintUnixDialog |
Возвращает
существует ли выделение
С версии: 2.18
gtk_print_unix_dialog_set_embed-page-setup ()
void gtk_print_unix_dialog_set_embed_page_setup (GtkPrintUnixDialog *dialog,gboolean embed);
Встраивает поля выбора размера страницы и ориентации в страницу настроек.
Параметры
dialog | объект GtkPrintUnixDialog | |
embed | встраивать выбор параметров страницы |
С версии: 2.18
gtk_print_unix_dialog_get_embed-page-setup ()
gboolean
gtk_print_unix_dialog_get_embed_page_setup
(GtkPrintUnixDialog *dialog); Получает значение свойства “embed-page-setup”.
Параметры
dialog | объект GtkPrintUnixDialog |
Возвращает
существует ли выделение
С версии: 2.18
gtk_print_unix_dialog_get_page-setup-set ()
gboolean
gtk_print_unix_dialog_get_page_setup_set
(GtkPrintUnixDialog *dialog); Получает набор параметров страницы, используемый диалоговым окном печати GtkPrintUnixDialog.
Параметры
dialog | объект GtkPrintUnixDialog |
Возвращает
были ли параметры страницы установлены пользователем.
С версии: 2.18
gtk_print_unix_dialog_set-manual-capabilities ()
void gtk_print_unix_dialog_set_manual_capabilities (GtkPrintUnixDialog *dialog,GtkPrintCapabilities capabilities);
Это позволяет указать возможности печати, поддерживаемые вашим приложением. Например, если вы можете масштабировать вывод, то передайте GTK_PRINT_CAPABILITY_SCALE. Если вы этого не сделаете, диалоговое окно позволит выбрать масштаб только в том случае, если система печати автоматически обрабатывает масштабирование.
Параметры
dialog | объект GtkPrintUnixDialog | |
capabilities | возможности печати вашего приложения |
С версии: 2.10
gtk_print_unix_dialog_get-manual-capabilities ()
GtkPrintCapabilities
gtk_print_unix_dialog_get_manual_capabilities
(GtkPrintUnixDialog *dialog); Получает значение свойства “manual-capabilities”.
Параметры
dialog | объект GtkPrintUnixDialog |
Возвращает
возможности печати
С версии: 2.18
Типы и значения
struct GtkPrintUnixDialog
struct GtkPrintUnixDialog;
перечисление GtkPrintCapabilities
Перечисление для указания, какие функции должно предоставлять диалоговое окно печати. Если ни GTK_PRINT_CAPABILITY_GENERATE_PDF, ни GTK_PRINT_CAPABILITY_GENERATE_PS не указаны, GTK+ предполагает, что все форматы поддерживаются.
Элементы
GTK_PRINT_CAPABILITY_PAGE_SET | Диалоговое окно печати предложит печать чётных/нечётных страниц. | |
GTK_PRINT_CAPABILITY_COPIES | Диалоговое окно печати позволит напечатать несколько копий. | |
GTK_PRINT_CAPABILITY_COLLATE | Диалоговое окно печати позволит сброшировать несколько копий. | |
GTK_PRINT_CAPABILITY_REVERSE | Диалоговое окно печати позволит напечатать страницы в обратном порядке. | |
GTK_PRINT_CAPABILITY_SCALE | Диалоговое окно печати позволит масштабировать вывод. | |
GTK_PRINT_CAPABILITY_GENERATE_PDF | Программа отправит документ на печать в формате PDF. | |
GTK_PRINT_CAPABILITY_GENERATE_PS | Программа отправит документ на печать в формате Postscript. | |
GTK_PRINT_CAPABILITY_PREVIEW | Диалоговое окно печати предложит просмотр. | |
GTK_PRINT_CAPABILITY_NUMBER_UP | Диалоговое окно печати предложит печать нескольких страниц на листе. С версии 2.12. | |
GTK_PRINT_CAPABILITY_NUMBER_UP_LAYOUT | Диалоговое окно печати позволит переупорядочить страницы при печати нескольких страниц на листе. С версии 2.14. |
Подробное описание свойств
Свойство “current-page”
“current-page” int
Текущая страница в документе.
Владелец: GtkPrintUnixDialog
Флаги: Чтение / Запись
Допустимые значения: >= -1
Значение по умолчанию: -1
Свойство “embed-page-setup”
“embed-page-setup” gboolean
Истина, если наборы страниц встроены в GtkPrintUnixDialog.
Владелец: GtkPrintUnixDialog
Флаги: Чтение / Запись
Значение по умолчанию: ЛОЖЬ
Свойство “has-selection”
“has-selection” gboolean
Есть ли выделение в приложении.
Владелец: GtkPrintUnixDialog
Флаги: Чтение / Запись
Значение по умолчанию: ЛОЖЬ
Свойство “manual-capabilities”
“manual-capabilities” GtkPrintCapabilities
Возможности, которые может обрабатывать приложение.
Владелец: GtkPrintUnixDialog
Флаги: Чтение / Запись
Свойство “page-setup”
“page-setup” GtkPageSetup *
Используемый GtkPageSetup.
Владелец: GtkPrintUnixDialog
Флаги: Чтение / Запись
Свойство “print-settings”
“print-settings” GtkPrintSettings *
GtkPrintSettings, используемые для инициализации диалога.
Владелец: GtkPrintUnixDialog
Флаги: Чтение / Запись
Свойство “selected-printer”
“selected-printer” GtkPrinter *
Выбранный GtkPrinter.
Владелец: GtkPrintUnixDialog
Флаги: Чтение
Свойство “support-selection”
“support-selection” gboolean
Поддерживает ли диалог выделение.
Владелец: GtkPrintUnixDialog
Флаги: Чтение / Запись
Значение по умолчанию: ЛОЖЬ
См. также
© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.24/GtkPrintUnixDialog.html
