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

#include <gtk/gtk.h>


            gtkprinter;
            gtkprintbackend;
gtkprinter* gtk_printer_new                 (const gchar *name,
                                             gtkprintbackend *backend,
                                             gboolean virtual_);
gtkprintbackend* gtk_printer_get_backend    (gtkprinter *printer);
const gchar* gtk_printer_get_name           (gtkprinter *printer);
const gchar* gtk_printer_get_state_message  (gtkprinter *printer);
const gchar* gtk_printer_get_description    (gtkprinter *printer);
const gchar* gtk_printer_get_location       (gtkprinter *printer);
const gchar* gtk_printer_get_icon_name      (gtkprinter *printer);
gint        gtk_printer_get_job_count       (gtkprinter *printer);
gboolean    gtk_printer_is_active           (gtkprinter *printer);
gboolean    gtk_printer_is_virtual          (gtkprinter *printer);
gboolean    gtk_printer_is_default          (gtkprinter *printer);

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

  gobject
   +----gtkprinter

  gobject
   +----gtkprintbackend

свойства

  "backend"              gtkprintbackend       : read / write / construct only
  "icon-name"            gchararray            : read
  "is-virtual"           gboolean              : read / write / construct only
  "job-count"            gint                  : read
  "location"             gchararray            : read
  "name"                 gchararray            : read / write / construct only
  "state-message"        gchararray            : read

сигналы

"details-acquired"
            void        user_function      (gtkprinter *printer,
                                            gboolean    success,
                                            gpointer    user_data)      : run last

описание

объект gtkprinter представляет принтер. вам придётся иметь дело непосредственно с принтерами, если вы использует не переносимый (non-portable) gtkprintunixdialog api.

gtkprinter позволяет получать информацию состояния принтера, такую как его описание, размещение, количество задач в очереди на печать, и т.д.. самое важное gtkprinter объект может использоваться для создания gtkprintjob объекта, который позволяет вам печатать на принтере.

печать поддерживается начиная с версии gtk+ 2.10.

детали

gtkprinter

typedef struct _gtkprinter gtkprinter;

gtkprintbackend

typedef struct _gtkprintbackend gtkprintbackend;

gtk_printer_new ()

gtkprinter* gtk_printer_new                 (const gchar *name,
                                             gtkprintbackend *backend,
                                             gboolean virtual_);

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

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

gtk_printer_get_backend ()

gtkprintbackend* gtk_printer_get_backend    (gtkprinter *printer);

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

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

gtk_printer_get_name ()

const gchar* gtk_printer_get_name           (gtkprinter *printer);

возвращает имя принтера.

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

gtk_printer_get_state_message ()

const gchar* gtk_printer_get_state_message  (gtkprinter *printer);

возвращает сообщение описывающее текущеме состояние принтера.

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

gtk_printer_get_description ()

const gchar* gtk_printer_get_description    (gtkprinter *printer);

возвращает описание принтера.

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

gtk_printer_get_location ()

const gchar* gtk_printer_get_location       (gtkprinter *printer);

возвращает описание размещения принтера.

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

gtk_printer_get_icon_name ()

const gchar* gtk_printer_get_icon_name      (gtkprinter *printer);

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

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

gtk_printer_get_job_count ()

gint        gtk_printer_get_job_count       (gtkprinter *printer);

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

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

gtk_printer_is_active ()

gboolean    gtk_printer_is_active           (gtkprinter *printer);

определяет является ли принтер активным в текущий момент (то есть принимает новое задание).

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

gtk_printer_is_virtual ()

gboolean    gtk_printer_is_virtual          (gtkprinter *printer);

определяет является ли принтер виртуальным (то есть представляет не фактический принтер, а некоторый класс cups).

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

gtk_printer_is_default ()

gboolean    gtk_printer_is_default          (gtkprinter *printer);

определяет является ли принтер – принтером по умолчанию.

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

детали свойств

свойство "backend"

  "backend"              gtkprintbackend       : read / write / construct only

драйвер принтера.

свойство "icon-name"

  "icon-name"            gchararray            : read

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

значение по умолчанию: null

свойство "is-virtual"

  "is-virtual"           gboolean              : read / write / construct only

false если представлен реальный аппаратный принтер.

значение по умолчанию: false

свойство "job-count"

  "job-count"            gint                  : read

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

допустимые значения: >= 0

значение по умолчанию: 0

свойство "location"

  "location"             gchararray            : read

размещение принтера.

значение по умолчанию: null

свойство "name"

  "name"                 gchararray            : read / write / construct only

имя принтера.

значение по умолчанию: null

свойство "state-message"

  "state-message"        gchararray            : read

строка описывающая текущеме состояние принтера.

значение по умолчанию: null

детали сигналов

сигнал "details-acquired"

void        user_function                  (gtkprinter *printer,
                                            gboolean    success,
                                            gpointer    user_data)      : run last

издаётся в ответ на запрос подробной информации о принтере из драйвера принтера. параметр success указывает была ли информация фактически получена.

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