Spec-Zone.ru › GTK 3.22

GtkPrinter

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

Функции

GtkPrinter * gtk_printer_new ()
GtkPrintBackend * gtk_printer_get_backend ()
const gchar * gtk_printer_get_name ()
const gchar * gtk_printer_get_state_message ()
const gchar * gtk_printer_get_description ()
const gchar * gtk_printer_get_location ()
const gchar * gtk_printer_get_icon_name ()
gint gtk_printer_get_job_count ()
gboolean gtk_printer_is_active ()
gboolean gtk_printer_is_paused ()
gboolean gtk_printer_is_accepting_jobs ()
gboolean gtk_printer_is_virtual ()
gboolean gtk_printer_is_default ()
gboolean gtk_printer_accepts_ps ()
gboolean gtk_printer_accepts_pdf ()
GList * gtk_printer_list_papers ()
gint gtk_printer_compare ()
gboolean gtk_printer_has_details ()
void gtk_printer_request_details ()
GtkPrintCapabilities gtk_printer_get_capabilities ()
GtkPageSetup * gtk_printer_get_default_page_size ()
gboolean gtk_printer_get_hard_margins ()
gboolean (*GtkPrinterFunc) ()
void gtk_enumerate_printers ()

Свойства

gboolean accepting-jobs Чтение
gboolean accepts-pdf Чтение / Запись / Только для создания
gboolean accepts-ps Чтение / Запись / Только для создания
GtkPrintBackend * backend Чтение / Запись / Только для создания
gchar * icon-name Чтение
gboolean is-virtual Чтение / Запись / Только для создания
gint job-count Чтение
gchar * location Чтение
gchar * name Чтение / Запись / Только для создания
gboolean paused Чтение
gchar * state-message Чтение

Сигналы

void details-acquired Run Last

Типы и значения

struct GtkPrinter
GtkPrintBackend

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

    GObject
    ├── GtkPrintBackend
    ╰── GtkPrinter

Включаемые файлы

#include <gtk/gtk.h>

Описание

Объект GtkPrinter представляет принтер. Вам нужно работать напрямую с принтерами только если вы используете непортативный API GtkPrintUnixDialog.

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

Поддержка печати была добавлена в GTK+ 2.10.

Функции

gtk_printer_new ()

GtkPrinter *
gtk_printer_new (const gchar *name,
                 GtkPrintBackend *backend,
                 gboolean virtual_);

Создаёт новый GtkPrinter.

Параметры

name

имя принтера

backend

a GtkPrintBackend

virtual_

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

Возвращает

новый GtkPrinter

С: 2.10

gtk_printer_get_backend ()

GtkPrintBackend *
gtk_printer_get_backend (GtkPrinter *printer);

Возвращает бэкенд принтера.

Параметры

printer

a GtkPrinter

Возвращает

бэкенд printer .

[transfer none]

С: 2.10

gtk_printer_get_name ()

const gchar *
gtk_printer_get_name (GtkPrinter *printer);

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

Параметры

printer

a GtkPrinter

Возвращает

имя printer

С: 2.10

gtk_printer_get_state_message ()

const gchar *
gtk_printer_get_state_message (GtkPrinter *printer);

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

Параметры

printer

a GtkPrinter

Возвращает

сообщение состояния printer

С: 2.10

gtk_printer_get_description ()

const gchar *
gtk_printer_get_description (GtkPrinter *printer);

Получает описание принтера.

Параметры

printer

a GtkPrinter

Возвращает

описание printer

С: 2.10

gtk_printer_get_location ()

const gchar *
gtk_printer_get_location (GtkPrinter *printer);

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

Параметры

printer

a GtkPrinter

Возвращает

расположение printer

С: 2.10

gtk_printer_get_icon_name ()

const gchar *
gtk_printer_get_icon_name (GtkPrinter *printer);

Получает имя иконки для принтера.

Параметры

printer

a GtkPrinter

Возвращает

имя иконки для printer

С: 2.10

gtk_printer_get_job_count ()

gint
gtk_printer_get_job_count (GtkPrinter *printer);

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

Параметры

printer

a GtkPrinter

Возвращает

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

С: 2.10

gtk_printer_is_active ()

gboolean
gtk_printer_is_active (GtkPrinter *printer);

Возвращает, активен ли принтер (т.е. принимает ли новые задания).

Параметры

printer

a GtkPrinter

Возвращает

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

С: 2.10

gtk_printer_is_paused ()

gboolean
gtk_printer_is_paused (GtkPrinter *printer);

Возвращает, приостановлен ли принтер. Приостановленный принтер всё ещё принимает задания, но не печатает их.

Параметры

printer

a GtkPrinter

Возвращает

TRUE, если printer приостановлен

С: 2.14

gtk_printer_is_accepting_jobs ()

gboolean
gtk_printer_is_accepting_jobs (GtkPrinter *printer);

Возвращает, принимает ли принтер задания

Параметры

printer

a GtkPrinter

Возвращает

TRUE, если printer принимает задания

С: 2.14

gtk_printer_is_virtual ()

gboolean
gtk_printer_is_virtual (GtkPrinter *printer);

Возвращает, является ли принтер виртуальным (т.е. не представляет реальное аппаратное обеспечение принтера, а что-то вроде класса CUPS).

Параметры

printer

a GtkPrinter

Возвращает

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

С: 2.10

gtk_printer_is_default ()

gboolean
gtk_printer_is_default (GtkPrinter *printer);

Возвращает, является ли принтер принтером по умолчанию.

Параметры

printer

a GtkPrinter

Возвращает

TRUE, если printer по умолчанию

С: 2.10

gtk_printer_accepts_ps ()

gboolean
gtk_printer_accepts_ps (GtkPrinter *printer);

Возвращает, принимает ли принтер входные данные в формате PostScript.

Параметры

printer

a GtkPrinter

Возвращает

TRUE, если printer принимает PostScript

С: 2.10

gtk_printer_accepts_pdf ()

gboolean
gtk_printer_accepts_pdf (GtkPrinter *printer);

Возвращает, принимает ли принтер входные данные в формате PDF.

Параметры

принтер

a GtkPrinter

Возвращает

TRUE, если printer принимает PDF

С: 2.10

gtk_printer_list_papers ()

GList *
gtk_printer_list_papers (GtkPrinter *printer);

Отображает все размеры бумаги, которые printer поддерживает. Будет возвращать пустой список, если данные принтера недоступны, см. gtk_printer_has_details() и gtk_printer_request_details().

Параметры

принтер

a GtkPrinter

Возвращает

новый выделенный список вновь выделенных GtkPageSetup.

[element-type GtkPageSetup][transfer full]

С: 2.12

gtk_printer_compare ()

gint
gtk_printer_compare (GtkPrinter *a,
                     GtkPrinter *b);

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

Параметры

a

a GtkPrinter

b

another GtkPrinter

Возвращает

0, если принтеры совпадают, отрицательное значение, если a < b , или положительное значение, если a > b

С: 2.10

gtk_printer_has-details ()

gboolean
gtk_printer_has_details (GtkPrinter *printer);

Возвращает, доступны ли данные принтера.

Параметры

принтер

a GtkPrinter

Возвращает

TRUE, если данные printer принтера доступны

С: 2.12

gtk_printer_request-details ()

void
gtk_printer_request_details (GtkPrinter *printer);

Запрашивает данные принтера. Когда данные доступны, на printer будет отправлен сигнал «details-acquired».

Параметры

принтер

a GtkPrinter

С: 2.12

gtk_printer_get-capabilities ()

GtkPrintCapabilities
gtk_printer_get_capabilities (GtkPrinter *printer);

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

Это полезно, когда вы используете GtkPrintUnixDialog и настройку manual-capabilities и хотите знать, какие настройки принтер может обработать, а какие нужно обработать самостоятельно.

Возвращает 0, если данные принтера недоступны, см. gtk_printer_has_details() и gtk_printer_request_details().

Параметры

принтер

a GtkPrinter

Возвращает

возможности принтера

С: 2.12

gtk_printer_get-default-page-size ()

GtkPageSetup *
gtk_printer_get_default_page_size (GtkPrinter *printer);

Возвращает размер страницы по умолчанию для printer.

Параметры

принтер

a GtkPrinter

Возвращает

новый выделенный GtkPageSetup с размером страницы по умолчанию для принтера.

С: 2.14

gtk_printer_get_hard-margins ()

gboolean
gtk_printer_get_hard_margins (GtkPrinter *printer,
                              gdouble *top,
                              gdouble *bottom,
                              gdouble *left,
                              gdouble *right);

Получает жёсткие поля printer, т. е. поля, определяющие область по краям бумаги, на которую принтер не может печатать.

Примечание: это не сработает, если данные принтера недоступны, см. gtk_printer_has_details() и gtk_printer_request_details().

Параметры

принтер

a GtkPrinter

верх

место для хранения верхнего поля.

[out]

низ

место для хранения нижнего поля.

[out]

слева

место для хранения левого поля.

[out]

справа

место для хранения правого поля.

[out]

Возвращает

TRUE, если жёсткие поля были получены

С: 2.20

GtkPrinterFunc ()

gboolean
(*GtkPrinterFunc) (GtkPrinter *printer,
                   gpointer data);

Тип функции, переданной в gtk_enumerate_printers(). Обратите внимание, что вам нужно сохранить ссылку на printer, если вы хотите сохранить ссылку на неё после возврата функции.

Параметры

принтер

a GtkPrinter

данные

пользовательские данные, переданные в gtk_enumerate_printers().

[closure]

Возвращает

TRUE для остановки перечисления, FALSE для продолжения

С: 2.10

gtk_enumerate_printers ()

void
gtk_enumerate_printers (GtkPrinterFunc func,
                        gpointer data,
                        GDestroyNotify destroy,
                        gboolean wait);

Вызывает функцию для всех GtkPrinters. Если func возвращает TRUE, перечисление останавливается.

Параметры

func

функция, вызываемая для каждого принтера

data

пользовательские данные, передаваемые в func

destroy

функция, вызываемая, если data больше не требуется

wait

если TRUE, ожидать в рекурсивном цикле обработки событий до перечисления всех принтеров; в противном случае возвратиться сразу

С: 2.10

Типы и значения

struct GtkPrinter

struct GtkPrinter;

GtkPrintBackend

typedef struct _GtkPrintBackend GtkPrintBackend;

Подробности свойств

Свойство “accepting-jobs”

  “accepting-jobs”           gboolean

Это свойство равно TRUE, если принтер принимает задания.

Флаги: Чтение

Значение по умолчанию: TRUE

С: 2.14

Свойство “accepts-pdf”

  “accepts-pdf”              gboolean

TRUE, если этот принтер может принимать PDF.

Флаги: Чтение / Запись / Только для создания

Значение по умолчанию: FALSE

Свойство “accepts-ps”

  “accepts-ps”               gboolean

TRUE, если этот принтер может принимать PostScript.

Флаги: Чтение / Запись / Только для создания

Значение по умолчанию: TRUE

Свойство “backend”

  “backend”                  GtkPrintBackend *

Бэкенд для принтера.

Флаги: Чтение / Запись / Только для создания

Свойство “icon-name”

  “icon-name”                gchar *

Имя иконки для принтера.

Флаги: Чтение

Значение по умолчанию: ""

Свойство “is-virtual”

  “is-virtual”               gboolean

FALSE, если это представляет реальный принтер.

Флаги: Чтение / Запись / Только для создания

Значение по умолчанию: FALSE

Свойство “job-count”

  “job-count”                gint

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

Флаги: Чтение

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

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

Свойство “location”

  “location”                 gchar *

Расположение принтера.

Флаги: Чтение

Значение по умолчанию: ""

Свойство “name”

  “name”                     gchar *

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

Флаги: Чтение / Запись / Только для создания

Значение по умолчанию: ""

Свойство “paused”

  “paused”                   gboolean

Это свойство равно TRUE, если этот принтер приостановлен. Приостановленный принтер все ещё принимает задания, но не печатает их.

Флаги: Чтение

Значение по умолчанию: FALSE

С: 2.14

Свойство “state-message”

  “state-message”            gchar *

Строка, отображающая текущее состояние принтера.

Флаги: Чтение

Значение по умолчанию: ""

Подробности сигналов

Сигнал “details-acquired”

void
user_function (GtkPrinter *printer,
               gboolean    success,
               gpointer    user_data)

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

Параметры

printer

принтер GtkPrinter, на котором испускается сигнал

success

TRUE, если детали были успешно получены

user_data

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

Флаги: Run Last

С: 2.10

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.22/GtkPrinter.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API