Spec-Zone.ru › GTK 3.22

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 ()
gint 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 ()

Свойства

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

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

struct GtkPrintUnixDialog
enum GtkPrintCapabilities

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

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

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

GtkPrintUnixDialog реализует AtkImplementorIface и GtkBuildable.

Файлы

#include <gtk/gtkprintunixdialog.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

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

[allow-none]

parent

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

[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

a GtkPrintUnixDialog

page_setup

a GtkPageSetup

С версии: 2.10

gtk_print_unix_dialog_get_page_setup ()

GtkPageSetup *
gtk_print_unix_dialog_get_page_setup (GtkPrintUnixDialog *dialog);

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

Параметры

dialog

a GtkPrintUnixDialog

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

параметры страницы 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

a GtkPrintUnixDialog

current_page

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

С версии: 2.10

gtk_print_unix_dialog_get_current_page ()

gint
gtk_print_unix_dialog_get_current_page
                               (GtkPrintUnixDialog *dialog);

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

Параметры

dialog

a GtkPrintUnixDialog

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

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

С версии: 2.10

gtk_print_unix_dialog_set_settings ()

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

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

Параметры

dialog

a GtkPrintUnixDialog

settings

a GtkPrintSettings, или NULL.

[allow-none]

С версии: 2.10

gtk_print_unix_dialog_get_settings ()

GtkPrintSettings *
gtk_print_unix_dialog_get_settings (GtkPrintUnixDialog *dialog);

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

Параметры

dialog

a GtkPrintUnixDialog

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

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

С версии: 2.10

gtk_print_unix_dialog_get_selected_printer ()

GtkPrinter *
gtk_print_unix_dialog_get_selected_printer
                               (GtkPrintUnixDialog *dialog);

Возвращает выбранный принтер.

Параметры

dialog

a GtkPrintUnixDialog

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

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

[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

a GtkPrintUnixDialog

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

a GtkPrintUnixDialog

support_selection

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

С версии: 2.18

gtk_print_unix_dialog_get_support_selection ()

gboolean
gtk_print_unix_dialog_get_support_selection
                               (GtkPrintUnixDialog *dialog);

Возвращает значение свойства “support-selection”.

Параметры

dialog

a GtkPrintUnixDialog

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

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

С версии: 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

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

С: 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”             gint

Текущая страница в документе.

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

Допустимые значения: >= -1

Значение по умолчанию: -1

Свойство “embed-page-setup”

  “embed-page-setup”         gboolean

Истинно, если сочетания параметров страницы встроены в GtkPrintUnixDialog.

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

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

Свойство “has-selection”

  “has-selection”            gboolean

Наличие выделения в приложении.

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

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

Свойство “manual-capabilities”

  “manual-capabilities”      GtkPrintCapabilities

Возможности, которые приложение может обрабатывать.

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

Свойство “page-setup”

  “page-setup”               GtkPageSetup *

Используемый объект GtkPageSetup.

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

Свойство “print-settings”

  “print-settings”           GtkPrintSettings *

Объект GtkPrintSettings, используемый для инициализации диалога.

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

Свойство “selected-printer”

  “selected-printer”         GtkPrinter *

Выбранный принтер GtkPrinter.

Флаги: Чтение

Свойство “support-selection”

  “support-selection”        gboolean

Поддержка выделения в диалоге.

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

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

См. также

GtkPageSetupUnixDialog, GtkPrinter, GtkPrintJob

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

Spec-Zone.ru

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