GtkPrinter
GtkPrinter — Представляет принтер
Функции
Свойства
| 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 | ||
virtual_ | является ли принтер виртуальным |
Возвращает
новый GtkPrinter
С: 2.10
gtk_printer_get_backend ()
GtkPrintBackend *
gtk_printer_get_backend (GtkPrinter *printer); Возвращает бэкенд принтера.
Параметры
printer |
Возвращает
бэкенд printer .
[transfer none]
С: 2.10
gtk_printer_get_name ()
const gchar *
gtk_printer_get_name (GtkPrinter *printer); Возвращает имя принтера.
Параметры
printer |
Возвращает
имя printer
С: 2.10
gtk_printer_get_state_message ()
const gchar *
gtk_printer_get_state_message (GtkPrinter *printer); Возвращает сообщение состояния, описывающее текущее состояние принтера.
Параметры
printer |
Возвращает
сообщение состояния printer
С: 2.10
gtk_printer_get_description ()
const gchar *
gtk_printer_get_description (GtkPrinter *printer); Получает описание принтера.
Параметры
printer |
Возвращает
описание printer
С: 2.10
gtk_printer_get_location ()
const gchar *
gtk_printer_get_location (GtkPrinter *printer); Возвращает описание местоположения принтера.
Параметры
printer |
Возвращает
расположение printer
С: 2.10
gtk_printer_get_icon_name ()
const gchar *
gtk_printer_get_icon_name (GtkPrinter *printer); Получает имя иконки для принтера.
Параметры
printer |
Возвращает
имя иконки для printer
С: 2.10
gtk_printer_get_job_count ()
gint
gtk_printer_get_job_count (GtkPrinter *printer); Получает количество заданий, в очереди на принтере.
Параметры
printer |
Возвращает
количество заданий на printer
С: 2.10
gtk_printer_is_active ()
gboolean
gtk_printer_is_active (GtkPrinter *printer); Возвращает, активен ли принтер (т.е. принимает ли новые задания).
Параметры
printer |
Возвращает
TRUE, если printer активен
С: 2.10
gtk_printer_is_paused ()
gboolean
gtk_printer_is_paused (GtkPrinter *printer); Возвращает, приостановлен ли принтер. Приостановленный принтер всё ещё принимает задания, но не печатает их.
Параметры
printer |
Возвращает
TRUE, если printer приостановлен
С: 2.14
gtk_printer_is_accepting_jobs ()
gboolean
gtk_printer_is_accepting_jobs (GtkPrinter *printer); Возвращает, принимает ли принтер задания
Параметры
printer |
Возвращает
TRUE, если printer принимает задания
С: 2.14
gtk_printer_is_virtual ()
gboolean
gtk_printer_is_virtual (GtkPrinter *printer); Возвращает, является ли принтер виртуальным (т.е. не представляет реальное аппаратное обеспечение принтера, а что-то вроде класса CUPS).
Параметры
printer |
Возвращает
TRUE, если printer виртуальный
С: 2.10
gtk_printer_is_default ()
gboolean
gtk_printer_is_default (GtkPrinter *printer); Возвращает, является ли принтер принтером по умолчанию.
Параметры
printer |
Возвращает
TRUE, если printer по умолчанию
С: 2.10
gtk_printer_accepts_ps ()
gboolean
gtk_printer_accepts_ps (GtkPrinter *printer); Возвращает, принимает ли принтер входные данные в формате PostScript.
Параметры
printer |
Возвращает
TRUE, если printer принимает PostScript
С: 2.10
gtk_printer_accepts_pdf ()
gboolean
gtk_printer_accepts_pdf (GtkPrinter *printer); Возвращает, принимает ли принтер входные данные в формате PDF.
Параметры
принтер |
Возвращает
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().
Параметры
принтер |
Возвращает
новый выделенный список вновь выделенных GtkPageSetup.
[element-type GtkPageSetup][transfer full]
С: 2.12
gtk_printer_compare ()
gint gtk_printer_compare (GtkPrinter *a,GtkPrinter *b);
Сравнивает два принтера.
Параметры
a | ||
b | another GtkPrinter |
Возвращает
0, если принтеры совпадают, отрицательное значение, если a < b , или положительное значение, если a > b
С: 2.10
gtk_printer_has-details ()
gboolean
gtk_printer_has_details (GtkPrinter *printer); Возвращает, доступны ли данные принтера.
Параметры
принтер |
Возвращает
TRUE, если данные printer принтера доступны
С: 2.12
gtk_printer_request-details ()
void
gtk_printer_request_details (GtkPrinter *printer); Запрашивает данные принтера. Когда данные доступны, на printer будет отправлен сигнал «details-acquired».
Параметры
принтер |
С: 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().
Параметры
принтер |
Возвращает
возможности принтера
С: 2.12
gtk_printer_get-default-page-size ()
GtkPageSetup *
gtk_printer_get_default_page_size (GtkPrinter *printer); Возвращает размер страницы по умолчанию для printer.
Параметры
принтер |
Возвращает
новый выделенный 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().
Параметры
принтер | ||
верх | место для хранения верхнего поля. | [out] |
низ | место для хранения нижнего поля. | [out] |
слева | место для хранения левого поля. | [out] |
справа | место для хранения правого поля. | [out] |
Возвращает
TRUE, если жёсткие поля были получены
С: 2.20
GtkPrinterFunc ()
gboolean (*GtkPrinterFunc) (GtkPrinter *printer,gpointer data);
Тип функции, переданной в gtk_enumerate_printers(). Обратите внимание, что вам нужно сохранить ссылку на printer, если вы хотите сохранить ссылку на неё после возврата функции.
Параметры
принтер | ||
данные | пользовательские данные, переданные в | [closure] |
С: 2.10
gtk_enumerate_printers ()
void gtk_enumerate_printers (GtkPrinterFunc func,gpointer data,GDestroyNotify destroy,gboolean wait);
Вызывает функцию для всех GtkPrinters. Если func возвращает TRUE, перечисление останавливается.
Параметры
func | функция, вызываемая для каждого принтера | |
data | пользовательские данные, передаваемые в | |
destroy | функция, вызываемая, если | |
wait | если |
С: 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 |
| |
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