GtkPaperSize
GtkPaperSize — Поддержка именованных размеров бумаги
Функции
Типы и значения
| GtkPaperSize | |
| перечисление | GtkUnit |
| #определить | GTK_UNIT_PIXEL |
| #определить | GTK_PAPER_NAME_A3 |
| #определить | GTK_PAPER_NAME_A4 |
| #определить | GTK_PAPER_NAME_A5 |
| #определить | GTK_PAPER_NAME_B5 |
| #определить | GTK_PAPER_NAME_LETTER |
| #определить | GTK_PAPER_NAME_EXECUTIVE |
| #определить | GTK_PAPER_NAME_LEGAL |
Иерархия объектов
GBoxed ╰── GtkPaperSize
Включаемые файлы
#include <gtk/gtk.h>
Описание
GtkPaperSize обрабатывает размеры бумаги. Она использует стандарт, называемый PWG 5101.1-2002 PWG: Стандарт для именованных стандартизированных типов носителей, для именования размеров бумаги (и для получения данных о размерах страниц). В дополнение к стандартным размерам бумаги, GtkPaperSize позволяет создавать пользовательские размеры бумаги с произвольными размерами.
Объект GtkPaperSize хранит не только размеры (ширину и высоту) размера бумаги и его имя, но также предоставляет значения по умолчанию для полей печати.
Поддержка печати была добавлена в GTK+ 2.10.
Функции
gtk_paper_size_new ()
GtkPaperSize *
gtk_paper_size_new (const gchar *name); Создаёт новый объект GtkPaperSize, проанализировав имя формата бумаги PWG 5101.1-2002.
Если name имеет значение NULL, возвращается размер бумаги по умолчанию, см. gtk_paper_size_get_default().
Параметры
name | имя формата бумаги или | [allow-none] |
Возвращаемое значение
новый объект GtkPaperSize, используйте gtk_paper_size_free() для освобождения памяти
С версии: 2.10
gtk_paper_size_new_from_ppd ()
GtkPaperSize * gtk_paper_size_new_from_ppd (const gchar *ppd_name,const gchar *ppd_display_name,gdouble width,gdouble height);
Создаёт новый объект GtkPaperSize используя информацию из PPD.
Если ppd_name не является распознанным именем формата бумаги из PPD, используются ppd_display_name, width и height для создания пользовательского объекта GtkPaperSize.
Параметры
ppd_name | имя формата бумаги из PPD | |
ppd_display_name | соответствующее удобочитаемое имя | |
width | ширина бумаги в пунктах | |
height | высота бумаги в пунктах |
Возвращаемое значение
новый объект GtkPaperSize, используйте gtk_paper_size_free() для освобождения памяти
С версии: 2.10
gtk_paper_size_new_from_ipp ()
GtkPaperSize * gtk_paper_size_new_from_ipp (const gchar *ipp_name,gdouble width,gdouble height);
Создаёт новый объект GtkPaperSize используя информацию из IPP.
Если ipp_name не является распознанным именем формата бумаги, используются width и height для создания пользовательского объекта GtkPaperSize.
Параметры
ipp_name | имя формата бумаги из IPP | |
width | ширина бумаги в пунктах | |
height | высота бумаги в пунктах |
Возвращаемое значение
новый объект GtkPaperSize, используйте gtk_paper_size_free() для освобождения памяти
С версии: 3.16
gtk_paper_size_new_custom ()
GtkPaperSize * gtk_paper_size_new_custom (const gchar *name,const gchar *display_name,gdouble width,gdouble height,GtkUnit unit);
Создаёт новый объект GtkPaperSize с заданными параметрами.
Параметры
name | имя формата бумаги | |
display_name | удобочитаемое имя | |
width | ширина бумаги в единицах | |
height | высота бумаги в единицах | |
unit | единица измерения для |
Возвращаемое значение
новый объект GtkPaperSize, используйте gtk_paper_size_free() для освобождения памяти
С версии: 2.10
gtk_paper_size_copy ()
GtkPaperSize *
gtk_paper_size_copy (GtkPaperSize *other); Копирует существующий объект GtkPaperSize.
Параметры
other | объект GtkPaperSize |
Возвращаемое значение
копия other
С версии: 2.10
gtk_paper_size_free ()
void
gtk_paper_size_free (GtkPaperSize *size); Освобождает память, выделенную для объекта GtkPaperSize.
Параметры
size | объект GtkPaperSize |
С версии: 2.10
gtk_paper_size_is_equal ()
gboolean gtk_paper_size_is_equal (GtkPaperSize *size1,GtkPaperSize *size2);
Сравнивает два объекта GtkPaperSize.
Параметры
size1 | объект GtkPaperSize | |
size2 | другой объект GtkPaperSize |
Возвращаемое значение
TRUE, если size1 и size2 представляют один и тот же размер бумаги
С версии: 2.10
gtk_paper_size_get_paper_sizes ()
GList * gtk_paper_size_get_paper_sizes (gboolean include_custom);
Создаёт список известных форматов бумаги.
Параметры
include_custom | включать ли пользовательские форматы бумаги, определённые в диалоге настройки страницы |
Возвращаемое значение
список объектов GtkPaperSize, каждый из которых выделен в памяти.
[element-type GtkPaperSize][transfer full]
С версии: 2.12
gtk_paper_size_get_name ()
const gchar *
gtk_paper_size_get_name (GtkPaperSize *size); Получает имя формата бумаги GtkPaperSize.
Параметры
size | объект GtkPaperSize |
Возвращаемое значение
имя формата бумаги size
С версии: 2.10
gtk_paper_size_get_display_name ()
const gchar *
gtk_paper_size_get_display_name (GtkPaperSize *size); Получает удобочитаемое имя GtkPaperSize.
Параметры
size | объект GtkPaperSize |
Возвращает
удобочитаемое имя size
С версии: 2.10
gtk_paper_size_get_ppd_name ()
const gchar *
gtk_paper_size_get_ppd_name (GtkPaperSize *size); Получает имя PPD GtkPaperSize, которое может быть NULL.
Параметры
size | объект GtkPaperSize |
Возвращает
имя PPD size
С версии: 2.10
gtk_paper_size_get_width ()
gdouble gtk_paper_size_get_width (GtkPaperSize *size,GtkUnit unit);
Получает ширину бумаги GtkPaperSize в единицах unit.
Параметры
size | объект GtkPaperSize | |
unit | единица измерения возвращаемого значения, не |
Возвращает
ширину бумаги
С версии: 2.10
gtk_paper_size_get_height ()
gdouble gtk_paper_size_get_height (GtkPaperSize *size,GtkUnit unit);
Получает высоту бумаги GtkPaperSize в единицах unit.
Параметры
size | объект GtkPaperSize | |
unit | единица измерения возвращаемого значения, не |
Возвращает
высоту бумаги
С версии: 2.10
gtk_paper_size_is_ipp ()
gboolean
gtk_paper_size_is_ipp (GtkPaperSize *size); Возвращает TRUE, если size стандартный размер бумаги IPP.
Параметры
size | объект GtkPaperSize |
Возвращает
является ли size не пользовательским размером бумаги IPP.
gtk_paper_size_is_custom ()
gboolean
gtk_paper_size_is_custom (GtkPaperSize *size); Возвращает TRUE, если size не стандартный размер бумаги.
Параметры
size | объект GtkPaperSize |
Возвращает
является ли size пользовательским размером бумаги.
gtk_paper_size_set_size ()
void gtk_paper_size_set_size (GtkPaperSize *size,gdouble width,gdouble height,GtkUnit unit);
Изменяет размеры size на width x height.
Параметры
size | пользовательский объект GtkPaperSize | |
width | новая ширина в единицах | |
height | новая высота в единицах | |
unit | единица измерения для |
С версии: 2.10
gtk_paper_size_get_default_top_margin ()
gdouble gtk_paper_size_get_default_top_margin (GtkPaperSize *size,GtkUnit unit);
Получает значение по умолчанию верхнего отступа GtkPaperSize.
Параметры
size | объект GtkPaperSize | |
unit | единица измерения возвращаемого значения, не |
Возвращает
значение по умолчанию верхнего отступа
С версии: 2.10
gtk_paper_size_get_default_bottom_margin ()
gdouble gtk_paper_size_get_default_bottom_margin (GtkPaperSize *size,GtkUnit unit);
Получает значение по умолчанию нижнего отступа GtkPaperSize.
Параметры
size | объект GtkPaperSize | |
unit | единица измерения возвращаемого значения, не |
Возвращает
значение по умолчанию нижнего отступа
С версии: 2.10
gtk_paper_size_get_default_left_margin ()
gdouble gtk_paper_size_get_default_left_margin (GtkPaperSize *size,GtkUnit unit);
Получает значение по умолчанию левого отступа GtkPaperSize.
Параметры
size | объект GtkPaperSize | |
unit | единица измерения возвращаемого значения, не |
Возвращает
значение по умолчанию левого отступа
С версии: 2.10
gtk_paper_size_get_default_right_margin ()
gdouble gtk_paper_size_get_default_right_margin (GtkPaperSize *size,GtkUnit unit);
Получает значение по умолчанию правого отступа GtkPaperSize.
Параметры
size | объект GtkPaperSize | |
unit | единица измерения возвращаемого значения, не |
Возвращает
значение по умолчанию правого отступа
С версии: 2.10
gtk_paper_size_get_default ()
const gchar * gtk_paper_size_get_default (void);
Возвращает имя размера бумаги по умолчанию, которое зависит от текущего локали.
Возвращает
имя размера бумаги по умолчанию. Строка принадлежит GTK+ и не должна изменяться.
С версии: 2.10
gtk_paper_size_new_from_key_file ()
GtkPaperSize * gtk_paper_size_new_from_key_file (GKeyFile *key_file,const gchar *group_name,GError **error);
Считывает размер бумаги из группы group_name в файле ключей key_file .
Параметры
key_file | the GKeyFile для извлечения размера бумаги | |
group_name | имя группы в файле ключей для чтения, или | [nullable] |
error | место для возврата ошибки, или | [allow-none] |
Возвращаемое значение
новый объект GtkPaperSize с восстановленным размером бумаги, или NULL в случае ошибки
С: 2.12
gtk_paper_size_new_from_gvariant ()
GtkPaperSize *
gtk_paper_size_new_from_gvariant (GVariant *variant); Десериализация размера бумаги из переменной a{sv} в формате, созданном функцией gtk_paper_size_to_gvariant().
Параметры
variant | a{sv} GVariant |
С: 3.22
gtk_paper_size_to_key_file ()
void gtk_paper_size_to_key_file (GtkPaperSize *size,GKeyFile *key_file,const gchar *group_name);
Эта функция добавляет размер бумаги из size в key_file .
Параметры
size | ||
key_file | the GKeyFile для сохранения размера бумаги | |
group_name | группа для добавления настроек в |
С: 2.12
gtk_paper_size_to_gvariant ()
GVariant *
gtk_paper_size_to_gvariant (GtkPaperSize *paper_size); Сериализация размера бумаги в переменную a{sv}.
Параметры
paper_size |
Возвращаемое значение
новая плавающая GVariant.
[transfer none]
С: 3.22
Типы и значения
GtkPaperSize
typedef struct _GtkPaperSize GtkPaperSize;
перечисление GtkUnit
См. также gtk_print_settings_set_paper_width().
Члены
GTK_UNIT_NONE | Нет единиц. | |
GTK_UNIT_POINTS | Размеры в пунктах. | |
GTK_UNIT_INCH | Размеры в дюймах. | |
GTK_UNIT_MM | Размеры в миллиметрах |
GTK_UNIT_PIXEL
#define GTK_UNIT_PIXEL GTK_UNIT_NONE
GTK_PAPER_NAME_A3
#define GTK_PAPER_NAME_A3 "iso_a3"
Название размера бумаги A3.
GTK_PAPER_NAME_A4
#define GTK_PAPER_NAME_A4 "iso_a4"
Название размера бумаги A4.
GTK_PAPER_NAME_A5
#define GTK_PAPER_NAME_A5 "iso_a5"
Название размера бумаги A5.
GTK_PAPER_NAME_B5
#define GTK_PAPER_NAME_B5 "iso_b5"
Название размера бумаги B5.
GTK_PAPER_NAME_LETTER
#define GTK_PAPER_NAME_LETTER "na_letter"
Название размера бумаги Letter.
GTK_PAPER_NAME_EXECUTIVE
#define GTK_PAPER_NAME_EXECUTIVE "na_executive"
Название размера бумаги Executive.
GTK_PAPER_NAME_LEGAL
#define GTK_PAPER_NAME_LEGAL "na_legal"
Название размера бумаги Legal.
См. также
© 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/GtkPaperSize.html