gtkpapersize

			gtk+ reference manual
top \| description

gtkpapersize — поддержка именованных размеров бумаги

краткое описание

#include <gtk/gtk.h>


            gtkpapersize;
enum        gtkunit;
#define     gtk_paper_name_a3
#define     gtk_paper_name_a4
#define     gtk_paper_name_a5
#define     gtk_paper_name_b5
#define     gtk_paper_name_letter
#define     gtk_paper_name_executive
#define     gtk_paper_name_legal
gtkpapersize* gtk_paper_size_new            (const gchar *name);
gtkpapersize* gtk_paper_size_new_from_ppd   (const gchar *ppd_name,
                                             const gchar *ppd_display_name,
                                             gdouble width,
                                             gdouble height);
gtkpapersize* gtk_paper_size_new_custom     (const gchar *name,
                                             const gchar *display_name,
                                             gdouble width,
                                             gdouble height,
                                             gtkunit unit);
gtkpapersize* gtk_paper_size_copy           (gtkpapersize *other);
void        gtk_paper_size_free             (gtkpapersize *size);
gboolean    gtk_paper_size_is_equal         (gtkpapersize *size1,
                                             gtkpapersize *size2);
const gchar* gtk_paper_size_get_name        (gtkpapersize *size);
const gchar* gtk_paper_size_get_display_name
                                            (gtkpapersize *size);
const gchar* gtk_paper_size_get_ppd_name    (gtkpapersize *size);
gdouble     gtk_paper_size_get_width        (gtkpapersize *size,
                                             gtkunit unit);
gdouble     gtk_paper_size_get_height       (gtkpapersize *size,
                                             gtkunit unit);
gboolean    gtk_paper_size_is_custom        (gtkpapersize *size);
void        gtk_paper_size_set_size         (gtkpapersize *size,
                                             gdouble width,
                                             gdouble height,
                                             gtkunit unit);
gdouble     gtk_paper_size_get_default_top_margin
                                            (gtkpapersize *size,
                                             gtkunit unit);
gdouble     gtk_paper_size_get_default_bottom_margin
                                            (gtkpapersize *size,
                                             gtkunit unit);
gdouble     gtk_paper_size_get_default_left_margin
                                            (gtkpapersize *size,
                                             gtkunit unit);
gdouble     gtk_paper_size_get_default_right_margin
                                            (gtkpapersize *size,
                                             gtkunit unit);
const gchar* gtk_paper_size_get_default     (void);

описание

gtkpapersize обрабатывает размеры бумаги. он использует стандарт "pwg 5101.1-2002 pwg: standard for media standardized names" для имен размеров бумаги (и получения данных размера страниц). в дополнение к стандартному размеру страницы, gtkpapersize позволяет создавать выборочный размер бумаги с произвольными размерами.

gtkpapersize объект сохраняет не только размеры (ширину и высоту) бумаги но и имя размера, он также обеспечивает значение по умолчанию print margins.

печать поддерживается начиная с версии gtk+ 2.10.

детали

gtkpapersize

typedef struct _gtkpapersize gtkpapersize;

enum gtkunit

typedef enum {
  gtk_unit_pixel,
  gtk_unit_points,
  gtk_unit_inch,
  gtk_unit_mm
} gtkunit;

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.

gtk_paper_size_new ()

gtkpapersize* gtk_paper_size_new            (const gchar *name);

создаёт новый объект gtkpapersize анализируя имя бумаги pwg 5101.1-2002 pwg.

если name это null, возвращается размер по умолчанию, смотрите gtk_paper_size_get_default().

`name` :	имя размера бумаги, или `null`
возвращает :	новый 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_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` :	ширина бумаги, в единицах измерения `unit`
`height` :	высота бумаги, в единицах измерения `unit`
`unit` :	единицы измерения для `width` и `height`
возвращает :	новый 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_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_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` :	новая ширина в единицах измерения `unit`
`height` :	новая высота в единицах измерения `unit`
`unit` :	единицы измерения для `width` и `height`

начиная с версии 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);

возвращает имя по умолчанию размера бумаги, которое зависит от текущих настроек локализации (locale).

возвращает :

имя размера бумаги по умолчанию. строкой владеет gtk+ и она не должна изменяться.

начиная с версии 2.10

смотрите также

gtkpagesetup