Spec-Zone.ru › GTK 3.24

GtkПечатьЗадание

GtkPrintJob — Представляет задание печати

Функции

void (*GtkPrintJobCompleteFunc) ()
GtkPrintJob * gtk_print_job_new ()
GtkPrintSettings * gtk_print_job_get_settings ()
GtkPrinter * gtk_print_job_get_printer ()
const gchar * gtk_print_job_get_title ()
GtkPrintStatus gtk_print_job_get_status ()
gboolean gtk_print_job_set_source_fd ()
gboolean gtk_print_job_set_source_file ()
cairo_surface_t * gtk_print_job_get_surface ()
void gtk_print_job_send ()
void gtk_print_job_set_track_print_status ()
gboolean gtk_print_job_get_track_print_status ()
GtkPrintPages gtk_print_job_get_pages ()
void gtk_print_job_set_pages ()
GtkPageRange * gtk_print_job_get_page_ranges ()
void gtk_print_job_set_page_ranges ()
GtkPageSet gtk_print_job_get_page_set ()
void gtk_print_job_set_page_set ()
gint gtk_print_job_get_num_copies ()
void gtk_print_job_set_num_copies ()
gdouble gtk_print_job_get_scale ()
void gtk_print_job_set_scale ()
guint gtk_print_job_get_n_up ()
void gtk_print_job_set_n_up ()
GtkNumberUpLayout gtk_print_job_get_n_up_layout ()
void gtk_print_job_set_n_up_layout ()
gboolean gtk_print_job_get_rotate ()
void gtk_print_job_set_rotate ()
gboolean gtk_print_job_get_collate ()
void gtk_print_job_set_collate ()
gboolean gtk_print_job_get_reverse ()
void gtk_print_job_set_reverse ()

Свойства

GtkPageSetup * page-setup Чтение / Запись / Только для создания
GtkPrinter * printer Чтение / Запись / Только для создания
GtkPrintSettings * settings Чтение / Запись / Только для создания
char * title Чтение / Запись / Только для создания
gboolean track-print-status Чтение / Запись

Сигналы

void status-changed Выполнить последним

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

struct GtkPrintJob

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

    GObject
    ╰── GtkPrintJob

Файлы заголовков

#include <gtk/gtkunixprint.h>

Описание

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

Используйте gtk_print_job_get_surface(), чтобы получить cairo поверхность, на которую нужно нарисовать страницы. Используйте gtk_print_job_send(), чтобы отправить завершённое задание на принтер. Если вы не используете cairo, GtkPrintJob также поддерживает печать вручную сгенерированного PostScript через gtk_print_job_set_source_file().

Функции

GtkPrintJobCompleteFunc ()

void
(*GtkPrintJobCompleteFunc) (GtkPrintJob *print_job,
                            gpointer user_data,
                            const GError *error);

Тип обратного вызова, передаваемого в gtk_print_job_send(). Вызывается, когда задание печати полностью отправлено.

Параметры

print_job

объект GtkPrintJob

user_data

данные пользователя, переданные в gtk_print_job_send()

error

объект GError, содержащий информацию об ошибке, если отправка задания печати завершилась неудачно, в противном случае NULL

gtk_print_job_new ()

GtkPrintJob *
gtk_print_job_new (const gchar *title,
                   GtkPrinter *printer,
                   GtkPrintSettings *settings,
                   GtkPageSetup *page_setup);

Создает новое задание GtkPrintJob.

Параметры

title

заголовок задания

printer

объект GtkPrinter

settings

объект GtkPrintSettings

page_setup

объект GtkPageSetup

Возвращает

новое задание GtkPrintJob

С: 2.10

gtk_print_job_get_settings ()

GtkPrintSettings *
gtk_print_job_get_settings (GtkPrintJob *job);

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

Параметры

job

объект GtkPrintJob

Возвращает

настройки job .

[transfer none]

С: 2.10

gtk_print_job_get_printer ()

GtkPrinter *
gtk_print_job_get_printer (GtkPrintJob *job);

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

Параметры

job

объект GtkPrintJob

Возвращает

принтер job .

[transfer none]

С: 2.10

gtk_print_job_get_title ()

const gchar *
gtk_print_job_get_title (GtkPrintJob *job);

Получает заголовок задания.

Параметры

job

объект GtkPrintJob

Возвращает

заголовок job

С: 2.10

gtk_print_job_get_status ()

GtkPrintStatus
gtk_print_job_get_status (GtkPrintJob *job);

Получает статус задания печати.

Параметры

job

объект GtkPrintJob

Возвращает

статус job

С: 2.10

gtk_print_job_set_source_fd ()

gboolean
gtk_print_job_set_source_fd (GtkPrintJob *job,
                             int fd,
                             GError **error);

Приводит GtkPrintJob к отправке существующего документа в систему печати. Файл может быть в любом формате, поддерживаемом системой печати платформы (обычно PostScript, но на многих платформах может работать и PDF). См. gtk_printer_accepts_pdf() и gtk_printer_accepts_ps().

Аналогично gtk_print_job_set_source_file(), но принимает открытый дескриптор файла вместо имени файла.

Параметры

job

объект GtkPrintJob

fd

дескриптор файла

error

место для возврата ошибок

Возвращает

FALSE при возникновении ошибки

С: 3.22

gtk_print_job_set_source_file ()

gboolean
gtk_print_job_set_source_file (GtkPrintJob *job,
                               const gchar *filename,
                               GError **error);

Приводит GtkPrintJob к отправке существующего документа в систему печати. Файл может быть в любом формате, поддерживаемом системой печати платформы (обычно PostScript, но на многих платформах может работать и PDF). См. gtk_printer_accepts_pdf() и gtk_printer_accepts_ps().

Параметры

job

объект GtkPrintJob

filename

файл для печати.

[type filename]

error

место для возврата ошибок

Возвращает

FALSE при возникновении ошибки

С: 2.10

gtk_print_job_get_surface ()

cairo_surface_t *
gtk_print_job_get_surface (GtkPrintJob *job,
                           GError **error);

Получает поверхность cairo, на которую следует отрисовать страницы задания печати.

Параметры

job

объект GtkPrintJob

error

место для возврата ошибок, или NULL.

[allow-none]

Возвращает

поверхность cairo job .

[transfer none]

С: 2.10

gtk_print_job_send ()

void
gtk_print_job_send (GtkPrintJob *job,
                    GtkPrintJobCompleteFunc callback,
                    gpointer user_data,
                    GDestroyNotify dnotify);

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

Параметры

job

объект GtkPrintJob

callback

функция, вызываемая при завершении задания или возникновении ошибки

user_data

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

dnotify

уведомление о уничтожении для user_data

С: 2.10

gtk_print_job_set_track_print_status ()

void
gtk_print_job_set_track_print_status (GtkPrintJob *job,
                                      gboolean track_status);

Если track_status равно TRUE, задание печати будет пытаться продолжать отслеживать статус выполнения в очередях принтера и на самом принтере. Это позволяет вашему приложению отображать такие сообщения, как «бумага закончилась», и когда задание печати действительно доходит до принтера.

Эта функция часто реализуется с помощью опроса, поэтому её не следует включать, если это не нужно.

Параметры

job

объект GtkPrintJob

track_status

TRUE отслеживания статуса после печати

С: 2.10

gtk_print_job_get_track_print_status ()

gboolean
gtk_print_job_get_track_print_status (GtkPrintJob *job);

Возвращает, будет ли отслеживаться статус задания после печати. Подробности см. в gtk_print_job_set_track_print_status().

Параметры

job

объект GtkPrintJob

Возвращает

TRUE если статус задания печати будет сообщаться после печати

С: 2.10

gtk_print_job_get_pages ()

GtkPrintPages
gtk_print_job_get_pages (GtkPrintJob *job);

Получает значение GtkPrintPages для этого задания.

Параметры

job

объект GtkPrintJob

Возвращает

значение GtkPrintPages

С: 3.0

gtk_print_job_set_pages ()

void
gtk_print_job_set_pages (GtkPrintJob *job,
                         GtkPrintPages pages);

Устанавливает значение GtkPrintPages для этого задания.

Параметры

job

объект GtkPrintJob

pages

значение GtkPrintPages

С: 3.0

gtk_print_job_get_page_ranges ()

GtkPageRange *
gtk_print_job_get_page_ranges (GtkPrintJob *job,
                               gint *n_ranges);

Получает диапазоны страниц для данного задания.

Параметры

job

объект GtkPrintJob

n_ranges

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

[out]

Возвращает

указатель на массив структур GtkPageRange.

[array length=n_ranges][transfer none]

С: 3.0

gtk_print_job_set_page_ranges ()

void
gtk_print_job_set_page_ranges (GtkPrintJob *job,
                               GtkPageRange *ranges,
                               gint n_ranges);

Устанавливает диапазоны страниц для данного задания.

Параметры

job

объект GtkPrintJob

ranges

указатель на массив структур GtkPageRange.

[array length=n_ranges][transfer full]

n_ranges

длина массива ranges

С: 3.0

gtk_print_job_get_page_set ()

GtkPageSet
gtk_print_job_get_page_set (GtkPrintJob *job);

Получает значение GtkPageSet для данного задания.

Параметры

job

объект GtkPrintJob

Возвращает

значение GtkPageSet

С: 3.0

gtk_print_job_set_page_set ()

void
gtk_print_job_set_page_set (GtkPrintJob *job,
                            GtkPageSet page_set);

Устанавливает значение GtkPageSet для данного задания.

Параметры

job

объект GtkPrintJob

page_set

значение GtkPageSet

С: 3.0

gtk_print_job_get_num_copies ()

gint
gtk_print_job_get_num_copies (GtkPrintJob *job);

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

Параметры

job

объект GtkPrintJob

Возвращает

количество копий

С: 3.0

gtk_print_job_set_num_copies ()

void
gtk_print_job_set_num_copies (GtkPrintJob *job,
                              gint num_copies);

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

Параметры

job

объект GtkPrintJob

num_copies

количество копий

С: 3.0

gtk_print_job_get_scale ()

gdouble
gtk_print_job_get_scale (GtkPrintJob *job);

Получает масштаб для этого задания (где 1.0 означает без масштабирования).

Параметры

job

a GtkPrintJob

Возвращает

масштаб

С версии: 3.0

gtk_print_job_set_scale ()

void
gtk_print_job_set_scale (GtkPrintJob *job,
                         gdouble scale);

Устанавливает масштаб для этого задания (где 1.0 означает без масштабирования).

Параметры

job

a GtkPrintJob

scale

масштаб

С версии: 3.0

gtk_print_job_get_n_up ()

guint
gtk_print_job_get_n_up (GtkPrintJob *job);

Получает значение n-up для этого задания.

Параметры

job

a GtkPrintJob

Возвращает

значение n-up

С версии: 3.0

gtk_print_job_set_n_up ()

void
gtk_print_job_set_n_up (GtkPrintJob *job,
                        guint n_up);

Устанавливает значение n-up для этого задания.

Параметры

job

a GtkPrintJob

n_up

значение n-up

С версии: 3.0

gtk_print_job_get_n_up_layout ()

GtkNumberUpLayout
gtk_print_job_get_n_up_layout (GtkPrintJob *job);

Получает значение n-up layout для этого задания.

Параметры

job

a GtkPrintJob

Возвращает

значение n-up layout

С версии: 3.0

gtk_print_job_set_n_up_layout ()

void
gtk_print_job_set_n_up_layout (GtkPrintJob *job,
                               GtkNumberUpLayout layout);

Устанавливает значение n-up layout для этого задания.

Параметры

job

a GtkPrintJob

layout

значение n-up layout

С версии: 3.0

gtk_print_job_get_rotate ()

gboolean
gtk_print_job_get_rotate (GtkPrintJob *job);

Получает информацию о том, будет ли задание печататься в повороте.

Параметры

job

a GtkPrintJob

Возвращает

будет ли задание печататься в повороте

С версии: 3.0

gtk_print_job_set_rotate ()

void
gtk_print_job_set_rotate (GtkPrintJob *job,
                          gboolean rotate);

Устанавливает, будет ли это задание печататься в повороте.

Параметры

job

a GtkPrintJob

rotate

будет ли печататься в повороте

С версии: 3.0

gtk_print_job_get_collate ()

gboolean
gtk_print_job_get_collate (GtkPrintJob *job);

Получает информацию о том, будет ли задание печататься сфальцованным.

Параметры

job

a GtkPrintJob

Возвращает

будет ли задание печататься сфальцованным

С версии: 3.0

gtk_print_job_set_collate ()

void
gtk_print_job_set_collate (GtkPrintJob *job,
                           gboolean collate);

Устанавливает, будет ли задание печататься сфальцованным.

Параметры

job

a GtkPrintJob

collate

будет ли задание печататься сфальцованным

С версии: 3.0

gtk_print_job_get_reverse ()

gboolean
gtk_print_job_get_reverse (GtkPrintJob *job);

Получает информацию о том, будет ли задание печататься в обратном порядке.

Параметры

job

a GtkPrintJob

Возвращает

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

С версии: 3.0

gtk_print_job_set_reverse ()

void
gtk_print_job_set_reverse (GtkPrintJob *job,
                           gboolean reverse);

Устанавливает, будет ли задание печататься в обратном порядке.

Параметры

job

a GtkPrintJob

reverse

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

С версии: 3.0

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

struct GtkPrintJob

struct GtkPrintJob;

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

Свойство “page-setup”

  “page-setup”               GtkPageSetup *

Настройка страницы.

Владелец: GtkPrintJob

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

Свойство “printer”

  “printer”                  GtkPrinter *

Принтер, на который будет напечатано задание.

Владелец: GtkPrintJob

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

Свойство “settings”

  “settings”                 GtkPrintSettings *

Настройки принтера.

Владелец: GtkPrintJob

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

Свойство “title”

  “title”                    char *

Заголовок задания печати.

Владелец: GtkPrintJob

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

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

Свойство “track-print-status”

  “track-print-status”       gboolean

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

Владелец: GtkPrintJob

Флаги: Чтение / Запись

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

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

Сигнал “status-changed”

void
user_function (GtkPrintJob *job,
               gpointer     user_data)

Издаётся, когда изменяется статус задания. Обработчик сигнала может использовать gtk_print_job_get_status(), чтобы получить новый статус.

Параметры

задание

объект GtkPrintJob, на котором был издан сигнал

user_data

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

Флаги: Выполнить в последнюю очередь

С версии: 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.24/GtkPrintJob.html

Spec-Zone.ru

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