GtkPrintOperation

gtk_print_operation_new ()

GtkPrintOperation *
gtk_print_operation_new (void);

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

С: 2.10

gtk_print_operation_set_allow_async ()

void
gtk_print_operation_set_allow_async (GtkPrintOperation *op,
                                     gboolean allow_async);

Устанавливает, может ли gtk_print_operation_run() возвращаться до завершения операции печати. Обратите внимание, что некоторые платформы могут не поддерживать асинхронную работу.

С: 2.10

gtk_print_operation_get_error ()

void
gtk_print_operation_get_error (GtkPrintOperation *op,
                               GError **error);

Вызовите эту функцию, когда результат операции печати — GTK_PRINT_OPERATION_RESULT_ERROR, либо как возвращаемое значение gtk_print_operation_run(), либо в обработчике сигнала “done”. Возвращённое значение GError содержит более подробную информацию об ошибке.

С: 2.10

gtk_print_operation_set_default_page_setup ()

void
gtk_print_operation_set_default_page_setup
                               (GtkPrintOperation *op,
                                GtkPageSetup *default_page_setup);

Делает default_page_setup значением по умолчанию для настройки страницы для op .

Эта настройка страницы будет использоваться gtk_print_operation_run(), но может быть переопределена для каждой страницы подключением к сигналу “request-page-setup”.

С: 2.10

gtk_print_operation_get_default_page_setup ()

GtkPageSetup *
gtk_print_operation_get_default_page_setup
                               (GtkPrintOperation *op);

Возвращает настройки страницы по умолчанию, см. gtk_print_operation_set_default_page_setup().

С: 2.10

gtk_print_operation_set_print_settings ()

void
gtk_print_operation_set_print_settings
                               (GtkPrintOperation *op,
                                GtkPrintSettings *print_settings);

Устанавливает параметры печати для op . Обычно используется для восстановления настроек печати из предыдущей операции печати, см. gtk_print_operation_run().

С: 2.10

gtk_print_operation_get_print_settings ()

GtkPrintSettings *
gtk_print_operation_get_print_settings
                               (GtkPrintOperation *op);

Возвращает текущие настройки печати.

Обратите внимание, что возвращаемое значение — NULL, пока не были вызваны gtk_print_operation_set_print_settings() или gtk_print_operation_run().

С: 2.10

gtk_print_operation_set_job-name ()

void
gtk_print_operation_set_job_name (GtkPrintOperation *op,
                                  const gchar *job_name);

Устанавливает имя задания печати. Имя используется для идентификации задания (например, в приложениях мониторинга, таких как eggcups).

Если имя задания не задано, GTK+ выбирает имя по умолчанию, нумеруя последовательные задания печати.

С: 2.10

gtk_print_operation_set_n_pages ()

void
gtk_print_operation_set_n_pages (GtkPrintOperation *op,
                                 gint n_pages);

Устанавливает количество страниц в документе.

Это значение должно быть установлено как положительное число до начала рендеринга. Оно может быть установлено в обработчике сигнала “begin-print”.

Обратите внимание, что номера страниц, передаваемые сигналам “request-page-setup” и “draw-page”, нумеруются с нуля, т. е. если пользователь выбрал печать всех страниц, последний сигнал ::draw-page будет для страницы n_pages - 1.

С: 2.10

gtk_print_operation_get_n_pages_to_print ()

gint
gtk_print_operation_get_n_pages_to_print
                               (GtkPrintOperation *op);

Возвращает количество страниц, которые будут напечатаны.

Обратите внимание, что это значение устанавливается во время подготовки печати (GTK_PRINT_STATUS_PREPARING), поэтому эту функцию не следует вызывать до этапа генерации данных (GTK_PRINT_STATUS_GENERATING_DATA). Вы можете подключиться к сигналу “status-changed” и вызвать gtk_print_operation_get_n_pages_to_print(), когда состояние печати равно GTK_PRINT_STATUS_GENERATING_DATA. Обычно это используется для отслеживания прогресса операции печати.

С: 2.18

gtk_print_operation_set_current_page ()

void
gtk_print_operation_set_current_page (GtkPrintOperation *op,
                                      gint current_page);

Устанавливает текущую страницу.

Если это вызывается до gtk_print_operation_run(), пользователь сможет выбрать печать только текущей страницы.

Обратите внимание, что это имеет смысл только для предварительно разметенных документов.

С: 2.10

gtk_print_operation_set_use_full_page ()

void
gtk_print_operation_set_use_full_page (GtkPrintOperation *op,
                                       gboolean full_page);

Если full_page равно TRUE, преобразование для контекста cairo, полученного из GtkPrintContext, устанавливает начало в верхнем левом углу страницы (что может не быть верхним левым углом листа, в зависимости от ориентации страницы и количества страниц на листе). В противном случае начало находится в верхнем левом углу области изображения (т. е. внутри полей).

С: 2.10

gtk_print_operation_set_unit ()

void
gtk_print_operation_set_unit (GtkPrintOperation *op,
                              GtkUnit unit);

Настраивает преобразование для контекста cairo, полученного из GtkPrintContext таким образом, что расстояния измеряются в единицах unit.

С: 2.10

gtk_print_operation_set_export_filename ()

void
gtk_print_operation_set_export_filename
                               (GtkPrintOperation *op,
                                const gchar *filename);

Настраивает GtkPrintOperation на создание файла вместо отображения диалога печати. Предполагаемое использование этой функции — для реализации действий «Экспорт в PDF». В настоящее время поддерживается только формат PDF.

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

С: 2.10

gtk_print_operation_set_show_progress ()

void
gtk_print_operation_set_show_progress (GtkPrintOperation *op,
                                       gboolean show_progress);

Если show_progress равно TRUE, операция печати отобразит диалог хода выполнения во время операции печати.

С: 2.10

gtk_print_operation_set_track_print_status ()

void
gtk_print_operation_set_track_print_status
                               (GtkPrintOperation *op,
                                gboolean track_status);

Если track_status равно TRUE, операция печати будет пытаться продолжать сообщать о состоянии задания печати в очередях принтера и на самом принтере. Это позволит вашему приложению показывать такие проблемы, как «бумага закончилась», и когда задание печати фактически достигнет принтера.

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

С: 2.10

gtk_print_operation_set_custom_tab_label ()

void
gtk_print_operation_set_custom_tab_label
                               (GtkPrintOperation *op,
                                const gchar *label);

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

С: 2.10

gtk_print_operation_run ()

GtkPrintOperationResult
gtk_print_operation_run (GtkPrintOperation *op,
                         GtkPrintOperationAction action,
                         GtkWindow *parent,
                         GError **error);

Запускает операцию печати, сначала позволяя пользователю изменить настройки печати в диалоговом окне печати, а затем напечатать документ.

Обычно эта функция не возвращает результат, пока не завершится отрисовка всех страниц. Вы можете подключиться к сигналу “status-changed” на op, чтобы получить некоторую информацию о ходе операции печати. Кроме того, она может использовать рекурсивный цикл обработки событий для отображения диалогового окна печати.

Если вы вызываете gtk_print_operation_set_allow_async() или устанавливаете свойство “allow-async”, операция будет выполняться асинхронно, если это поддерживается платформой. Сигнал “done” будет выпущен с результатом операции, когда она завершится (т. е. когда диалоговое окно отменено или печать выполнена успешно или неудачно).

Обратите внимание, что gtk_print_operation_run() может быть вызван только один раз для заданного объекта GtkPrintOperation.

С: 2.10

gtk_print_operation_cancel ()

void
gtk_print_operation_cancel (GtkPrintOperation *op);

Отменяет выполняемую операцию печати. Эту функцию можно вызвать из обработчика сигнала “begin-print”, “paginate” или “draw-page”, чтобы остановить текущую операцию печати.

С: 2.10

gtk_print_operation_draw_page_finish ()

void
gtk_print_operation_draw_page_finish (GtkPrintOperation *op);

Сигнализирует о завершении отрисовки конкретной страницы.

Вызывается после завершения отрисовки страницы (например, отрисовка в другом потоке). Если была вызвана функция gtk_print_operation_set_defer_drawing(), то эта функция должна быть вызвана приложением. В противном случае она вызывается самой библиотекой.

С: 2.16

gtk_print_operation_set_defer_drawing ()

void
gtk_print_operation_set_defer_drawing (GtkPrintOperation *op);

Устанавливает GtkPrintOperation для ожидания вызова gtk_print_operation_draw_page_finish() из приложения. Может использоваться для отрисовки страницы в другом потоке.

Эта функция должна быть вызвана в обработчике сигнала «draw-page».

С: 2.16

gtk_print_operation_get_status ()

GtkPrintStatus
gtk_print_operation_get_status (GtkPrintOperation *op);

Возвращает состояние операции печати. Также см. gtk_print_operation_get_status_string().

С: 2.10

gtk_print_operation_get_status_string ()

const gchar *
gtk_print_operation_get_status_string (GtkPrintOperation *op);

Возвращает строковое представление состояния операции печати. Строка переведена и подходит для отображения статуса печати, например, в GtkStatusbar.

Используйте gtk_print_operation_get_status() для получения значения статуса, подходящего для программирования.

С: 2.10

gtk_print_operation_is_finished ()

gboolean
gtk_print_operation_is_finished (GtkPrintOperation *op);

Удобная функция для определения завершения операции печати, как успешно (GTK_PRINT_STATUS_FINISHED), так и безуспешно (GTK_PRINT_STATUS_FINISHED_ABORTED).

Примечание: при включении отслеживания статуса печати операция печати может находиться в состоянии, отличном от завершенного, даже после вызова done, поскольку состояние операции тогда отслеживает состояние задания печати на принтере.

С: 2.10

gtk_print_operation_set_support_selection ()

void
gtk_print_operation_set_support_selection
                               (GtkPrintOperation *op,
                                gboolean support_selection);

Устанавливает, поддерживает ли GtkPrintOperation выбор.

С: 2.18

gtk_print_operation_get_support_selection ()

gboolean
gtk_print_operation_get_support_selection
                               (GtkPrintOperation *op);

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

С: 2.18

gtk_print_operation_set_has-selection ()

void
gtk_print_operation_set_has_selection (GtkPrintOperation *op,
                                       gboolean has_selection);

Устанавливает, есть ли выделение для печати.

Приложение должно установить количество страниц, на которые будет нарисовано выделение, с помощью gtk_print_operation_set_n_pages() в обработчике сигнала «begin-print».

С: 2.18

gtk_print_operation_get_has-selection ()

gboolean
gtk_print_operation_get_has_selection (GtkPrintOperation *op);

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

С: 2.18

gtk_print_operation_set_embed-page-setup ()

void
gtk_print_operation_set_embed_page_setup
                               (GtkPrintOperation *op,
                                gboolean embed);

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

С: 2.18

gtk_print_operation_get-embed-page-setup ()

gboolean
gtk_print_operation_get_embed_page_setup
                               (GtkPrintOperation *op);

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

С: 2.18

gtk_print_run-page-setup-dialog ()

GtkPageSetup *
gtk_print_run_page_setup_dialog (GtkWindow *parent,
                                 GtkPageSetup *page_setup,
                                 GtkPrintSettings *settings);

Запускает диалог настроек страницы, позволяющий пользователю изменить значения из page_setup . Если пользователь отменяет диалог, возвращаемый GtkPageSetup идентичен переданному page_setup, в противном случае он содержит внесённые изменения в диалоге.

Обратите внимание, что эта функция может использовать рекурсивный цикл главного потока для отображения диалога настроек страницы. Смотрите gtk_print_run_page_setup_dialog_async(), если это проблема.

С: 2.10

GtkPageSetupDoneFunc ()

void
(*GtkPageSetupDoneFunc) (GtkPageSetup *page_setup,
                         gpointer data);

Тип функции, передаваемой в gtk_print_run_page_setup_dialog_async().

Эта функция вызывается при закрытии диалога настроек страницы, а также служит уведомлением об уничтожении для data .

gtk_print_run-page-setup-dialog_async ()

void
gtk_print_run_page_setup_dialog_async (GtkWindow *parent,
                                       GtkPageSetup *page_setup,
                                       GtkPrintSettings *settings,
                                       GtkPageSetupDoneFunc done_cb,
                                       gpointer data);

Запускает диалог настроек страницы, позволяющий пользователю изменить значения из page_setup .

В отличие от gtk_print_run_page_setup_dialog(), эта функция возвращается после отображения диалога настроек страницы на платформах, которые это поддерживают, и вызывает done_cb из обработчика сигнала ::response диалога.

С: 2.10

gtk_print_operation_preview_end_preview ()

void
gtk_print_operation_preview_end_preview
                               (GtkPrintOperationPreview *preview);

Завершает предварительный просмотр.

Эта функция должна быть вызвана для завершения пользовательского предварительного просмотра печати.

Since: 2.10

gtk_print_operation_preview_is_selected ()

gboolean
gtk_print_operation_preview_is_selected
                               (GtkPrintOperationPreview *preview,
                                gint page_nr);

Возвращает, включена ли данная страница в набор страниц, выбранных для печати.

Since: 2.10

gtk_print_operation_preview_render_page ()

void
gtk_print_operation_preview_render_page
                               (GtkPrintOperationPreview *preview,
                                gint page_nr);

Отображает страницу в предварительном просмотре, используя контекст печати, переданный обработчику “preview” вместе с preview.

Пользовательский предварительный просмотр печати должен использовать эту функцию в своем обработчике ::expose для отображения текущей выбранной страницы.

Обратите внимание, что для этой функции требуется соответствующий контекст cairo, связанный с контекстом печати.

Since: 2.10

Сигнал “begin-print”

void
user_function (GtkPrintOperation *operation,
               GtkPrintContext   *context,
               gpointer           user_data)

Издаётся после того, как пользователь закончил изменение параметров печати в диалоге, перед началом фактического рендеринга.

Типичное применение сигнала ::begin-print — использование параметров из GtkPrintContext для соответствующей постраничной обработки документа, а затем установка количества страниц с помощью gtk_print_operation_set_n_pages().

Флаги: Run Last

С: 2.10

Сигнал “create-custom-widget”

GObject*
user_function (GtkPrintOperation *operation,
               gpointer           user_data)

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

Диалог печати владеет возвращённым виджетом, и его жизненный цикл не контролируется приложением. Однако гарантируется, что виджет сохранится до тех пор, пока не будет издан сигнал «custom-widget-apply» для операции. Затем вы можете считать любую необходимую информацию из виджетов.

Флаги: Run Last

С: 2.10

Сигнал “custom-widget-apply”

void
user_function (GtkPrintOperation *operation,
               GtkWidget         *widget,
               gpointer           user_data)

Издаётся непосредственно перед «begin-print», если вы добавили пользовательский виджет в обработчик «create-custom-widget». При получении этого сигнала вы должны прочитать информацию из пользовательских виджетов, так как виджеты не гарантируются к существованию впоследствии.

Флаги: Run Last

С: 2.10

Сигнал “done”

void
user_function (GtkPrintOperation      *operation,
               GtkPrintOperationResult result,
               gpointer                user_data)

Издаётся, когда операция печати завершила все необходимые действия.

result предоставляет информацию о произошедшем во время выполнения. Если result равен GTK_PRINT_OPERATION_RESULT_ERROR, можно вызвать gtk_print_operation_get_error() для получения дополнительной информации.

Если отслеживание состояния печати было включено, gtk_print_operation_is_finished() может всё ещё возвращать FALSE после того, как был издан сигнал «done».

Флаги: Run Last

С: 2.10

Сигнал “draw-page”

void
user_function (GtkPrintOperation *operation,
               GtkPrintContext   *context,
               gint               page_nr,
               gpointer           user_data)

Издаётся для каждой печатаемой страницы. Обработчик сигнала должен отрисовать страницу page_nr на контексте Cairo, полученном от context с помощью gtk_print_context_get_cairo_context().

staticGtkPrintSettings*settings = NULL;

staticvoid
do_print(void)
{
GtkPrintOperation*print;
GtkPrintOperationResult res;

  print =gtk_print_operation_new();

if(settings != NULL)
gtk_print_operation_set_print_settings(print, settings);

g_signal_connect(print,"begin_print",G_CALLBACK(begin_print), NULL);
g_signal_connect(print,"draw_page",G_CALLBACK(draw_page), NULL);

  res =gtk_print_operation_run(print, GTK_PRINT_OPERATION_ACTION_PRINT_DIALOG,
GTK_WINDOW(main_window), NULL);

if(res == GTK_PRINT_OPERATION_RESULT_APPLY)
{
if(settings != NULL)
g_object_unref(settings);
      settings =g_object_ref(gtk_print_operation_get_print_settings(print));
}

g_object_unref(print);
}

Используйте gtk_print_operation_set_use_full_page() и gtk_print_operation_set_unit() перед началом операции печати для настройки преобразования контекста Cairo в соответствии с вашими потребностями.

Флаги: Run Last

С: 2.10

Сигнал “end-print”

void
user_function (GtkPrintOperation *operation,
               GtkPrintContext   *context,
               gpointer           user_data)

Издаётся после отрисовки всех страниц. Обработчик этого сигнала может очистить любые ресурсы, выделенные в обработчике сигнала «begin-print».

Флаги: Run Last

С: 2.10

Сигнал “paginate”

gboolean
user_function (GtkPrintOperation *operation,
               GtkPrintContext   *context,
               gpointer           user_data)

Издаётся после сигнала “begin-print”, но до начала фактического рендеринга. Он продолжает издаваться до тех пор, пока обработчик подключенного сигнала не вернёт TRUE.

Сигнал ::paginate предназначен для разбиения документа на небольшие части при постраничном выводе, чтобы избежать длительного блокирования пользовательского интерфейса. Обработчик сигнала должен обновить количество страниц с помощью gtk_print_operation_set_n_pages() и вернуть TRUE, если документ был полностью разбит на страницы.

Если вам не нужно выполнять постраничный вывод по частям, вы можете сделать это полностью в обработчике ::begin-print и установить количество страниц оттуда.

Флаги: Run Last

С: 2.10

Сигнал “preview”

gboolean
user_function (GtkPrintOperation        *operation,
               GtkPrintOperationPreview *preview,
               GtkPrintContext          *context,
               GtkWindow                *parent,
               gpointer                  user_data)

Издаётся, когда от системного диалога запрашивается предварительный просмотр.

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

Чтобы реализовать пользовательский предварительный просмотр, приложение должно вернуть TRUE из своего обработчика для этого сигнала. Для использования предоставленного context для реализации предварительного просмотра, ему необходимо предоставить подходящий контекст Cairo с помощью gtk_print_context_set_cairo_context().

Реализация пользовательского предварительного просмотра может использовать gtk_print_operation_preview_is_selected() и gtk_print_operation_preview_render_page() для поиска страниц, которые выбраны для печати, и их рендеринга. Предварительный просмотр должен быть завершён вызовом gtk_print_operation_preview_end_preview() (обычно в ответ на щелчок пользователем кнопки закрытия).

Флаги: Run Last

С: 2.10

Сигнал “request-page-setup”

void
user_function (GtkPrintOperation *operation,
               GtkPrintContext   *context,
               gint               page_nr,
               GtkPageSetup      *setup,
               gpointer           user_data)

Издаётся один раз для каждой печатаемой страницы, чтобы дать приложению возможность изменить параметры страницы. Любые изменения, внесённые в setup, будут действительны только для печати этой страницы.

Флаги: Run Last

С: 2.10

Сигнал “status-changed”

void
user_function (GtkPrintOperation *operation,
               gpointer           user_data)

Издаётся между различными фазами операции печати. См. GtkPrintStatus для фаз, которые различаются. Используйте gtk_print_operation_get_status() для определения текущего статуса.

Флаги: Run Last

С: 2.10

Сигнал “update-custom-widget”

void
user_function (GtkPrintOperation *operation,
               GtkWidget         *widget,
               GtkPageSetup      *setup,
               GtkPrintSettings  *settings,
               gpointer           user_data)

Издаётся после изменения выбранного принтера. Фактические параметры страницы и настройки печати передаются пользовательскому виджету, который может обновить себя в соответствии с этим изменением.

Флаги: Run Last

С: 2.18

Сигнал “got-page-size”

void
user_function (GtkPrintOperationPreview *preview,
               GtkPrintContext          *context,
               GtkPageSetup             *page_setup,
               gpointer                  user_data)

Сигнал ::got-page-size генерируется один раз для каждой страницы, которая отображается в предварительном просмотре.

Обработчик этого сигнала должен обновить context в соответствии с page_setup и настроить подходящий контекст cairo, используя gtk_print_context_set_cairo_context().

Флаги: Run Last

Сигнал “ready”

void
user_function (GtkPrintOperationPreview *preview,
               GtkPrintContext          *context,
               gpointer                  user_data)

Сигнал ::ready генерируется один раз на операцию предварительного просмотра, перед отрисовкой первой страницы.

Обработчик этого сигнала может использоваться для задач настройки.

Флаги: Run Last