GTK/trans gtk-tutorial.20021027:ch2

Матеріал з docs.linux.org.ua — збірника документації з Unix/Linux українською мовою.

"Привіт, світе" в GTK

А тепер - за програму з елементом керування (кнопкою). Це - класичний "привіт

світе" (hello world) для GTK.

#include <gtk/gtk.h>



/* Ця функцiя викликається системою. Аргумент данних iгнорується

 * в цьому прикладi. Бiльше про зворотнi виклики - нижче. */

void hello( GtkWidget *widget,

            gpointer   data )

{

/* Програми пiд GTK, в яких зустрiчається кирилиця в повiдомленнях

 * потрiбно записувати в юнiкодi (UTF-8) */

    g_print ("Привiт, свiте бiлий\n");

}



gint delete_event( GtkWidget *widget,

                   GdkEvent  *event,

                   gpointer   data )

{

    /* Якщо функцiя обробки сигналу "delete_event" повертає FALSE,

     * GTK пошле сигнал "destroy". Повертання TRUE означає, що ви

     * не бажаєте, аби вiкно було знищено.

     * Це корисно, коли ви хочете, щоб програма перепитала чи користувач

     * дiйсно хоче завершити роботу. */



    g_print ("delete event occurred\n");



    /* Змiнiть TRUE на FALSE i головне вiкно буде знищено при

     * подiї "delete_event". */



    return TRUE;

}



/* Iнша функцiя зворотнього виклику (callback) */

void destroy( GtkWidget *widget,

              gpointer   data )

{

    gtk_main_quit ();

}



int main( int   argc,

          char *argv[] )

{

    /* GtkWidget is the storage type for widgets */

    GtkWidget *window;

    GtkWidget *button;



    /* Цей виклик робиться у всiх програмах пiд GTK. Аргументи беруться

     * з командної строки i повертаються в програму. */

    gtk_init (&argc, &argv);



    /* створюєм нове вiкно */

    window = gtk_window_new (GTK_WINDOW_TOPLEVEL);



    /* Коли вiкно отримує сигнал "delete_event" (його дає вiконний менеджер,

     * зазвичай пр виборi опцiї "закрити" або при закриттi мишкою по

     * хрестику), ми просимо його викликати функцiю delete_event ()

     * як показано вище. Даннi якi передаються в функцiю зворотнього виклику

     * це - NULL i вони iгноруються. */

    g_signal_connect (G_OBJECT (window), "delete_event",

                      G_CALLBACK (delete_event), NULL);



    /* Тут ми приєднуємо подiю "destroy" до обробника сигналiв.

     * Ця подiя з'являєтьсяколи ми викликаєм gtk_widget_destroy() стосовно

     *  вiкна, або якщо полвертаємо FALSE в обробнику подiї "delete_event". */

    g_signal_connect (G_OBJECT (window), "destroy",

                      G_CALLBACK (destroy), NULL);



    /* Встановлює ширину краю вiкна. */

    gtk_container_set_border_width (GTK_CONTAINER (window), 10);



    /* Створює нову кнопку з написом "Hello World". */

    button = gtk_button_new_with_label ("Hello World");



    /* Коли кнопка отримує сигнал "clicked" - вона викличе функцію

     * hello() , передаючи їй  аргумент NULL .  Функція  hello()

     * описана вище. */

    g_signal_connect (G_OBJECT (button), "clicked",

                      G_CALLBACK (hello), NULL);



    /* Це спричинить знищення вікна викликом gtk_widget_destroy(window)

     * при події "clicked".  Нагадуєм: сигнал знищення може прийти від

     * СКВ (Система Керування Вікнами - "віконний менеджер") */

    g_signal_connect_swapped (G_OBJECT (button), "clicked",

                              G_CALLBACK (gtk_widget_destroy),

                              G_OBJECT (window));



    /* "Запаковує" кнопку в вікно (контейнер gtk). */

    gtk_container_add (GTK_CONTAINER (window), button);



    /* Кінцевий крок - показати новостворений елемент інтерфейсу. */

    gtk_widget_show (button);



    /* і саме вікно */

    gtk_widget_show (window);



    /* Всі прграми під GTK повинні мати gtk_main(). Хід програми тут

     * припиняється і вона очікує на події (натискання клавіш, події

     * від мишки). */

    gtk_main ();

     /* Якщо ви - особливий збоченець - можете послати gtk_main ()

      * в окремий потік і продовжувати тут свою прогаму, але користі

      * від того буде менше, ніж витрачено праці. */

    return 0;

}

Щоб відкомпілювати свою програму наберіть:

gcc -Wall -g helloworld.c -o helloworld `pkg-config --cflags gtk+-2.0` \

    `pkg-config --libs gtk+-2.0`

Тут використовується програма pkg-config, котру можна отримати з

http://www.freedesktop.org . Ця прграма читає *.pc який іде з GTK щоб

визначити які опції потрібно компілятору щоб відкомпілювати програми під GTK.

pkg-config --cflags gtk+-2.0 видасть список директорій з

заголовковими файлами

pkg-config --libs gtk+-2.0

видасть список бібліотек, які потрібно підключити і список директорій, де їх

шукати. В вишенаведеному прикладі вони можуть бути об'єднаними в один вираз:

pkg-config --cflags --libs gtk+-2.0

Зверніть увангу на обернені апострофи в вищенаведеному прикладі - це важливо

(вони вказують на те, що результати виконання пограми pkg-config ідуть як

параметри компілятору, інакше - оболонка пердасть pkg-config як один з

параметрів компілятору і ви отримаєте дулю з маком, а не прогаму ;D ).

Бібліотеки, які, зазвичай, підключаються:

• Бібліотека GTK (-lgtk) -- Бібліотека віджетів, базована на GDK.

• Бібліотека GDK (-lgdk), the Xlib wrapper.

• Бібліотека gdk-pixbuf (-lgdk_pixbuf), бібліотека керування образами

(картинками).

• Бібліотека Pango (-lpango) Для інтернаціоналізованого тексту.

• Бібліотека gobject(-lgobject), містить тип системи, на якій базується GTK.

• Бібліотека gmodule (-lgmodule), яка використовується для завантаження

розширень часу виконання.

• Бібліотека GLib (-lglib), містить змішані функції; тільки g_print()

використовувалась в конкретно в цьому прикладі. GTK побудований над GLib таким

чином ви завжди потребуєте цю бібліотеку.

• Бібліотека Xlib (-lX11)яка використовується в GDK.

• Бібліотека Xext (-lXext). Вона містить функції для "shared memory pixmaps" та

інших розширень X.

• Математична бібліотека (-lm). GTK використовує її з різних причин (тобто її

не треба підключати явно).

далі