Spec-Zone.ru › GTK 3.22

GtkPrintJob

GtkPrintJob — Представляет задание печати

Функции

void (*GtkPrintJobCompleteFunc) ()
GtkPrintJob * gtk_print_job_new ()
GtkPrintSettings * gtk_print_job_get_settings ()
GtkPrinter * gtk_print_job_get_printer ()
const gchar * gtk_print_job_get_title ()
GtkPrintStatus gtk_print_job_get_status ()
gboolean gtk_print_job_set_source_file ()
cairo_surface_t * gtk_print_job_get_surface ()
void gtk_print_job_send ()
void gtk_print_job_set_track_print_status ()
gboolean gtk_print_job_get_track_print_status ()
GtkPrintPages gtk_print_job_get_pages ()
void gtk_print_job_set_pages ()
GtkPageRange * gtk_print_job_get_page_ranges ()
void gtk_print_job_set_page_ranges ()
GtkPageSet gtk_print_job_get_page_set ()
void gtk_print_job_set_page_set ()
gint gtk_print_job_get_num_copies ()
void gtk_print_job_set_num_copies ()
gdouble gtk_print_job_get_scale ()
void gtk_print_job_set_scale ()
guint gtk_print_job_get_n_up ()
void gtk_print_job_set_n_up ()
GtkNumberUpLayout gtk_print_job_get_n_up_layout ()
void gtk_print_job_set_n_up_layout ()
gboolean gtk_print_job_get_rotate ()
void gtk_print_job_set_rotate ()
gboolean gtk_print_job_get_collate ()
void gtk_print_job_set_collate ()
gboolean gtk_print_job_get_reverse ()
void gtk_print_job_set_reverse ()

Свойства

GtkPageSetup * page-setup Чтение / Запись / Только для создания
GtkPrinter * printer Чтение / Запись / Только для создания
GtkPrintSettings * settings Чтение / Запись / Только для создания
gchar * title Чтение / Запись / Только для создания
gboolean track-print-status Чтение / Запись

Сигналы

void status-changed Запуск последним

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

struct GtkPrintJob

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

    GObject
    ╰── GtkPrintJob

Файлы заголовков

#include <gtk/gtkprintjob.h>

Описание

Объект GtkPrintJob представляет задачу, отправленную на печать. Вам нужно взаимодействовать с объектами печати напрямую только если используется непортируемый API GtkPrintUnixDialog.

Используйте gtk_print_job_get_surface(), чтобы получить cairo-поверхность, на которую необходимо нарисовать страницы. Используйте gtk_print_job_send(), чтобы отправить готовую задачу на печать. Если вы не используете cairo, GtkPrintJob также поддерживает печать вручную сгенерированного PostScript, с помощью gtk_print_job_set_source_file().

Функции

GtkPrintJobCompleteFunc ()

void
(*GtkPrintJobCompleteFunc) (GtkPrintJob *print_job,
                            gpointer user_data,
                            const GError *error);

Тип обратного вызова, передаваемого в gtk_print_job_send(). Вызывается, когда задание печати полностью отправлено.

Параметры

print_job

объект GtkPrintJob

user_data

данные пользователя, переданные в gtk_print_job_send()

error

объект GError, содержащий информацию об ошибке, если отправка задания печати завершилась ошибкой, в противном случае NULL

gtk_print_job_new ()

GtkPrintJob *
gtk_print_job_new (const gchar *title,
                   GtkPrinter *printer,
                   GtkPrintSettings *settings,
                   GtkPageSetup *page_setup);

Создаёт новое задание печати GtkPrintJob.

Параметры

title

заголовок задания

printer

объект GtkPrinter

settings

объект GtkPrintSettings

page_setup

объект GtkPageSetup

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

новое задание печати GtkPrintJob

С: 2.10

gtk_print_job_get_settings ()

GtkPrintSettings *
gtk_print_job_get_settings (GtkPrintJob *job);

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

Параметры

job

объект GtkPrintJob

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

настройки job .

[transfer none]

С: 2.10

gtk_print_job_get_printer ()

GtkPrinter *
gtk_print_job_get_printer (GtkPrintJob *job);

Возвращает принтер GtkPrinter задания.

Параметры

job

объект GtkPrintJob

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

принтер job .

[transfer none]

С: 2.10

gtk_print_job_get_title ()

const gchar *
gtk_print_job_get_title (GtkPrintJob *job);

Возвращает заголовок задания.

Параметры

job

объект GtkPrintJob

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

заголовок job

С: 2.10

gtk_print_job_get_status ()

GtkPrintStatus
gtk_print_job_get_status (GtkPrintJob *job);

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

Параметры

job

объект GtkPrintJob

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

статус job

С: 2.10

gtk_print_job_set_source_file ()

gboolean
gtk_print_job_set_source_file (GtkPrintJob *job,
                               const gchar *filename,
                               GError **error);

Указывает, что задание печати GtkPrintJob должно отправить существующий документ в систему печати. Файл может быть в любом формате, поддерживаемом системой печати платформы (обычно PostScript, но на многих платформах может работать и PDF). См. gtk_printer_accepts_pdf() и gtk_printer_accepts_ps().

Параметры

job

объект GtkPrintJob

filename

файл, который нужно распечатать.

[type filename]

error

место для возврата ошибок

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

FALSE, если произошла ошибка

С: 2.10

gtk_print_job_get_surface ()

cairo_surface_t *
gtk_print_job_get_surface (GtkPrintJob *job,
                           GError **error);

Возвращает поверхность cairo, на которой следует отрисовать страницы задания печати.

Параметры

job

объект GtkPrintJob

error

место для возврата ошибок или NULL.

[allow-none]

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

поверхность cairo job .

[transfer none]

С: 2.10

gtk_print_job_send ()

void
gtk_print_job_send (GtkPrintJob *job,
                    GtkPrintJobCompleteFunc callback,
                    gpointer user_data,
                    GDestroyNotify dnotify);

Отправляет задание печати на принтер.

Параметры

job

объект GtkPrintJob

callback

функция, вызываемая при завершении задания или возникновении ошибки

user_data

данные пользователя, передаваемые в callback

dnotify

информация о уничтожении user_data

С: 2.10

gtk_print_job_set_track_print_status ()

void
gtk_print_job_set_track_print_status (GtkPrintJob *job,
                                      gboolean track_status);

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

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

Параметры

job

объект GtkPrintJob

track_status

TRUE для отслеживания статуса после печати

С: 2.10

gtk_print_job_get_track_print_status ()

gboolean
gtk_print_job_get_track_print_status (GtkPrintJob *job);

Возвращает, будут ли отслеживаться задачи после печати. Для получения подробной информации см. gtk_print_job_set_track_print_status().

Параметры

job

a GtkPrintJob

Возвращает

TRUE, если статус задачи печати будет сообщён после печати

С: 2.10

gtk_print_job_get_pages ()

GtkPrintPages
gtk_print_job_get_pages (GtkPrintJob *job);

Получает значение настройки GtkPrintPages для этой задачи.

Параметры

job

a GtkPrintJob

Возвращает

значение настройки GtkPrintPages

С: 3.0

gtk_print_job_set_pages ()

void
gtk_print_job_set_pages (GtkPrintJob *job,
                         GtkPrintPages pages);

Устанавливает значение настройки GtkPrintPages для этой задачи.

Параметры

job

a GtkPrintJob

pages

значение настройки GtkPrintPages

С: 3.0

gtk_print_job_get_page_ranges ()

GtkPageRange *
gtk_print_job_get_page_ranges (GtkPrintJob *job,
                               gint *n_ranges);

Получает диапазоны страниц для этой задачи.

Параметры

job

a GtkPrintJob

n_ranges

место для возврата количества диапазонов.

[out]

Возвращает

указатель на массив структур GtkPageRange.

[array length=n_ranges][transfer none]

С: 3.0

gtk_print_job_set_page_ranges ()

void
gtk_print_job_set_page_ranges (GtkPrintJob *job,
                               GtkPageRange *ranges,
                               gint n_ranges);

Устанавливает диапазоны страниц для этой задачи.

Параметры

job

a GtkPrintJob

ranges

указатель на массив структур GtkPageRange.

[array length=n_ranges]

n_ranges

длина массива ranges

С: 3.0

gtk_print_job_get_page_set ()

GtkPageSet
gtk_print_job_get_page_set (GtkPrintJob *job);

Получает значение настройки GtkPageSet для этой задачи.

Параметры

job

a GtkPrintJob

Возвращает

значение настройки GtkPageSet

С: 3.0

gtk_print_job_set_page_set ()

void
gtk_print_job_set_page_set (GtkPrintJob *job,
                            GtkPageSet page_set);

Устанавливает значение настройки GtkPageSet для этой задачи.

Параметры

job

a GtkPrintJob

page_set

значение настройки GtkPageSet

С: 3.0

gtk_print_job_get_num_copies ()

gint
gtk_print_job_get_num_copies (GtkPrintJob *job);

Получает количество копий этой задачи.

Параметры

job

a GtkPrintJob

Возвращает

количество копий

С: 3.0

gtk_print_job_set_num_copies ()

void
gtk_print_job_set_num_copies (GtkPrintJob *job,
                              gint num_copies);

Устанавливает количество копий для этой задачи.

Параметры

job

a GtkPrintJob

num_copies

количество копий

С: 3.0

gtk_print_job_get_scale ()

gdouble
gtk_print_job_get_scale (GtkPrintJob *job);

Получает масштаб для этой задачи (где 1.0 означает отсутствие масштабирования).

Параметры

job

a GtkPrintJob

Возвращает

масштаб

С: 3.0

gtk_print_job_set_scale ()

void
gtk_print_job_set_scale (GtkPrintJob *job,
                         gdouble scale);

Устанавливает масштаб для этой задачи (где 1.0 означает отсутствие масштабирования).

Параметры

job

a GtkPrintJob

scale

масштаб

С: 3.0

gtk_print_job_get_n-up ()

guint
gtk_print_job_get_n_up (GtkPrintJob *job);

Получает значение настройки n-up для этой задачи.

Параметры

job

a GtkPrintJob

Возвращает

значение настройки n-up

С: 3.0

gtk_print_job_set_n_up ()

void
gtk_print_job_set_n_up (GtkPrintJob *job,
                        guint n_up);

Устанавливает значение n-up для этой задачи.

Параметры

job

a GtkPrintJob

n_up

значение n-up

С момента: 3.0

gtk_print_job_get_n_up_layout ()

GtkNumberUpLayout
gtk_print_job_get_n_up_layout (GtkPrintJob *job);

Получает значение параметра макета n-up для этой задачи.

Параметры

job

a GtkPrintJob

Возвращает

макет n-up

С момента: 3.0

gtk_print_job_set_n_up_layout ()

void
gtk_print_job_set_n_up_layout (GtkPrintJob *job,
                               GtkNumberUpLayout layout);

Устанавливает значение параметра макета n-up для этой задачи.

Параметры

job

a GtkPrintJob

layout

значение параметра макета n-up

С момента: 3.0

gtk_print_job_get_rotate ()

gboolean
gtk_print_job_get_rotate (GtkPrintJob *job);

Получает, вращается ли задача при печати.

Параметры

job

a GtkPrintJob

Возвращает

вращается ли задача при печати

С момента: 3.0

gtk_print_job_set_rotate ()

void
gtk_print_job_set_rotate (GtkPrintJob *job,
                          gboolean rotate);

Устанавливает, вращается ли эта задача при печати.

Параметры

job

a GtkPrintJob

rotate

вращать при печати

С момента: 3.0

gtk_print_job_get_collate ()

gboolean
gtk_print_job_get_collate (GtkPrintJob *job);

Получает, отсортирована ли эта задача при печати.

Параметры

job

a GtkPrintJob

Возвращает

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

С момента: 3.0

gtk_print_job_set_collate ()

void
gtk_print_job_set_collate (GtkPrintJob *job,
                           gboolean collate);

Устанавливает, отсортирована ли эта задача при печати.

Параметры

job

a GtkPrintJob

collate

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

С момента: 3.0

gtk_print_job_get_reverse ()

gboolean
gtk_print_job_get_reverse (GtkPrintJob *job);

Получает, перевернута ли эта задача при печати.

Параметры

job

a GtkPrintJob

Возвращает

перевернута ли задача при печати

С момента: 3.0

gtk_print_job_set_reverse ()

void
gtk_print_job_set_reverse (GtkPrintJob *job,
                           gboolean reverse);

Устанавливает, перевернута ли эта задача при печати.

Параметры

job

a GtkPrintJob

reverse

перевернута ли задача при печати

С момента: 3.0

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

struct GtkPrintJob

struct GtkPrintJob;

Подробности свойств

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

  “page-setup”               GtkPageSetup *

Настройка страницы.

Флаги: Чтение / Запись / Только для создания

Свойство “printer”

  “printer”                  GtkPrinter *

Принтер, на который должна быть напечатана задача.

Флаги: Чтение / Запись / Только для создания

Свойство “settings”

  “settings”                 GtkPrintSettings *

Настройки принтера.

Флаги: Чтение / Запись / Только для создания

Свойство “title”

  “title”                    gchar *

Заголовок задачи печати.

Флаги: Чтение / Запись / Только для создания

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

Свойство “track-print-status”

  “track-print-status”       gboolean

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

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

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

Подробности сигналов

Сигнал “status-changed”

void
user_function (GtkPrintJob *job,
               gpointer     user_data)

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

Параметры

job

объект GtkPrintJob, на котором был выпущен сигнал

user_data

данные пользователя, заданные при подключении обработчика сигнала.

Флаги: Run Last

С момента: 2.10

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

Spec-Zone.ru

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