GTK+ Reference Manual |
||||
---|---|---|---|---|
Top | Description | Object Hierarchy | Properties | Signals |
GtkPrintJobGtkPrintJob Представляет задание печати |
#include <gtk/gtk.h>
GtkPrintJob;
void (*GtkPrintJobCompleteFunc) (GtkPrintJob *print_job,
gpointer user_data,
GError *error);
GtkPrintJob* gtk_print_job_new (const gchar *title,
GtkPrinter *printer,
GtkPrintSettings *settings,
GtkPageSetup *page_setup);
GtkPrintSettings* gtk_print_job_get_settings
(GtkPrintJob *job);
GtkPrinter* gtk_print_job_get_printer (GtkPrintJob *job);
const gchar* gtk_print_job_get_title (GtkPrintJob *job);
GtkPrintStatus gtk_print_job_get_status (GtkPrintJob *job);
gboolean gtk_print_job_set_source_file (GtkPrintJob *job,
const gchar *filename,
GError **error);
cairo_surface_t* gtk_print_job_get_surface (GtkPrintJob *job,
GError **error);
gboolean gtk_print_job_send (GtkPrintJob *job,
GtkPrintJobCompleteFunc callback,
gpointer user_data,
GDestroyNotify dnotify,
GError **error);
GObject
+----GtkPrintJob
"page-setup" GtkPageSetup : Read / Write / Construct Only
"printer" GtkPrinter : Read / Write / Construct Only
"settings" GtkPrintSettings : Read / Write / Construct Only
"title" gchararray : Read / Write / Construct Only
"status-changed"
void user_function (GtkPrintJob *job,
gpointer user_data) : Run last
Объект GtkPrintJob представляет задание которое посылается на принтер. Вам придётся иметь дело непосредственно с заданием печати, если вы используете не переносимый (non-portable) GtkPrintUnixDialog API.
Используйте gtk_print_job_get_surface()
для определения внешнего вида cairo в
котором должны отображаться страницы.
Для отправки последнего задания на
принтер используйте gtk_print_job_send()
.
Если вы не используете cairo GtkPrintJob
также поддерживает печать самостоятельно
сгенерированного postscript, через
gtk_print_job_set_source_file()
.
Печать поддерживается начиная с версии GTK+ 2.10.
typedef struct _GtkPrintJob GtkPrintJob;
GtkPrintJobCompleteFunc ()
void (*GtkPrintJobCompleteFunc) (GtkPrintJob *print_job, gpointer user_data, GError *error);
|
|
|
|
|
GtkPrintJob* gtk_print_job_new (const gchar *title,
GtkPrinter *printer,
GtkPrintSettings *settings,
GtkPageSetup *page_setup);
Создаёт новый GtkPrintJob.
|
Заголовок задания |
|
|
|
|
|
|
Возвращает: |
новый GtkPrintJob |
Начиная с версии 2.10
GtkPrintSettings* gtk_print_job_get_settings
(GtkPrintJob *job);
Определяет GtkPrintSettings задания печати.
|
|
Возвращает: |
настройки |
Начиная с версии 2.10
GtkPrinter* gtk_print_job_get_printer (GtkPrintJob *job);Определяет GtkPrinter задания печати.
|
|
Возвращает: |
Принтер для |
Начиная с версии 2.10
const gchar* gtk_print_job_get_title (GtkPrintJob *job);Определяет заголовок задания.
|
|
Возвращает: |
Заголовок для |
Начиная с версии 2.10
GtkPrintStatus gtk_print_job_get_status (GtkPrintJob *job);Определяет статус задания печати.
|
|
Возвращает: |
статус |
Начиная с версии 2.10
gboolean gtk_print_job_set_source_file (GtkPrintJob *job,
const gchar *filename,
GError **error);
Создаёт GtkPrintJob отправляя существующий документ в систему печати. Файл должен быть в формате понятном для системы печати (обычно PostScript, но на некоторых платформах поддерживается также PDF).
|
|
|
Файл для печати |
|
Место для хранения возвращаемых ошибок |
Возвращает: |
|
Начиная с версии 2.10
cairo_surface_t* gtk_print_job_get_surface (GtkPrintJob *job,
GError **error);
Определяет внешний вид cairo в котором страницы задания печати должны быть представлены.
|
|
|
Место для хранения возвращаемых
ошибок, или |
Возвращает: |
Внешний вид cairo для |
Начиная с версии 2.10
gboolean gtk_print_job_send (GtkPrintJob *job,
GtkPrintJobCompleteFunc callback,
gpointer user_data,
GDestroyNotify dnotify,
GError **error);
Отправляет задания печати на принтер.
|
GtkPrintJob |
|
Функция вызываемая при выполнении задания |
|
Данные помещаемые в |
|
Разрушающее уведомление для |
|
Место для хранения возвращаемых
ошибок, или |
Возвращает: |
|
Начиная с версии 2.10
page-setup
""page-setup" GtkPageSetup : Read / Write / Construct OnlyПараметры страницы.
Свойство "
printer
""printer" GtkPrinter : Read / Write / Construct OnlyПринтер для выполнения задания печати.
Свойство "
settings
""settings" GtkPrintSettings : Read / Write / Construct OnlyНастройки принтера.
Свойство "
title
""title" gchararray : Read / Write / Construct OnlyЗаголовок задания печати.
Значение по умолчанию: NULL
Детали сигналов
Сигнал "status-changed"
void user_function (GtkPrintJob *job, gpointer user_data) : Run last
Издаётся при изменении статуса задания печати. Обработчик сигнала может использовать
gtk_print_job_get_status()
для определения нового статуса.
|
GtkPrintJob объект на котором издаётся сигнал |
|
Данные устанавливаемые при подключении обработчика сигнала. |
Начиная с версии 2.10