Начало работы с GTK+

Чтобы начать наше знакомство с GTK, мы начнём с простого приложения GTK на основе сигналов. Эта программа создаст пустое окно размером 200 × 200 пикселей.

#include <gtk/gtk.h>

static void
activate (GtkApplication* app,
          gpointer        user_data)
{
  GtkWidget *window;

  window = gtk_application_window_new (app);
  gtk_window_set_title (GTK_WINDOW (window), "Window");
  gtk_window_set_default_size (GTK_WINDOW (window), 200, 200);
  gtk_widget_show_all (window);
}

int
main (int    argc,
      char **argv)
{
  GtkApplication *app;
  int status;

  app = gtk_application_new ("org.gtk.example", G_APPLICATION_FLAGS_NONE);
  g_signal_connect (app, "activate", G_CALLBACK (activate), NULL);
  status = g_application_run (G_APPLICATION (app), argc, argv);
  g_object_unref (app);

  return status;
}

Вы можете скомпилировать программу выше с помощью GCC следующим образом:

gcc `pkg-config --cflags gtk+-3.0` -o example-0 example-0.c `pkg-config --libs gtk+-3.0`

Все приложения GTK+ будут, конечно, включать gtk/gtk.h, который объявляет функции, типы и макросы, необходимые для приложений GTK+.

В приложении GTK+ функция main() предназначена для создания объекта GtkApplication и его запуска. В этом примере вызывается указатель GtkApplication с именем app и затем инициализируется с помощью gtk_application_new().

При создании GtkApplication, необходимо выбрать идентификатор приложения (имя) и передать его в gtk_application_new() в качестве параметра. Для этого примера используется org.gtk.example, но для выбора идентификатора вашего приложения, см. это руководство. Наконец, gtk_application_new() принимает в качестве входных данных флаги GApplication для вашего приложения, если у вашего приложения есть особые потребности.

Далее, сигнал «activate» подключается к функции activate() выше функции main(). Сигнал activate будет отправлен при запуске вашего приложения с помощью g_application_run() в строке ниже. Функция gtk_application_run() также принимает в качестве аргументов указатели на счётчик аргументов командной строки и массив строк; это позволяет GTK+ анализировать специфические аргументы командной строки, которые управляют поведением самого GTK+. Проанализированные аргументы будут удалены из массива, оставив нераспознанные для анализа вашим приложением.

Внутри g_application_run отправляется сигнал activate(), и затем мы переходим к функции activate() приложения. Внутри функции activate() мы хотим создать наше окно GTK, чтобы окно отображалось при запуске приложения. Вызов gtk_application_window_new() создаст новое окно GtkWindow и сохранит его в указателе window. Окно будет иметь рамку, строку заголовка и элементы управления окном в зависимости от платформы.

Заголовок окна устанавливается с помощью gtk_window_set_title(). Эта функция принимает указатель GtkWindow* и строку в качестве входных данных. Поскольку наш указатель window — это указатель GtkWidget, нам нужно привести его к типу GtkWindow*. Но вместо приведения window через (GtkWindow*), window можно привести с помощью макроса GTK_WINDOW(). GTK_WINDOW() проверит, является ли указатель экземпляром класса GtkWindow, прежде чем привести его к типу, и выдаст предупреждение, если проверка завершится неудачно. Дополнительную информацию об этой конвенции можно найти здесь.

Наконец, размер окна устанавливается с помощью gtk_window_set_default_size, и окно отображается GTK с помощью gtk_widget_show_all().

При выходе из окна, например, при нажатии на X, g_application_run() в главном цикле возвращает число, которое сохраняется в целочисленной переменной с именем "status". После этого объект GtkApplication освобождается из памяти с помощью g_object_unref(). Наконец, возвращается целочисленное значение status, и приложение GTK завершается.

Во время выполнения программы GTK+ получает события. Обычно это события ввода, вызванные взаимодействием пользователя с вашей программой, а также сообщения от менеджера окон или других приложений. GTK+ обрабатывает их, и в результате на ваших виджетах могут генерироваться сигналы. Подключение обработчиков этих сигналов — это то, как вы обычно заставляете свою программу что-то делать в ответ на ввод пользователя.

Следующий пример немного сложнее и демонстрирует некоторые возможности GTK+.

В соответствии с давней традицией языков программирования и библиотек, он называется «Привет, мир».

#include <gtk/gtk.h>

static void
print_hello (GtkWidget *widget,
             gpointer   data)
{
  g_print ("Hello World\n");
}

static void
activate (GtkApplication *app,
          gpointer        user_data)
{
  GtkWidget *window;
  GtkWidget *button;
  GtkWidget *button_box;

  window = gtk_application_window_new (app);
  gtk_window_set_title (GTK_WINDOW (window), "Window");
  gtk_window_set_default_size (GTK_WINDOW (window), 200, 200);

  button_box = gtk_button_box_new (GTK_ORIENTATION_HORIZONTAL);
  gtk_container_add (GTK_CONTAINER (window), button_box);

  button = gtk_button_new_with_label ("Hello World");
  g_signal_connect (button, "clicked", G_CALLBACK (print_hello), NULL);
  g_signal_connect_swapped (button, "clicked", G_CALLBACK (gtk_widget_destroy), window);
  gtk_container_add (GTK_CONTAINER (button_box), button);

  gtk_widget_show_all (window);
}

int
main (int    argc,
      char **argv)
{
  GtkApplication *app;
  int status;

  app = gtk_application_new ("org.gtk.example", G_APPLICATION_FLAGS_NONE);
  g_signal_connect (app, "activate", G_CALLBACK (activate), NULL);
  status = g_application_run (G_APPLICATION (app), argc, argv);
  g_object_unref (app);

  return status;
}

Вы можете скомпилировать программу выше с помощью GCC следующим образом:

gcc `pkg-config --cflags gtk+-3.0` -o example-1 example-1.c `pkg-config --libs gtk+-3.0`