|  |  | GTK+ Reference Manual |
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