GtkAssistant

gtk_assistant_new ()

GtkWidget *
gtk_assistant_new (void);

Создаёт новый GtkAssistant.

gtk_assistant_get_page ()

GtkAssistantPage *
gtk_assistant_get_page (GtkAssistant *assistant,
                        GtkWidget *child);

Возвращает объект GtkAssistantPage для child .

gtk_assistant_get_pages ()

GListModel *
gtk_assistant_get_pages (GtkAssistant *assistant);

Получает модель списка страниц помощника.

gtk_assistant_page_get_child ()

GtkWidget *
gtk_assistant_page_get_child (GtkAssistantPage *page);

Возвращает дочерний элемент, к которому относится page .

gtk_assistant_get_current_page ()

int
gtk_assistant_get_current_page (GtkAssistant *assistant);

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

gtk_assistant_set_current_page ()

void
gtk_assistant_set_current_page (GtkAssistant *assistant,
                                int page_num);

Переключает страницу на page_num .

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

gtk_assistant_get_n_pages ()

int
gtk_assistant_get_n_pages (GtkAssistant *assistant);

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

gtk_assistant_get_nth_page ()

GtkWidget *
gtk_assistant_get_nth_page (GtkAssistant *assistant,
                            int page_num);

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

gtk_assistant_prepend_page ()

int
gtk_assistant_prepend_page (GtkAssistant *assistant,
                            GtkWidget *page);

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

gtk_assistant_append_page ()

int
gtk_assistant_append_page (GtkAssistant *assistant,
                           GtkWidget *page);

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

gtk_assistant_insert_page ()

int
gtk_assistant_insert_page (GtkAssistant *assistant,
                           GtkWidget *page,
                           int position);

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

gtk_assistant_remove_page ()

void
gtk_assistant_remove_page (GtkAssistant *assistant,
                           int page_num);

Удаляет страницу page_num из assistant .

GtkAssistantPageFunc ()

int
(*GtkAssistantPageFunc) (int current_page,
                         gpointer data);

Функция, используемая gtk_assistant_set_forward_page_func() для определения следующей страницы, исходя из текущей. Она вызывается как при нажатии пользователем кнопки «вперед», так и для обработки поведения кнопки «назад».

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 заставит помощника использовать функцию по умолчанию, которая переходит к следующей видимой странице.

gtk_assistant_set_page_type ()

void
gtk_assistant_set_page_type (GtkAssistant *assistant,
                             GtkWidget *page,
                             GtkAssistantPageType type);

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

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

gtk_assistant_get_page_type ()

GtkAssistantPageType
gtk_assistant_get_page_type (GtkAssistant *assistant,
                             GtkWidget *page);

Получает тип страницы page .

gtk_assistant_set_page_title ()

void
gtk_assistant_set_page_title (GtkAssistant *assistant,
                              GtkWidget *page,
                              const char *title);

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

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

gtk_assistant_get_page_title ()

const char *
gtk_assistant_get_page_title (GtkAssistant *assistant,
                              GtkWidget *page);

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

gtk_assistant_set_page_complete ()

void
gtk_assistant_set_page_complete (GtkAssistant *assistant,
                                 GtkWidget *page,
                                 gboolean complete);

Устанавливает, завершены ли данные page.

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

gtk_assistant_get_page_complete ()

gboolean
gtk_assistant_get_page_complete (GtkAssistant *assistant,
                                 GtkWidget *page);

Получает, завершена ли page.

gtk_assistant_add_action_widget ()

void
gtk_assistant_add_action_widget (GtkAssistant *assistant,
                                 GtkWidget *child);

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

gtk_assistant_remove_action_widget ()

void
gtk_assistant_remove_action_widget (GtkAssistant *assistant,
                                    GtkWidget *child);

Удаляет виджет из области действий GtkAssistant.

gtk_assistant_update_buttons_state ()

void
gtk_assistant_update_buttons_state (GtkAssistant *assistant);

Принудительно пересчитывает состояние кнопок assistant.

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

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

gtk_assistant_commit ()

void
gtk_assistant_commit (GtkAssistant *assistant);

Удаляет историю посещённых страниц, чтобы кнопка «Назад» не отображалась на текущей странице, а также удаляет кнопку «Отмена» со следующих страниц.

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

gtk_assistant_next_page ()

void
gtk_assistant_next_page (GtkAssistant *assistant);

Переход к следующей странице.

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

Эта функция предназначена для использования при создании страниц типа GTK_ASSISTANT_PAGE_CUSTOM.

gtk_assistant_previous_page ()

void
gtk_assistant_previous_page (GtkAssistant *assistant);

Переход к предыдущей посещённой странице.

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

Эта функция предназначена для использования при создании страниц типа GTK_ASSISTANT_PAGE_CUSTOM.