GtkAssistant

gtk_assistant_new ()

GtkWidget *
gtk_assistant_new (void);

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

С: 2.10

gtk_assistant_get_current_page ()

gint
gtk_assistant_get_current_page (GtkAssistant *assistant);

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

С: 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().

С: 2.10

gtk_assistant_get_n_pages ()

gint
gtk_assistant_get_n_pages (GtkAssistant *assistant);

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

С: 2.10

gtk_assistant_get_nth_page ()

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

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

С: 2.10

gtk_assistant_prepend_page ()

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

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

С: 2.10

gtk_assistant_append_page ()

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

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

С: 2.10

gtk_assistant_insert_page ()

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

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

С: 2.10

gtk_assistant_remove_page ()

void
gtk_assistant_remove_page (GtkAssistant *assistant,
                           gint page_num);

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

С: 3.2

GtkAssistantPageFunc ()

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

С версии: 2.10

gtk_assistant_set_page_type ()

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

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

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

С версии: 2.10

gtk_assistant_get_page_type ()

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

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

С версии: 2.10

gtk_assistant_set_page_title ()

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

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

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

С версии: 2.10

gtk_assistant_get_page_title ()

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

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

С версии: 2.10

gtk_assistant_set_page_header_image ()

void
gtk_assistant_set_page_header_image (GtkAssistant *assistant,
                                     GtkWidget *page,
                                     GdkPixbuf *pixbuf);

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

С версии: 2.10

gtk_assistant_get_page_header_image ()

GdkPixbuf *
gtk_assistant_get_page_header_image (GtkAssistant *assistant,
                                     GtkWidget *page);

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

С версии: 2.10

gtk_assistant_set_page_side_image ()

void
gtk_assistant_set_page_side_image (GtkAssistant *assistant,
                                   GtkWidget *page,
                                   GdkPixbuf *pixbuf);

Устанавливает изображение боковой панели для page .

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

С версии: 2.10

gtk_assistant_get_page_side_image ()

GdkPixbuf *
gtk_assistant_get_page_side_image (GtkAssistant *assistant,
                                   GtkWidget *page);

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

С: 2.10

gtk_assistant_set_page_complete ()

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

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

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

С: 2.10

gtk_assistant_get_page_complete ()

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

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

С: 2.10

gtk_assistant_set_page_has_padding ()

void
gtk_assistant_set_page_has_padding (GtkAssistant *assistant,
                                    GtkWidget *page,
                                    gboolean has_padding);

Устанавливает, добавляет ли помощник отступы вокруг страницы.

С: 3.18

gtk_assistant_get_page_has_padding ()

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

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

С: 3.18

gtk_assistant_add_action_widget ()

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

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

С: 2.10

gtk_assistant_remove_action_widget ()

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

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

С: 2.10

gtk_assistant_update_buttons_state ()

void
gtk_assistant_update_buttons_state (GtkAssistant *assistant);

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

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

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

С: 2.10

gtk_assistant_commit ()

void
gtk_assistant_commit (GtkAssistant *assistant);

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

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

С: 2.22

gtk_assistant_next_page ()

void
gtk_assistant_next_page (GtkAssistant *assistant);

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

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

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

С: 3.0

gtk_assistant_previous_page ()

void
gtk_assistant_previous_page (GtkAssistant *assistant);

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

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

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

С: 3.0