gtkassistant

			gtk+ reference manual
top \| description \| object hierarchy \| child properties \| style properties \| signals

gtkassistant — виджет проводящий пользователя через многошаговые операции

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

#include <gtk/gtk.h>


            gtkassistant;
gtkwidget*  gtk_assistant_new               (void);
gint        gtk_assistant_get_current_page  (gtkassistant *assistant);
void        gtk_assistant_set_current_page  (gtkassistant *assistant,
                                             gint page_num);

gint        gtk_assistant_get_n_pages       (gtkassistant *assistant);
gtkwidget*  gtk_assistant_get_nth_page      (gtkassistant *assistant,
                                             gint page_num);

gint        gtk_assistant_prepend_page      (gtkassistant *assistant,
                                             gtkwidget *page);
gint        gtk_assistant_append_page       (gtkassistant *assistant,
                                             gtkwidget *page);

gint        gtk_assistant_insert_page       (gtkassistant *assistant,
                                             gtkwidget *page,
                                             gint position);
gint        (*gtkassistantpagefunc)         (gint current_page,
                                             gpointer data);
void        gtk_assistant_set_forward_page_func

                                            (gtkassistant *assistant,
                                             gtkassistantpagefunc page_func,
                                             gpointer data,
                                             gdestroynotify destroy);
enum        gtkassistantpagetype;
void        gtk_assistant_set_page_type     (gtkassistant *assistant,
                                             gtkwidget *page,
                                             gtkassistantpagetype type);

gtkassistantpagetype gtk_assistant_get_page_type
                                            (gtkassistant *assistant,
                                             gtkwidget *page);
void        gtk_assistant_set_page_title    (gtkassistant *assistant,
                                             gtkwidget *page,
                                             const gchar *title);
const gchar* gtk_assistant_get_page_title   (gtkassistant *assistant,
                                             gtkwidget *page);
void        gtk_assistant_set_page_header_image

                                            (gtkassistant *assistant,
                                             gtkwidget *page,
                                             gdkpixbuf *pixbuf);
gdkpixbuf*  gtk_assistant_get_page_header_image
                                            (gtkassistant *assistant,
                                             gtkwidget *page);
void        gtk_assistant_set_page_side_image

                                            (gtkassistant *assistant,
                                             gtkwidget *page,
                                             gdkpixbuf *pixbuf);
gdkpixbuf*  gtk_assistant_get_page_side_image
                                            (gtkassistant *assistant,
                                             gtkwidget *page);
void        gtk_assistant_set_page_complete (gtkassistant *assistant,
                                             gtkwidget *page,
                                             gboolean complete);

gboolean    gtk_assistant_get_page_complete (gtkassistant *assistant,
                                             gtkwidget *page);
void        gtk_assistant_add_action_widget (gtkassistant *assistant,
                                             gtkwidget *child);
void        gtk_assistant_remove_action_widget

                                            (gtkassistant *assistant,
                                             gtkwidget *child);
void        gtk_assistant_update_buttons_state
                                            (gtkassistant *assistant);

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

  gobject
   +----ginitiallyunowned
         +----gtkobject
               +----gtkwidget

                     +----gtkcontainer
                           +----gtkbin
                                 +----gtkwindow
                                       +----gtkassistant

осуществляемые интерфейсы

gtkassistant осуществляет atkimplementoriface.

дочерние свойства

  "complete"             gboolean              : read / write
  "header-image"         gdkpixbuf             : read / write
  "page-type"            gtkassistantpagetype  : read / write
  "sidebar-image"        gdkpixbuf             : read / write
  "title"                gchararray            : read / write

свойства стиля

  "content-padding"      gint                  : read
  "header-padding"       gint                  : read

сигналы

"apply"     void        user_function      (gtkassistant *assistant,
                                            gpointer      user_data)      : run last
"cancel"    void        user_function      (gtkassistant *assistant,
                                            gpointer      user_data)      : run last
"close"     void        user_function      (gtkassistant *assistant,
                                            gpointer      user_data)      : run last
"prepare"   void        user_function      (gtkassistant *assistant,
                                            gtkwidget    *page,
                                            gpointer      user_data)      : run last

описание

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

детали

gtkassistant

typedef struct _gtkassistant gtkassistant;

gtk_assistant_new ()

gtkwidget*  gtk_assistant_new               (void);

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

возвращает:

вновь созданный gtkassistant

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

gtk_assistant_get_current_page ()

gint        gtk_assistant_get_current_page  (gtkassistant *assistant);

возвращает номер текущемй страницы

`assistant` :	gtkassistant
возвращает:	перечень (начиная с 0) текущих страниц в `assistant`, если `assistant` не имеет страниц, то возвращается -1

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

gtk_assistant_set_current_page ()

void        gtk_assistant_set_current_page  (gtkassistant *assistant,
                                             gint page_num);

переключает страницу в page_num. помните это необходимо только в выборе кнопок, поскольку assistant может быть установлен с помощью gtk_assistant_set_forward_page_func().

`assistant` :	gtkassistant
`page_num` :	перечень переключаемых страниц, начинается с 0. если отрицательное, используется последняя страница. если большее чем количество страниц в `assistant`, ничего не произойдет.

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

gtk_assistant_get_n_pages ()

gint        gtk_assistant_get_n_pages       (gtkassistant *assistant);

возвращает количество страниц в assistant

`assistant` :	gtkassistant
возвращает:	количество страниц в `assistant`.

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

gtk_assistant_get_nth_page ()

gtkwidget*  gtk_assistant_get_nth_page      (gtkassistant *assistant,
                                             gint page_num);

возвращает дочерний виджет содержащийся в странице под номером page_num.

`assistant` :	gtkassistant
`page_num` :	перечень страниц в `assistant`, или -1 для получения последней;
возвращает:	дочерний виджет, или `null` если `page_num` выходит за предел.

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

gtk_assistant_prepend_page ()

gint        gtk_assistant_prepend_page      (gtkassistant *assistant,
                                             gtkwidget *page);

добавляет страницу в начало assistant.

`assistant` :	gtkassistant
`page` :	gtkwidget
возвращает:	перечень (начинается с 0) вставляемых страниц

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

gtk_assistant_append_page ()

gint        gtk_assistant_append_page       (gtkassistant *assistant,
                                             gtkwidget *page);

добавляет страницу в конец assistant.

`assistant` :	gtkassistant
`page` :	gtkwidget
возвращает:	перечень (начинается с 0) вставляемых страниц

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

gtk_assistant_insert_page ()

gint        gtk_assistant_insert_page       (gtkassistant *assistant,
                                             gtkwidget *page,
                                             gint position);

вставляет страницу в assistant в данной позиции.

`assistant` :	gtkassistant
`page` :	gtkwidget
`position` :	позиция (начиная с 0) в которую вставляется страница, или -1 для вставки в конец `assistant`
возвращает:	позицию (начиная с 0) вставленной страницы

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

gtkassistantpagefunc ()

gint        (*gtkassistantpagefunc)         (gint current_page,
                                             gpointer data);

функция используемая gtk_assistant_set_forward_page_func() чтобы знать какая страница является текущемй для вычисления следующей за ней. она вызывается и для того чтобы вычислить следующую страницу когда пользователь нажал на кнопку "forward" и для обработки поведения кнопки "last".

`current_page` :	номер страницы используемый для вычисления следующей страницы.
`data` :	пользовательские данные.
возвращает:	номер следующей страницы.

gtk_assistant_set_forward_page_func ()

void        gtk_assistant_set_forward_page_func
                                            (gtkassistant *assistant,
                                             gtkassistantpagefunc page_func,
                                             gpointer data,
                                             gdestroynotify destroy);

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

`assistant` :	gtkassistant
`page_func` :	gtkassistantpagefunc, или `null` для использования значения по умолчанию
`data` :	пользовательские данные для `page_func`
`destroy` :	уведомление закрытия для `data`

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

перечисление gtkassistantpagetype

typedef enum
{
  gtk_assistant_page_content,
  gtk_assistant_page_intro,
  gtk_assistant_page_confirm,
  gtk_assistant_page_summary,
  gtk_assistant_page_progress
} gtkassistantpagetype;

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

помните что помощник должен заканчивать поток страниц страницей типа gtk_assistant_page_confirm или gtk_assistant_page_summary для корректности.

`gtk_assistant_page_content`	страница с обычным содержимым.
`gtk_assistant_page_intro`	страница содержит введение в помощник.
`gtk_assistant_page_confirm`	страница позволяет пользователю подтверждать или отменять изменения.
`gtk_assistant_page_summary`	страница информирующая пользователя о принятых изменениях.
`gtk_assistant_page_progress`	используется для больших задач требующих много времени для выполнения, блокирует помощник до полного выполнения заполнения страницы.

gtk_assistant_set_page_type ()

void        gtk_assistant_set_page_type     (gtkassistant *assistant,
                                             gtkwidget *page,
                                             gtkassistantpagetype type);

устанавливает тип страницы для page. тип страницы определяет поведение страниц в assistant.

`assistant` :	gtkassistant
`page` :	страница в `assitant`
`type` :	новый тип для `page`

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

gtk_assistant_get_page_type ()

gtkassistantpagetype gtk_assistant_get_page_type
                                            (gtkassistant *assistant,
                                             gtkwidget *page);

выдаёт тип страницы page.

`assistant` :	gtkassistant
`page` :	страница в `assistant`
возвращает:	тип страницы `page`.

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

gtk_assistant_set_page_title ()

void        gtk_assistant_set_page_title    (gtkassistant *assistant,
                                             gtkwidget *page,
                                             const gchar *title);

устанавливает заголовок для page. заголовок отображается в заголовочной области помощника когда page является текущемй страницей.

`assistant` :	gtkassistant
`page` :	страница в `assitant`
`title` :	новый заголовок для `page`

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

gtk_assistant_get_page_title ()

const gchar* gtk_assistant_get_page_title   (gtkassistant *assistant,
                                             gtkwidget *page);

получает заголовок для page.

`assistant` :	gtkassistant
`page` :	страница в `assistant`
возвращает:	заголовок для `page`.

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

gtk_assistant_set_page_header_image ()

void        gtk_assistant_set_page_header_image
                                            (gtkassistant *assistant,
                                             gtkwidget *page,
                                             gdkpixbuf *pixbuf);

устанавливает изображение заголовка для page. это изображение отображается в заголовочной области помощника когда page является текущемй страницей.

`assistant` :	gtkassistant
`page` :	страница в `assitant`
`pixbuf` :	новое заголовочное изображение `page`

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

gtk_assistant_get_page_header_image ()

gdkpixbuf*  gtk_assistant_get_page_header_image
                                            (gtkassistant *assistant,
                                             gtkwidget *page);

получает заголовочное изображение для page.

`assistant` :	gtkassistant
`page` :	страница в `assistant`
возвращает:	заголовочное изображение для `page`, или `null` если нет изображения для данной страницы.

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

gtk_assistant_set_page_side_image ()

void        gtk_assistant_set_page_side_image
                                            (gtkassistant *assistant,
                                             gtkwidget *page,
                                             gdkpixbuf *pixbuf);

устанавливает боковое изображение для page. это изображение отображается в боковой области помощника когда page является текущемй страницей.

`assistant` :	gtkassistant
`page` :	страница в `assitant`
`pixbuf` :	новое заголовочное изображение `page`

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

gtk_assistant_get_page_side_image ()

gdkpixbuf*  gtk_assistant_get_page_side_image
                                            (gtkassistant *assistant,
                                             gtkwidget *page);

получает заголовочное изображение для page.

`assistant` :	gtkassistant
`page` :	страница в `assistant`
возвращает:	боковое изображение для `page`, или `null` если у страницы нет бокового изображения.

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

gtk_assistant_set_page_complete ()

void        gtk_assistant_set_page_complete (gtkassistant *assistant,
                                             gtkwidget *page,
                                             gboolean complete);

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

`assistant` :	gtkassistant
`page` :	страница в `assitant`
`complete` :	статус заполнения страницы

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

gtk_assistant_get_page_complete ()

gboolean    gtk_assistant_get_page_complete (gtkassistant *assistant,
                                             gtkwidget *page);

определяет заполнена ли page.

`assistant` :	gtkassistant
`page` :	страница в `assistant`
возвращает:	`true` если `page` заполнена.

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

gtk_assistant_add_action_widget ()

void        gtk_assistant_add_action_widget (gtkassistant *assistant,
                                             gtkwidget *child);

добавляет виджет в область действия в gtkassistant.

`assistant` :	gtkassistant
`child` :	gtkwidget

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

gtk_assistant_remove_action_widget ()

void        gtk_assistant_remove_action_widget
                                            (gtkassistant *assistant,
                                             gtkwidget *child);

удаляет виджет из области действия в gtkassistant.

`assistant` :	gtkassistant
`child` :	gtkwidget

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

gtk_assistant_update_buttons_state ()

void        gtk_assistant_update_buttons_state
                                            (gtkassistant *assistant);

заставляет assistant пересчитать состояние кнопок.

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

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

assistant :

gtkassistant

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

детали дочерних свойств

дочернее свойство "`complete`"

  "complete"             gboolean              : read / write

устанавливает дочернее свойство "complete" в true маркируя страницу как заполненную (например: все запрашиваемые поля заполнены). gtk+ использует эту информацию для контроля чувствительности кнопок навигации.

значение по умолчанию: false

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

дочернее свойство "`header-image`"

  "header-image"         gdkpixbuf             : read / write

изображение показываемое рядом со страницей.

установите в null для скрытия боковой панели.

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

дочернее свойство "`page-type`"

  "page-type"            gtkassistantpagetype  : read / write

тип страницы помощника.

значение по умолчанию: gtk_assistant_page_content

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

дочернее свойство "`sidebar-image`"

  "sidebar-image"        gdkpixbuf             : read / write

боковое изображение для страницы помощника.

дочернее свойство "`title`"

  "title"                gchararray            : read / write

заголовок отображаемый в заголовке страницы.

если заголовок и заголовочное изображение оба равны null, заголовок не отображается.

значение по умолчанию: null

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

детали свойств стиля

свойство стиля "`content-padding`"

  "content-padding"      gint                  : read

количество пикселей вокруг содержимого страниц.

допустимые значения: >= 0

значение по умолчанию: 1

свойство стиля "`header-padding`"

  "header-padding"       gint                  : read

количество пикселей вокруг заголовка.

допустимые значения: >= 0

значение по умолчанию: 6

детали сигнала

сигнал "apply"

void        user_function                  (gtkassistant *assistant,
                                            gpointer      user_data)      : run last

сигнал ::apply издаётся когда нажата кнопка «применить». поведение по умолчанию gtkassistant – переключение на следующую страницу, если текущая страница не последняя.

обработчик для сигнала ::apply должен выполнить действия для которых мастер собрал данные. если действие занимает много времени для выполнения, вы могли бы учесть помещение страницы типа gtk_assistant_page_progress после подтверждённой страницы и обработать эту операцию в течении сигнала "prepare" страницы прогресса.

`assistant` :	`gtkassistant`
`user_data` :	пользовательские данные установленные когда подключается обработчик сигнала.

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

сигнал "cancel"

void        user_function                  (gtkassistant *assistant,
                                            gpointer      user_data)      : run last

сигнал ::cancel издаётся когда нажимается кнопка cancel.

`assistant` :	gtkassistant
`user_data` :	пользовательские данные устанавливаемые при подключении обработчика сигнала.

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

сигнал "close"

void        user_function                  (gtkassistant *assistant,
                                            gpointer      user_data)      : run last

сигнал ::close издается либо когда нажата кнопка итоговой страницы, или когда нажата кнопка apply в последней странице потока (тип gtk_assistant_page_confirm).

`assistant` :	gtkassistant
`user_data` :	пользовательские данные устанавливаемые при подключении обработчика сигнала..

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

сигнал "prepare"

void        user_function                  (gtkassistant *assistant,
                                            gtkwidget    *page,
                                            gpointer      user_data)      : run last

сигнал ::prepared издаётся когда новая страница устанавливается как текущая страница помощника, после создания видимой новой страницы. обработчик для этого сигнала может выполнить любую подготовку необходимую перед отображением page.

`assistant` :	gtkassistant
`page` :	текущая страница
`user_data` :	пользовательские данные устанавливаемые при подключении обработчика сигнала.

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

gtkassistant

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

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

осуществляемые интерфейсы

дочерние свойства

свойства стиля

сигналы

описание

детали

gtkassistant

gtk_assistant_new ()

gtk_assistant_get_current_page ()

gtk_assistant_set_current_page ()

gtk_assistant_get_n_pages ()

gtk_assistant_get_nth_page ()

gtk_assistant_prepend_page ()

gtk_assistant_append_page ()

gtk_assistant_insert_page ()

gtkassistantpagefunc ()

gtk_assistant_set_forward_page_func ()

перечисление gtkassistantpagetype

gtk_assistant_set_page_type ()

gtk_assistant_get_page_type ()

gtk_assistant_set_page_title ()

gtk_assistant_get_page_title ()

gtk_assistant_set_page_header_image ()

gtk_assistant_get_page_header_image ()

gtk_assistant_set_page_side_image ()

gtk_assistant_get_page_side_image ()

gtk_assistant_set_page_complete ()

gtk_assistant_get_page_complete ()

gtk_assistant_add_action_widget ()

gtk_assistant_remove_action_widget ()

gtk_assistant_update_buttons_state ()

детали дочерних свойств

дочернее свойство "complete"

дочернее свойство "header-image"

дочернее свойство "page-type"

дочернее свойство "sidebar-image"

дочернее свойство "title"

детали свойств стиля

свойство стиля "content-padding"

свойство стиля "header-padding"

детали сигнала

сигнал "apply"

сигнал "cancel"

сигнал "close"

сигнал "prepare"

дочернее свойство "`complete`"

дочернее свойство "`header-image`"

дочернее свойство "`page-type`"

дочернее свойство "`sidebar-image`"

дочернее свойство "`title`"

свойство стиля "`content-padding`"

свойство стиля "`header-padding`"