Начало работы с 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() в цикле обработки возвращает число, которое сохраняется в целочисленной переменной с именем «статус». После этого объект 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`