Prev

Up

Home

GTK+ Reference Manual

Next

Top  |  Description  |  Object Hierarchy  |  Properties  |  Signals

GtkPrinter

GtkPrinter Представляет принтер

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

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

name :

Имя принтера

backend :

GtkPrintBackend

virtual_ :

Является ли принтер виртуальным

Возвращает:

новый GtkPrinter

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


gtk_printer_get_backend ()

GtkPrintBackend* gtk_printer_get_backend    (GtkPrinter *printer);

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

printer :

GtkPrinter

Возвращает:

Драйвер принтера printer

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


gtk_printer_get_name ()

const gchar* gtk_printer_get_name           (GtkPrinter *printer);

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

printer :

GtkPrinter

Возвращает:

имя printer

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


gtk_printer_get_state_message ()

const gchar* gtk_printer_get_state_message  (GtkPrinter *printer);

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

printer :

GtkPrinter

Возвращает:

Текущее состояние printer

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


gtk_printer_get_description ()

const gchar* gtk_printer_get_description    (GtkPrinter *printer);

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

printer :

GtkPrinter

Возвращает:

описание printer

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


gtk_printer_get_location ()

const gchar* gtk_printer_get_location       (GtkPrinter *printer);

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

printer :

GtkPrinter

Возвращает:

размещение printer

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


gtk_printer_get_icon_name ()

const gchar* gtk_printer_get_icon_name      (GtkPrinter *printer);

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

printer :

GtkPrinter

Возвращает:

Имя значка для принтера printer

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


gtk_printer_get_job_count ()

gint        gtk_printer_get_job_count       (GtkPrinter *printer);

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

printer :

GtkPrinter

Возвращает:

Количество заданий на printer

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


gtk_printer_is_active ()

gboolean    gtk_printer_is_active           (GtkPrinter *printer);

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

printer :

GtkPrinter

Возвращает:

TRUE если printer активен

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


gtk_printer_is_virtual ()

gboolean    gtk_printer_is_virtual          (GtkPrinter *printer);

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

printer :

GtkPrinter

Возвращает:

TRUE если printer виртуальный

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


gtk_printer_is_default ()

gboolean    gtk_printer_is_default          (GtkPrinter *printer);

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

printer :

GtkPrinter

Возвращает:

TRUE если 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 указывает была ли информация фактически получена.

printer :

GtkPrinter на котором издаётся сигнал

success :

TRUE если детальная информация полностью получена

user_data :

Данные устанавливаемые при подключении обработчика сигнала.

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