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

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 (событие нажатия и отпускания кнопки) посередине первого окна Gdk, принадлежащего 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);

Эта функция сгенерирует события нажатия и отпускания клавиш посередине первого найденного окна Gdk, принадлежащего 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