Тестирование

gtk_test_create_simple_window ()

GtkWidget *
gtk_test_create_simple_window (const gchar *window_title,
                               const gchar *dialog_text);

Создаёт простое окно с заголовком окна window_title и текстовым содержимым dialog_text . Окно завершит любой запущенный цикл gtk_main() при уничтожении и автоматически будет уничтожено при завершении функции теста.

С версии: 2.14

gtk_test_create_widget ()

GtkWidget *
gtk_test_create_widget (GType widget_type,
                        const gchar *first_property_name,
                        ...);

Эта функция оборачивает g_object_new() для типов виджетов. Она автоматически отобразит все созданные виджеты, которые не являются окнами, также g_object_ref_sink() их (чтобы сохранить их при выполнении теста) и настроит их для уничтожения во время следующей фазы завершения теста.

С версии: 2.14

gtk_test_display_button_window ()

GtkWidget *
gtk_test_display_button_window (const gchar *window_title,
                                const gchar *dialog_text,
                                ...);

Создаёт окно с заголовком window_title , текстовым содержимым dialog_text и количеством кнопок, согласно списку пар аргументов, указанных как параметры @... Каждая кнопка создаётся с label и обработчиком сигнала ::clicked, который увеличивает целое число, хранящееся в nump . Окно будет автоматически отображено с помощью gtk_widget_show_now() после создания, поэтому при возврате из этой функции оно уже отображено, переразмерено и расположено на экране. Окно завершит любой запущенный цикл gtk_main() при уничтожении и автоматически будет уничтожено при завершении функции теста.

С версии: 2.14

gtk_test_find_label ()

GtkWidget *
gtk_test_find_label (GtkWidget *widget,
                     const gchar *label_pattern);

Эта функция ищет widget и все его дочерние элементы для виджета GtkLabel с текстовой строкой, соответствующей label_pattern . label_pattern может содержать звёздочки «*» и вопросительные знаки «?» в качестве заглушек, g_pattern_match() используется для сопоставления. Обратите внимание, что языковые наборы, отличные от "C", часто изменяют (переводят) строки меток, поэтому эта функция, как правило, полезна только в тестовых программах с предварительно определёнными языковыми наборами. См. gtk_test_init() для получения более подробной информации.

С версии: 2.14

gtk_test_find_sibling ()

GtkWidget *
gtk_test_find_sibling (GtkWidget *base_widget,
                       GType widget_type);

Эта функция ищет братьев base_widget и братьев его предков для всех виджетов, соответствующих widget_type . Из соответствующих виджетов будет возвращён виджет, геометрически наиболее близкий к base_widget . Основная цель этой функции — найти наиболее вероятный виджет «действия» относительно другого виджета с меткой. Например, найти виджет кнопки или поля ввода, зная соответствующий виджет метки.

С версии: 2.14

gtk_test_find_widget ()

GtkWidget *
gtk_test_find_widget (GtkWidget *widget,
                      const gchar *label_pattern,
                      GType widget_type);

Эта функция ищет потомков widget для виджета типа widget_type, имеющего метку, соответствующую label_pattern рядом с ним. Это наиболее полезно для автоматизированного тестирования графического интерфейса пользователя, например, для поиска кнопки «ОК» в диалоговом окне и имитации нажатия на неё. Однако см. gtk_test_find_label(), gtk_test_find_sibling() и gtk_test_widget_click() для возможных нюансов, связанных с поиском таких виджетов и имитацией событий виджетов.

С версии: 2.14

gtk_test_init ()

void
gtk_test_init (int *argcp,
               char ***argvp,
               ...);

Эта функция используется для инициализации программы тестирования GTK+.

Она, в свою очередь, вызывает g_test_init() и gtk_init() для правильной инициализации фреймворка тестирования и графической библиотеки. Она также установит локаль программы на «C» и предотвратит загрузку файлов rc и модулей Gtk+. Это делается для того, чтобы среды тестирования программ были максимально детерминированными.

Как и gtk_init() и g_test_init(), все известные аргументы будут обработаны и удалены из argc и argv .

С момента: 2.14

gtk_test_list_all_types ()

const GType *
gtk_test_list_all_types (guint *n_types);

Возвращает идентификаторы типов, которые были зарегистрированы после вызова gtk_test_register_all_types().

С момента: 2.14

gtk_test_register_all_types ()

void
gtk_test_register_all_types (void);

Принудительно регистрирует все основные типы объектов Gtk+ и Gdk. Это позволяет ссылаться на любой из этих типов объектов через g_type_from_name() после вызова этой функции.

С момента: 2.14

gtk_test_slider_get_value ()

double
gtk_test_slider_get_value (GtkWidget *widget);

Возвращает значение регулировки для виджетов GtkRange и кнопок прокрутки. Обратите внимание, что возвращаемое этим значением значение находится между нижней и верхней границами регулировки, относящейся к widget, и не является процентом, как передано в gtk_test_slider_set_perc().

С момента: 2.14

gtk_test_slider_set_perc ()

void
gtk_test_slider_set_perc (GtkWidget *widget,
                          double percentage);

Эта функция настраивает положение ползунка всех виджетов GtkRange, таких как полосы прокрутки или шкалы, а также кнопок прокрутки. Значение регулировки этих виджетов устанавливается в значение между нижним и верхним пределами в соответствии с аргументом percentage.

С момента: 2.14

gtk_test_spin_button_click ()

gboolean
gtk_test_spin_button_click (GtkSpinButton *spinner,
                            guint button,
                            gboolean upwards);

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

С момента: 2.14

gtk_test_text_get ()

gchar *
gtk_test_text_get (GtkWidget *widget);

Возвращает строку текста widget, если это GtkLabel, GtkEditable (виджеты ввода и текста) или GtkTextView.

С момента: 2.14

gtk_test_text_set ()

void
gtk_test_text_set (GtkWidget *widget,
                   const gchar *string);

Устанавливает строку текста widget на string, если это GtkLabel, GtkEditable (виджеты ввода и текста) или GtkTextView.

С момента: 2.14

gtk_test_widget_click ()

gboolean
gtk_test_widget_click (GtkWidget *widget,
                       guint button,
                       GdkModifierType modifiers);

Эта функция сгенерирует клик button (событие нажатия и отпускания кнопки) в середине первого найденного GdkWindow, принадлежащего widget. Для бесклавишных виджетов, таких как GtkButton (который возвращает FALSE из gtk_widget_get_has_window()), это часто будет окно только для ввода. Для других виджетов, это обычно widget->window. Следует учитывать определённые особенности при использовании этой функции, в частности, из-за того, что указатель мыши смещается к месту нажатия кнопки, см. gdk_test_simulate_button() для получения более подробной информации.

С: 2.14

gtk_test_widget_send_key ()

gboolean
gtk_test_widget_send_key (GtkWidget *widget,
                          guint keyval,
                          GdkModifierType modifiers);

Эта функция сгенерирует события нажатия и отпускания клавиш в середине первого найденного GdkWindow, принадлежащего widget. Для бесклавишных виджетов, таких как GtkButton (которые возвращают FALSE из gtk_widget_get_has_window()), это часто будет окно только для ввода. Для других виджетов, это обычно widget->window. Следует учитывать определённые особенности при использовании этой функции, в частности, из-за того, что указатель мыши смещается к месту нажатия клавиши, см. gdk_test_simulate_key() для получения более подробной информации.

С: 2.14

gtk_test_widget_wait_for_draw ()

void
gtk_test_widget_wait_for_draw (GtkWidget *widget);

Входит в основной цикл и ждёт, пока widget будет «отображён». В этом контексте это означает, что ждёт, пока цикл обработки кадров widget выполнит полный цикл стилизации, компоновки и отрисовки.

Эта функция предназначена для синхронизации с действиями, которые зависят от widget перераспределения или взаимодействия с сервером отображения.

С: 3.10