краткое описание

#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.

детали

gtkprintjob

typedef struct _gtkprintjob gtkprintjob;

gtkprintjobcompletefunc ()

void        (*gtkprintjobcompletefunc)      (gtkprintjob *print_job,
                                             gpointer user_data,
                                             gerror *error);

gtk_print_job_new ()

gtkprintjob* gtk_print_job_new              (const gchar *title,
                                             gtkprinter *printer,
                                             gtkprintsettings *settings,
                                             gtkpagesetup *page_setup);

создаёт новый gtkprintjob.

начиная с версии 2.10

gtk_print_job_get_settings ()

gtkprintsettings* gtk_print_job_get_settings
                                            (gtkprintjob *job);

определяет gtkprintsettings задания печати.

начиная с версии 2.10

gtk_print_job_get_printer ()

gtkprinter* gtk_print_job_get_printer       (gtkprintjob *job);

определяет gtkprinter задания печати.

начиная с версии 2.10

gtk_print_job_get_title ()

const gchar* gtk_print_job_get_title        (gtkprintjob *job);

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

начиная с версии 2.10

gtk_print_job_get_status ()

gtkprintstatus gtk_print_job_get_status     (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).

начиная с версии 2.10

gtk_print_job_get_surface ()

cairo_surface_t* gtk_print_job_get_surface  (gtkprintjob *job,
                                             gerror **error);

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

начиная с версии 2.10

gtk_print_job_send ()

gboolean    gtk_print_job_send              (gtkprintjob *job,
                                             gtkprintjobcompletefunc callback,
                                             gpointer user_data,
                                             gdestroynotify dnotify,
                                             gerror **error);

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

начиная с версии 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() для определения нового статуса.

начиная с версии 2.10