GtkPrintJob
GtkPrintJob — Представляет задание печати
Функции
Свойства
| GtkPageSetup * | page-setup | Чтение / Запись / Только для создания |
| GtkPrinter * | printer | Чтение / Запись / Только для создания |
| GtkPrintSettings * | settings | Чтение / Запись / Только для создания |
| gchar * | title | Чтение / Запись / Только для создания |
| gboolean | track-print-status | Чтение / Запись |
Сигналы
Типы и значения
| 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 | данные пользователя, переданные в | |
error | объект GError, содержащий информацию об ошибке, если отправка задания печати завершилась ошибкой, в противном случае |
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 | место для возврата ошибок или | [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 | данные пользователя, передаваемые в | |
dnotify | информация о уничтожении |
С: 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 |
|
С: 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 |
Возвращает
TRUE, если статус задачи печати будет сообщён после печати
С: 2.10
gtk_print_job_get_pages ()
GtkPrintPages
gtk_print_job_get_pages (GtkPrintJob *job); Получает значение настройки GtkPrintPages для этой задачи.
Параметры
job |
Возвращает
значение настройки GtkPrintPages
С: 3.0
gtk_print_job_set_pages ()
void gtk_print_job_set_pages (GtkPrintJob *job,GtkPrintPages pages);
Устанавливает значение настройки GtkPrintPages для этой задачи.
Параметры
job | ||
pages | значение настройки GtkPrintPages |
С: 3.0
gtk_print_job_get_page_ranges ()
GtkPageRange * gtk_print_job_get_page_ranges (GtkPrintJob *job,gint *n_ranges);
Получает диапазоны страниц для этой задачи.
Параметры
job | ||
n_ranges | место для возврата количества диапазонов. | [out] |
С: 3.0
gtk_print_job_set_page_ranges ()
void gtk_print_job_set_page_ranges (GtkPrintJob *job,GtkPageRange *ranges,gint n_ranges);
Устанавливает диапазоны страниц для этой задачи.
Параметры
job | ||
ranges | указатель на массив структур GtkPageRange. | [array length=n_ranges] |
n_ranges | длина массива |
С: 3.0
gtk_print_job_get_page_set ()
GtkPageSet
gtk_print_job_get_page_set (GtkPrintJob *job); Получает значение настройки GtkPageSet для этой задачи.
Параметры
job |
Возвращает
значение настройки GtkPageSet
С: 3.0
gtk_print_job_set_page_set ()
void gtk_print_job_set_page_set (GtkPrintJob *job,GtkPageSet page_set);
Устанавливает значение настройки GtkPageSet для этой задачи.
Параметры
job | ||
page_set | значение настройки GtkPageSet |
С: 3.0
gtk_print_job_get_num_copies ()
gint
gtk_print_job_get_num_copies (GtkPrintJob *job); Получает количество копий этой задачи.
Параметры
job |
Возвращает
количество копий
С: 3.0
gtk_print_job_set_num_copies ()
void gtk_print_job_set_num_copies (GtkPrintJob *job,gint num_copies);
Устанавливает количество копий для этой задачи.
Параметры
job | ||
num_copies | количество копий |
С: 3.0
gtk_print_job_get_scale ()
gdouble
gtk_print_job_get_scale (GtkPrintJob *job); Получает масштаб для этой задачи (где 1.0 означает отсутствие масштабирования).
Параметры
job |
Возвращает
масштаб
С: 3.0
gtk_print_job_set_scale ()
void gtk_print_job_set_scale (GtkPrintJob *job,gdouble scale);
Устанавливает масштаб для этой задачи (где 1.0 означает отсутствие масштабирования).
Параметры
job | ||
scale | масштаб |
С: 3.0
gtk_print_job_get_n-up ()
guint
gtk_print_job_get_n_up (GtkPrintJob *job); Получает значение настройки n-up для этой задачи.
Параметры
job |
Возвращает
значение настройки 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 | ||
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 |
Возвращает
макет 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 | ||
layout | значение параметра макета n-up |
С момента: 3.0
gtk_print_job_get_rotate ()
gboolean
gtk_print_job_get_rotate (GtkPrintJob *job); Получает, вращается ли задача при печати.
Параметры
job |
Возвращает
вращается ли задача при печати
С момента: 3.0
gtk_print_job_set_rotate ()
void gtk_print_job_set_rotate (GtkPrintJob *job,gboolean rotate);
Устанавливает, вращается ли эта задача при печати.
Параметры
job | ||
rotate | вращать при печати |
С момента: 3.0
gtk_print_job_get_collate ()
gboolean
gtk_print_job_get_collate (GtkPrintJob *job); Получает, отсортирована ли эта задача при печати.
Параметры
job |
Возвращает
отсортирована ли задача при печати
С момента: 3.0
gtk_print_job_set_collate ()
void gtk_print_job_set_collate (GtkPrintJob *job,gboolean collate);
Устанавливает, отсортирована ли эта задача при печати.
Параметры
job | ||
collate | отсортирована ли задача при печати |
С момента: 3.0
gtk_print_job_get_reverse ()
gboolean
gtk_print_job_get_reverse (GtkPrintJob *job); Получает, перевернута ли эта задача при печати.
Параметры
job |
Возвращает
перевернута ли задача при печати
С момента: 3.0
gtk_print_job_set_reverse ()
void gtk_print_job_set_reverse (GtkPrintJob *job,gboolean reverse);
Устанавливает, перевернута ли эта задача при печати.
Параметры
job | ||
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