GtkПечатьЗадание
GtkPrintJob — Представляет задание печати
Функции
Свойства
| GtkPageSetup * | page-setup | Чтение / Запись / Только для создания |
| GtkPrinter * | printer | Чтение / Запись / Только для создания |
| GtkPrintSettings * | settings | Чтение / Запись / Только для создания |
| char * | title | Чтение / Запись / Только для создания |
| gboolean | track-print-status | Чтение / Запись |
Сигналы
| void | status-changed | Выполнить последним |
Типы и значения
| struct | GtkPrintJob |
Иерархия объектов
GObject
╰── GtkPrintJob
Файлы заголовков
#include <gtk/gtkunixprint.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); Получает настройки печати задания.
Параметры
job | объект GtkPrintJob |
Возвращает
настройки job .
[transfer none]
С: 2.10
gtk_print_job_get_printer ()
GtkPrinter *
gtk_print_job_get_printer (GtkPrintJob *job); Получает принтер задания печати.
Параметры
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_fd ()
gboolean gtk_print_job_set_source_fd (GtkPrintJob *job,int fd,GError **error);
Приводит GtkPrintJob к отправке существующего документа в систему печати. Файл может быть в любом формате, поддерживаемом системой печати платформы (обычно PostScript, но на многих платформах может работать и PDF). См. gtk_printer_accepts_pdf() и gtk_printer_accepts_ps().
Аналогично gtk_print_job_set_source_file(), но принимает открытый дескриптор файла вместо имени файла.
Параметры
job | объект GtkPrintJob | |
fd | дескриптор файла | |
error | место для возврата ошибок |
Возвращает
FALSE при возникновении ошибки
С: 3.22
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 | объект GtkPrintJob |
Возвращает
TRUE если статус задания печати будет сообщаться после печати
С: 2.10
gtk_print_job_get_pages ()
GtkPrintPages
gtk_print_job_get_pages (GtkPrintJob *job); Получает значение GtkPrintPages для этого задания.
Параметры
job | объект GtkPrintJob |
Возвращает
значение GtkPrintPages
С: 3.0
gtk_print_job_set_pages ()
void gtk_print_job_set_pages (GtkPrintJob *job,GtkPrintPages pages);
Устанавливает значение GtkPrintPages для этого задания.
Параметры
job | объект GtkPrintJob | |
pages | значение GtkPrintPages |
С: 3.0
gtk_print_job_get_page_ranges ()
GtkPageRange * gtk_print_job_get_page_ranges (GtkPrintJob *job,gint *n_ranges);
Получает диапазоны страниц для данного задания.
Параметры
job | объект GtkPrintJob | |
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 | объект GtkPrintJob | |
ranges | указатель на массив структур GtkPageRange. | [array length=n_ranges][transfer full] |
n_ranges | длина массива |
С: 3.0
gtk_print_job_get_page_set ()
GtkPageSet
gtk_print_job_get_page_set (GtkPrintJob *job); Получает значение GtkPageSet для данного задания.
Параметры
job | объект GtkPrintJob |
Возвращает
значение GtkPageSet
С: 3.0
gtk_print_job_set_page_set ()
void gtk_print_job_set_page_set (GtkPrintJob *job,GtkPageSet page_set);
Устанавливает значение GtkPageSet для данного задания.
Параметры
job | объект GtkPrintJob | |
page_set | значение GtkPageSet |
С: 3.0
gtk_print_job_get_num_copies ()
gint
gtk_print_job_get_num_copies (GtkPrintJob *job); Получает количество копий для данного задания.
Параметры
job | объект GtkPrintJob |
Возвращает
количество копий
С: 3.0
gtk_print_job_set_num_copies ()
void gtk_print_job_set_num_copies (GtkPrintJob *job,gint num_copies);
Устанавливает количество копий для данного задания.
Параметры
job | объект GtkPrintJob | |
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 layout для этого задания.
Параметры
job |
Возвращает
значение n-up layout
С версии: 3.0
gtk_print_job_set_n_up_layout ()
void gtk_print_job_set_n_up_layout (GtkPrintJob *job,GtkNumberUpLayout layout);
Устанавливает значение n-up layout для этого задания.
Параметры
job | ||
layout | значение n-up layout |
С версии: 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 *
Настройка страницы.
Владелец: GtkPrintJob
Флаги: Чтение / Запись / Только для создания
Свойство “printer”
“printer” GtkPrinter *
Принтер, на который будет напечатано задание.
Владелец: GtkPrintJob
Флаги: Чтение / Запись / Только для создания
Свойство “settings”
“settings” GtkPrintSettings *
Настройки принтера.
Владелец: GtkPrintJob
Флаги: Чтение / Запись / Только для создания
Свойство “title”
“title” char *
Заголовок задания печати.
Владелец: GtkPrintJob
Флаги: Чтение / Запись / Только для создания
Значение по умолчанию: NULL
Свойство “track-print-status”
“track-print-status” gboolean
Истинно, если задание печати будет продолжать генерировать сигналы изменения статуса после того, как данные печати были отправлены на принтер или сервер печати.
Владелец: GtkPrintJob
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
Подробности сигналов
Сигнал “status-changed”
void user_function (GtkPrintJob *job, gpointer user_data)
Издаётся, когда изменяется статус задания. Обработчик сигнала может использовать gtk_print_job_get_status(), чтобы получить новый статус.
Параметры
задание | объект GtkPrintJob, на котором был издан сигнал | |
user_data | данные пользователя, заданные при подключении обработчика сигнала. |
Флаги: Выполнить в последнюю очередь
С версии: 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.24/GtkPrintJob.html