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

#include <gtk/gtk.h>


            gtkpagesetup;
gtkpagesetup* gtk_page_setup_new            (void);
gtkpagesetup* gtk_page_setup_copy           (gtkpagesetup *other);
gtkpageorientation gtk_page_setup_get_orientation
                                            (gtkpagesetup *setup);
void        gtk_page_setup_set_orientation  (gtkpagesetup *setup,
                                             gtkpageorientation orientation);
gtkpapersize* gtk_page_setup_get_paper_size (gtkpagesetup *setup);
void        gtk_page_setup_set_paper_size   (gtkpagesetup *setup,
                                             gtkpapersize *size);
gdouble     gtk_page_setup_get_top_margin   (gtkpagesetup *setup,
                                             gtkunit unit);
void        gtk_page_setup_set_top_margin   (gtkpagesetup *setup,
                                             gdouble margin,
                                             gtkunit unit);
gdouble     gtk_page_setup_get_bottom_margin
                                            (gtkpagesetup *setup,
                                             gtkunit unit);
void        gtk_page_setup_set_bottom_margin
                                            (gtkpagesetup *setup,
                                             gdouble margin,
                                             gtkunit unit);
gdouble     gtk_page_setup_get_left_margin  (gtkpagesetup *setup,
                                             gtkunit unit);
void        gtk_page_setup_set_left_margin  (gtkpagesetup *setup,
                                             gdouble margin,
                                             gtkunit unit);
gdouble     gtk_page_setup_get_right_margin (gtkpagesetup *setup,
                                             gtkunit unit);
void        gtk_page_setup_set_right_margin (gtkpagesetup *setup,
                                             gdouble margin,
                                             gtkunit unit);
void        gtk_page_setup_set_paper_size_and_default_margins
                                            (gtkpagesetup *setup,
                                             gtkpapersize *size);
gdouble     gtk_page_setup_get_paper_width  (gtkpagesetup *setup,
                                             gtkunit unit);
gdouble     gtk_page_setup_get_paper_height (gtkpagesetup *setup,
                                             gtkunit unit);
gdouble     gtk_page_setup_get_page_width   (gtkpagesetup *setup,
                                             gtkunit unit);
gdouble     gtk_page_setup_get_page_height  (gtkpagesetup *setup,
                                             gtkunit unit);

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

  gobject
   +----gtkpagesetup

описание

gtkpagesetup объект сохраняет размер страницы, ориентацию и границы. идея заключается в том, что вы можете получить один объект из диалога параметров страниц, а затем помещать его в gtkprittntoperation когда печатаете. польза отделения от gtkprintsettings в том, что он влияет только на фактическое выравнивание страницы, и таким образом должен устанавливаться перед печатью.

границы определенные в этом объекте являются "границами печати", то есть часть страницы на которой принтер не будет печатать. это отличается от границ выравнивания которые использует текстовый редактор; они обычно используются для определения минимального размера для границ выравнивания.

определяя gtkpagesetup используйте gtk_page_setup_new() для получения значений по умолчанию, или используйте gtk_print_run_page_setup_dialog() для отображения диалога параметров страницы и получения результирующих параметров страницы.

пример 3. диалог параметров страницы

static gtkprintsettings *settings = null;
static gtkpagesetup *page_setup = null;

static void
do_page_setup (void)
{
  gtkpagesetup *new_page_setup;

  if (settings == null)
    settings = gtk_print_settings_new ();

  new_page_setup = gtk_print_run_page_setup_dialog (gtk_window (main_window),
                                                    page_setup, settings);

  if (page_setup)
    g_object_unref (page_setup);

  page_setup = new_page_setup;
}

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

детали

gtkpagesetup

typedef struct _gtkpagesetup gtkpagesetup;

gtk_page_setup_new ()

gtkpagesetup* gtk_page_setup_new            (void);

создаёт новый gtkpagesetup.

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

gtk_page_setup_copy ()

gtkpagesetup* gtk_page_setup_copy           (gtkpagesetup *other);

копирует gtkpagesetup.

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

gtk_page_setup_get_orientation ()

gtkpageorientation gtk_page_setup_get_orientation
                                            (gtkpagesetup *setup);

определяет ориентацию страницы gtkpagesetup.

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

gtk_page_setup_set_orientation ()

void        gtk_page_setup_set_orientation  (gtkpagesetup *setup,
                                             gtkpageorientation orientation);

устанавливает страничную ориентацию gtkpagesetup.

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

gtk_page_setup_get_paper_size ()

gtkpapersize* gtk_page_setup_get_paper_size (gtkpagesetup *setup);

определяет размер страницы gtkpagesetup.

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

gtk_page_setup_set_paper_size ()

void        gtk_page_setup_set_paper_size   (gtkpagesetup *setup,
                                             gtkpapersize *size);

устанавливает размер страницы gtkpagesetup не изменяя границы. смотрите gtk_page_setup_set_paper_size_and_default_margins().

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

gtk_page_setup_get_top_margin ()

gdouble     gtk_page_setup_get_top_margin   (gtkpagesetup *setup,
                                             gtkunit unit);

определяет верхнюю границу в единицах unit.

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

gtk_page_setup_set_top_margin ()

void        gtk_page_setup_set_top_margin   (gtkpagesetup *setup,
                                             gdouble margin,
                                             gtkunit unit);

устанавливает верхнюю границу gtkpagesetup.

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

gtk_page_setup_get_bottom_margin ()

gdouble     gtk_page_setup_get_bottom_margin
                                            (gtkpagesetup *setup,
                                             gtkunit unit);

определяет нижнюю границу в единицах измерения unit.

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

gtk_page_setup_set_bottom_margin ()

void        gtk_page_setup_set_bottom_margin
                                            (gtkpagesetup *setup,
                                             gdouble margin,
                                             gtkunit unit);

устанавливает нижнюю границу gtkpagesetup.

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

gtk_page_setup_get_left_margin ()

gdouble     gtk_page_setup_get_left_margin  (gtkpagesetup *setup,
                                             gtkunit unit);

определяет левую границу в единицах измерения unit.

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

gtk_page_setup_set_left_margin ()

void        gtk_page_setup_set_left_margin  (gtkpagesetup *setup,
                                             gdouble margin,
                                             gtkunit unit);

устанавливает левую границу gtkpagesetup.

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

gtk_page_setup_get_right_margin ()

gdouble     gtk_page_setup_get_right_margin (gtkpagesetup *setup,
                                             gtkunit unit);

определяет правую границу в единицах измерения unit.

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

gtk_page_setup_set_right_margin ()

void        gtk_page_setup_set_right_margin (gtkpagesetup *setup,
                                             gdouble margin,
                                             gtkunit unit);

устанавливает правую границу gtkpagesetup.

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

gtk_page_setup_set_paper_size_and_default_margins ()

void        gtk_page_setup_set_paper_size_and_default_margins
                                            (gtkpagesetup *setup,
                                             gtkpapersize *size);

устанавливает размер бумаги gtkpagesetup и изменяет границы согласно новому размеру бумаги.

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

gtk_page_setup_get_paper_width ()

gdouble     gtk_page_setup_get_paper_width  (gtkpagesetup *setup,
                                             gtkunit unit);

возвращает размер бумаги в единицах измерения unit.

помните что эта функция рассматривает ориентацию а не границы. смотрите gtk_page_setup_get_page_width().

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

gtk_page_setup_get_paper_height ()

gdouble     gtk_page_setup_get_paper_height (gtkpagesetup *setup,
                                             gtkunit unit);

возвращает высоту бумаги в единицах измерения unit.

помните что эта функция рассматривает ориентацию а не границы. смотрите gtk_page_setup_get_page_height().

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

gtk_page_setup_get_page_width ()

gdouble     gtk_page_setup_get_page_width   (gtkpagesetup *setup,
                                             gtkunit unit);

возвращает ширину страницы в единицах измерения unit.

помните что эта функция рассматривает ориентацию а не границы. смотрите gtk_page_setup_get_paper_width().

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

gtk_page_setup_get_page_height ()

gdouble     gtk_page_setup_get_page_height  (gtkpagesetup *setup,
                                             gtkunit unit);

возвращает высоту страницы в единицах измерения unit.

помните что эта функция рассматривает ориентацию а не границы. смотрите gtk_page_setup_get_paper_height().

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