Spec-Zone.ru › GTK 3.20

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

a 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

a 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

a 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

a GtkPrintUnixDialog

Возвращает

наличие выделения

С: 2.18

gtk_print_unix_dialog_get_page_setup_set ()

gboolean
gtk_print_unix_dialog_get_page_setup_set
                               (GtkPrintUnixDialog *dialog);

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

Параметры

dialog

a 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

a GtkPrintUnixDialog

capabilities

возможности печати вашего приложения

С: 2.10

gtk_print_unix_dialog_get_manual_capabilities ()

GtkPrintCapabilities
gtk_print_unix_dialog_get_manual_capabilities
                               (GtkPrintUnixDialog *dialog);

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

Параметры

dialog

a GtkPrintUnixDialog

Возвращает

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

С: 2.18

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

struct GtkPrintUnixDialog

struct GtkPrintUnixDialog;

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

Spec-Zone.ru

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