Spec-Zone.ru › GTK 4.0

GtkPrintUnixDialog

GtkPrintUnixDialog — Диалоговое окно печати

Функции

GtkWidget * gtk_print_unix_dialog_new ()
void gtk_print_unix_dialog_set_page_setup ()
GtkPageSetup * gtk_print_unix_dialog_get_page_setup ()
void gtk_print_unix_dialog_set_current_page ()
int gtk_print_unix_dialog_get_current_page ()
void gtk_print_unix_dialog_set_settings ()
GtkPrintSettings * gtk_print_unix_dialog_get_settings ()
GtkPrinter * gtk_print_unix_dialog_get_selected_printer ()
void gtk_print_unix_dialog_add_custom_tab ()
void gtk_print_unix_dialog_set_support_selection ()
gboolean gtk_print_unix_dialog_get_support-selection ()
void gtk_print_unix_dialog_set_has-selection ()
gboolean gtk_print_unix_dialog_get-has-selection ()
void gtk_print_unix_dialog_set-embed-page-setup ()
gboolean gtk_print_unix_dialog_get-embed-page-setup ()
gboolean gtk_print_unix_dialog_get_page_setup_set ()
void gtk_print_unix_dialog_set_manual_capabilities ()
GtkPrintCapabilities gtk_print_unix_dialog_get_manual_capabilities ()

Свойства

int current-page Чтение/Запись
gboolean embed-page-setup Чтение/Запись
gboolean has-selection Чтение/Запись
GtkPrintCapabilities manual-capabilities Чтение/Запись
GtkPageSetup * page-setup Чтение/Запись
GtkPrintSettings * print-settings Чтение/Запись
GtkPrinter * selected-printer Чтение
gboolean support-selection Чтение/Запись

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

GtkPrintUnixDialog
перечисление GtkPrintCapabilities

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

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkWindow
                ╰── GtkDialog
                    ╰── GtkPrintUnixDialog

Реализованные интерфейсы

GtkPrintUnixDialog реализует GtkAccessible, GtkBuildable, GtkConstraintTarget, GtkNative, GtkShortcutManager и GtkRoot.

Включаемые файлы

#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: для кнопки «Отмена»

GtkPrintUnixDialog как GtkBuildable

Реализация GtkPrintUnixDialog интерфейса GtkBuildable предоставляет доступ к его notebook внутренним дочерним элементам с именем «notebook».

Пример фрагмента определения пользовательского интерфейса GtkPrintUnixDialog:

<object class="GtkPrintUnixDialog" id="dialog1">
  <child internal-child="notebook">
    <object class="GtkNotebook" id="notebook">
      <child>
        <object type="GtkNotebookPage">
          <property name="tab_expand">False</property>
          <property name="tab_fill">False</property>
          <property name="tab">
            <object class="GtkLabel" id="tablabel">
              <property name="label">Tab label</property>
            </object>
          </property>
          <property name="child">
            <object class="GtkLabel" id="tabcontent">
              <property name="label">Content on notebook tab</property>
            </object>
          </property>
        </object>
      </child>
    </object>
  </child>
</object>

Узлы CSS

GtkPrintUnixDialog имеет один узел CSS с именем window. К нему добавлены классы стилей dialog и print.

Функции

gtk_print_unix_dialog_new ()

GtkWidget *
gtk_print_unix_dialog_new (const char *title,
                           GtkWindow *parent);

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

Параметры

title

Заголовок диалога или NULL.

[allow-none]

parent

Временный родитель диалога или NULL.

[allow-none]

Возвращает

новый GtkPrintUnixDialog

gtk_print_unix_dialog_set_page_setup ()

void
gtk_print_unix_dialog_set_page_setup (GtkPrintUnixDialog *dialog,
                                      GtkPageSetup *page_setup);

Устанавливает параметры страницы для GtkPrintUnixDialog.

Параметры

dialog

объект GtkPrintUnixDialog

page_setup

объект GtkPageSetup

gtk_print_unix_dialog_get_page_setup ()

GtkPageSetup *
gtk_print_unix_dialog_get_page_setup (GtkPrintUnixDialog *dialog);

Получает параметры страницы, используемые диалоговым окном GtkPrintUnixDialog.

Параметры

dialog

объект GtkPrintUnixDialog

Возвращает

параметры страницы объекта dialog .

[transfer none]

gtk_print_unix_dialog_set_current_page ()

void
gtk_print_unix_dialog_set_current_page
                               (GtkPrintUnixDialog *dialog,
                                int current_page);

Устанавливает номер текущей страницы. Если current_page не равен -1, это позволяет выбрать текущую страницу в диапазоне печатаемых страниц.

Параметры

dialog

объект GtkPrintUnixDialog

current_page

номер текущей страницы.

gtk_print_unix_dialog_get_current_page ()

int
gtk_print_unix_dialog_get_current_page
                               (GtkPrintUnixDialog *dialog);

Получает номер текущей страницы диалогового окна GtkPrintUnixDialog.

Параметры

dialog

объект GtkPrintUnixDialog

Возвращает

текущую страницу объекта dialog

gtk_print_unix_dialog_set_settings ()

void
gtk_print_unix_dialog_set_settings (GtkPrintUnixDialog *dialog,
                                    GtkPrintSettings *settings);

Устанавливает параметры печати GtkPrintSettings для GtkPrintUnixDialog. Обычно это используется для восстановления сохранённых параметров печати из предыдущей операции печати перед отображением диалогового окна печати.

Параметры

dialog

объект GtkPrintUnixDialog

settings

объект GtkPrintSettings, или NULL.

[allow-none]

gtk_print_unix_dialog_get_settings ()

GtkPrintSettings *
gtk_print_unix_dialog_get_settings (GtkPrintUnixDialog *dialog);

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

Параметры

dialog

объект GtkPrintUnixDialog

Возвращает

новый объект GtkPrintSettings со значениями из dialog

gtk_print_unix_dialog_get_selected_printer ()

GtkPrinter *
gtk_print_unix_dialog_get_selected_printer
                               (GtkPrintUnixDialog *dialog);

Получает выбранный принтер.

Параметры

dialog

объект GtkPrintUnixDialog

Возвращает

выбранный принтер.

[transfer none]

gtk_print_unix_dialog_add_custom_tab ()

void
gtk_print_unix_dialog_add_custom_tab (GtkPrintUnixDialog *dialog,
                                      GtkWidget *child,
                                      GtkWidget *tab_label);

Добавляет пользовательскую вкладку в диалог печати.

Параметры

dialog

объект GtkPrintUnixDialog

child

виджет, который нужно поместить на вкладку

tab_label

виджет, который нужно использовать в качестве метки вкладки

gtk_print_unix_dialog_set_support_selection ()

void
gtk_print_unix_dialog_set_support_selection
                               (GtkPrintUnixDialog *dialog,
                                gboolean support_selection);

Устанавливает, разрешает ли диалог печати пользователю печатать выделенный фрагмент.

Параметры

dialog

объект GtkPrintUnixDialog

support_selection

TRUE для разрешения печати выделения

gtk_print_unix_dialog_get_support_selection ()

gboolean
gtk_print_unix_dialog_get_support_selection
                               (GtkPrintUnixDialog *dialog);

Получает значение свойства “support-selection”.

Параметры

dialog

объект GtkPrintUnixDialog

Возвращает

разрешает ли приложение печать выделения

gtk_print_unix_dialog_set_has_selection ()

void
gtk_print_unix_dialog_set_has_selection
                               (GtkPrintUnixDialog *dialog,
                                gboolean has_selection);

Устанавливает, существует ли выделение.

Параметры

dialog

объект GtkPrintUnixDialog

has_selection

TRUE указывает, что выделение существует

gtk_print_unix_dialog_get_has_selection ()

gboolean
gtk_print_unix_dialog_get_has_selection
                               (GtkPrintUnixDialog *dialog);

Получает значение свойства “has-selection”.

Параметры

dialog

объект GtkPrintUnixDialog

Возвращает

есть ли выделение

gtk_print_unix_dialog_set_embed_page_setup ()

void
gtk_print_unix_dialog_set_embed_page_setup
                               (GtkPrintUnixDialog *dialog,
                                gboolean embed);

Встраивает поля выбора размера страницы и ориентации в страницу настроек.

Параметры

dialog

объект GtkPrintUnixDialog

embed

встраивать ли выбор настроек страницы

gtk_print_unix_dialog_get_embed_page_setup ()

gboolean
gtk_print_unix_dialog_get_embed_page_setup
                               (GtkPrintUnixDialog *dialog);

Получает значение свойства “embed-page-setup”.

Параметры

dialog

объект GtkPrintUnixDialog

Возвращает

есть ли выделение

gtk_print_unix_dialog_get_page_setup_set ()

gboolean
gtk_print_unix_dialog_get_page_setup_set
                               (GtkPrintUnixDialog *dialog);

Получает настройки страницы, используемые диалоговым окном печати GtkPrintUnixDialog.

Параметры

dialog

объект GtkPrintUnixDialog

Возвращает

были ли настройки страницы заданы пользователем.

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

поддерживаемые приложением возможности печати

gtk_print_unix_dialog_get_manual_capabilities ()

GtkPrintCapabilities
gtk_print_unix_dialog_get_manual_capabilities
                               (GtkPrintUnixDialog *dialog);

Получает значение свойства “manual-capabilities”.

Параметры

dialog

объект GtkPrintUnixDialog

Возвращает

поддерживаемые возможности печати

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

GtkPrintUnixDialog

typedef struct _GtkPrintUnixDialog 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

Диалоговое окно печати предложит печать нескольких страниц на листе.

GTK_PRINT_CAPABILITY_NUMBER_UP_LAYOUT

Диалоговое окно печати позволит переупорядочивать страницы при печати нескольких на листе.

Подробное описание свойств

Свойство “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

Флаги: Чтение / Запись

Значение по умолчанию: ЛОЖЬ

См. также

GtkPageSetupUnixDialog, GtkPrinter, GtkPrintJob

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API