Инициализация

Типичная main() функция для приложения GTK

См. GMainLoop в документации GLib, чтобы узнать больше о циклах и их функциях.

gtk_disable_setlocale ()

void
gtk_disable_setlocale (void);

Предотвращает, чтобы gtk_init(), gtk_init_check() и gtk_parse_args() автоматически вызывали setlocale (LC_ALL, ""). Вы захотите использовать эту функцию, если хотите установить локаль для вашей программы на значение, отличное от локали пользователя, или если хотите установить разные значения для разных категорий локали.

Большинству программ не нужно вызывать эту функцию.

gtk_get_default_language ()

PangoLanguage *
gtk_get_default_language (void);

Возвращает PangoLanguage для языка по умолчанию, который в настоящее время действует. (Обратите внимание, что это может измениться в течение жизни приложения.) Язык по умолчанию выводится из текущей локали. Он определяет, например, использует ли GTK направление текста справа налево или слева направо.

Эта функция эквивалентна pango_language_get_default(). См. эту функцию для получения подробностей.

gtk_get_locale_direction ()

GtkTextDirection
gtk_get_locale_direction (void);

Получает направление текущей локали. Это ожидаемое направление чтения текста и пользовательского интерфейса.

Эта функция зависит от текущей локали, установленной с setlocale(), и по умолчанию установит направление GTK_TEXT_DIR_LTR в противном случае. GTK_TEXT_DIR_NONE никогда не будет возвращаться.

GTK устанавливает направление текста по умолчанию в соответствии с локалью во время gtk_init(), и вы обычно должны использовать gtk_widget_get_direction() или gtk_widget_get_default_direction() для получения текущего направления.

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

int
main (int argc, char **argv)
{
 GtkWidget *window;
  // Initialize i18n support with bindtextdomain(), etc.

  // ...

  // Initialize the widget set
  gtk_init ();

  // Create the main window
  window = gtk_window_new ();

  // Set up our GUI elements

  // ...

  // Show the application window
  gtk_widget_show (window);

  // Enter the main event loop, and wait for user interaction
  while (!done)
    g_main_context_iteration (NULL, TRUE);

  // The user lost interest
  return 0;
}

gtk_init ()

void
gtk_init (void);

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

Если вы используете GtkApplication, вам не нужно вызывать gtk_init() или gtk_init_check(); обработчик “запуска” делает это за вас.

Эта функция завершит вашу программу, если она не смогла инициализировать систему окон по какой-либо причине. Если вы хотите, чтобы ваша программа перешла к текстовому интерфейсу, вы хотите вызвать gtk_init_check() вместо этого.

GTK вызывает signal (SIGPIPE, SIG_IGN) во время инициализации, чтобы игнорировать сигналы SIGPIPE, так как они почти никогда не нужны в графических приложениях. Если вам нужно обработать SIGPIPE по какой-либо причине, сбросьте обработчик после gtk_init(), но имейте в виду, что другие библиотеки (например, libdbus или gvfs) могут делать подобные вещи.

gtk_init_check ()

gboolean
gtk_init_check (void);

Эта функция выполняет ту же работу, что и gtk_init() с только одним изменением: она не завершает программу, если система окон не может быть инициализирована. Вместо этого она возвращает FALSE при ошибке.

Таким образом, приложение может перейти к другим средствам связи с пользователем — например, к интерфейсу командной строки или curses.

gtk_is_initialized ()

gboolean
gtk_is_initialized (void);

Используйте эту функцию для проверки, была ли GTK инициализирована с помощью gtk_init() или gtk_init_check().

gtk_get_debug_flags ()

GtkDebugFlags
gtk_get_debug_flags (void);

Возвращает флаги отладки GTK, которые в настоящее время активны.

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

gtk_set_debug_flags ()

void
gtk_set_debug_flags (GtkDebugFlags flags);

Устанавливает флаги отладки GTK.

GTK_PRIORITY_RESIZE

#define GTK_PRIORITY_RESIZE (G_PRIORITY_HIGH_IDLE + 10)

Используйте этот приоритет для функциональности, связанной с распределением размеров.

Он используется внутри GTK+ для вычисления размеров виджетов. Этот приоритет выше, чем GDK_PRIORITY_REDRAW, чтобы избежать изменения размера виджета, который был только что перерисован.

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