predator — Первые программы

Оригинал
В этой части нашего руководства мы создадим наши первые программы с использованием GTK+.

Простой пример.

Мы начнем с простого примера.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

#include <gtk/gtk.h> int main( int argc, char *argv ) { GtkWidget *window; gtk_init(&argc;, &argv;); window = gtk_window_new(GTK_WINDOW_TOPLEVEL); gtk_widget_show(window); gtk_main(); return 0; }

Этот пример создаст на экране простое окно.
Здесь мы компилируем нашу программу.
Инициализирует использование GTK+.
Здесь мы создаем виджет типа GtkWindow. GTK_WINDOW_TOPLEVEL это тип окна. Окна этого типа имеют заголовок и рамку. Ими управляет менеджер окон.
После создания виджета мы отображаем его на экране.
Эта функция вызывает главный цикл GTK+ приложений для обработки событий (нажатие клавишь клавиатуры и т.д.).

Вот что у нас должно получиться.

Центрирование окна.

Если мы сами не укажем позицию окна на экране, менеджер окон сделает это за нас. В следующем примере мы расположим наше окно по центру.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22

#include <gtk/gtk.h> int main( int argc, char *argv ) { GtkWidget *window; gtk_init(&argc;, &argv;); window = gtk_window_new(GTK_WINDOW_TOPLEVEL); gtk_window_set_title(GTK_WINDOW(window), "Center"); gtk_window_set_default_size(GTK_WINDOW(window), 230, 150); gtk_window_set_position(GTK_WINDOW(window), GTK_WIN_POS_CENTER); gtk_widget_show(window); g_signal_connect_swapped(G_OBJECT(window), "destroy", G_CALLBACK(gtk_main_quit), NULL); gtk_main(); return 0; }

В этом примере мы расположили окно в центре, установили свой заголовок и изменили размер окна.
Эта функция установит заголовок окна. Если мы не сделаем этого сами, GTK+ будет использовать в качестве заголовка имя исходного файла.
Этот код устанавливает размер окна 230 на 150 пикселей. Имейте ввиду, что сюда не входит рамка окна или любые другие декорации оконного менеджера.
Устанавливает окно в центре экрана.
В предыдущей программе окно не до конца завершало свою работу, если мы нажимали на х. Мы можем увидеть это запустив его из коммандной строки. По-умолчанию окно никак не воспринимало сигнал о закрытии окна (сигнал destroy). Мы должны явно связать сигнал о закрытии окна с функцией gtk_main_quit().

Иконка приложения.

В следующем примере мы покажем как создать иконку для нашего приложения. Большинство менеджеров окон отображают иконку в левом углу заголовка окна и на панели задач.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36

#include <gtk/gtk.h> GdkPixbuf *create_pixbuf(const gchar * filename) { GdkPixbuf *pixbuf; GError *error = NULL; pixbuf = gdk_pixbuf_new_from_file(filename, &error;); if(!pixbuf) { fprintf(stderr, "%s\n", error-&gt;message); g_error_free(error); } return pixbuf; } int main( int argc, char *argv ) { GtkWidget *window; gtk_init(&argc;, &argv;); window = gtk_window_new(GTK_WINDOW_TOPLEVEL); gtk_window_set_title(GTK_WINDOW(window), "icon"); gtk_window_set_default_size(GTK_WINDOW(window), 230, 150); gtk_window_set_position(GTK_WINDOW(window), GTK_WIN_POS_CENTER); gtk_window_set_icon(GTK_WINDOW(window), create_pixbuf("web.png")); gtk_widget_show(window); g_signal_connect_swapped(G_OBJECT(window), "destroy", G_CALLBACK(gtk_main_quit), NULL); gtk_main(); return 0; }

Пример с использованием иконки в приложении.
Функция gtk_window_set_icon() отображает иконку для нашего приложения. create_pixbuf() создает GdkPixbuf из png файла.
Согласно документации, функция gdk_pixbuf_new_from_file() создает объект типа GdkPixbuf из файла с изображением. Формат файла определяется автоматически. Функция возвращает NULL (NULL это специальный указатель на недоступную для приложения область памяти) в случае ошибки.

Увеличение - уменьшение.

Мы закончим первую часть нашего руководства ещё одним примером. Здесь у нас будет три дочерних виджета. Две кнопки (buttons) и метка (label). Метка будет содержать целое число. С помощью кнопок это число можно будет увеличивать и уменьшать.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64

#include <gtk/gtk.h> gint count = 0; char buf<5>; void increase(GtkWidget *widget, gpointer label) { count++; sprintf(buf, "%d", count); gtk_label_set_text(label, buf); } void decrease(GtkWidget *widget, gpointer label) { count--; sprintf(buf, "%d", count); gtk_label_set_text(label, buf); } int main(int argc, char** argv) { GtkWidget *label; GtkWidget *window; GtkWidget *frame; GtkWidget *plus; GtkWidget *minus; gtk_init(&argc;, &argv;); window = gtk_window_new(GTK_WINDOW_TOPLEVEL); gtk_window_set_position(GTK_WINDOW(window), GTK_WIN_POS_CENTER); gtk_window_set_default_size(GTK_WINDOW(window), 250, 180); gtk_window_set_title(GTK_WINDOW(window), "+-"); frame = gtk_fixed_new(); gtk_container_add(GTK_CONTAINER(window), frame); plus = gtk_button_new_with_label("+"); gtk_widget_set_size_request(plus, 80, 35); gtk_fixed_put(GTK_FIXED(frame), plus, 50, 20); minus = gtk_button_new_with_label("-"); gtk_widget_set_size_request(minus, 80, 35); gtk_fixed_put(GTK_FIXED(frame), minus, 50, 80); label = gtk_label_new("0"); gtk_fixed_put(GTK_FIXED(frame), label, 190, 58); gtk_widget_show_all(window); g_signal_connect(window, "destroy", G_CALLBACK (gtk_main_quit), NULL); g_signal_connect(plus, "clicked", G_CALLBACK(increase), label); g_signal_connect(minus, "clicked", G_CALLBACK(decrease), label); gtk_main(); return 0; }

Этот пример показывает как можно изменять значение в GtkLabel.
Мы соединяем increase() с кнопкой плюс (в данном контексте функцию increase() принято называть функцией обратного вызова). Имейте ввиду, что мы должны передавать метку в качестве параметра функции обратного вызова. Мы изменяем метку внутри функции.
Увеличив значение переменной и преобразовав его в строку мы передаем в функцию gtk_label_set_text новый текст, который будет отображать метка.