Статья
Версия для печати
Обсудить на форуме
Основы GTK+ (часть 2)



В первой части мы учились ловить события и создавать виджеты. В этой части мы посмотрим, как создать меню и создадим небольшой текстовый редактор.
Приступим. Для создания меню нам в большинстве случаем понадобятся следующие функции:
Код:
GtkWidget *gtk_menu_bar_new( void );
GtkWidget *gtk_menu_new( void );
GtkWidget *gtk_menu_item_new( void );

GtkWidget *gtk_menu_item_new_with_label( const char *label );

GtkWidget *gtk_menu_item_new_with_mnemnonic( const char *label );

void gtk_menu_item_set_submenu(
GtkMenuItem *menu_item,
GtkWidget *submenu );

void gtk_menu_bar_append(
GtkMenuBar *menu_bar,
GtkWidget *menu_item );

void gtk_menu_item_right_justify( GtkMenuItem *menu_item );

Расскажу о них по порядку.

Код:
GtkWidget *gtk_menu_bar_new( void );
Создает меню бар куда собственно и крепится наше меню.

Код:
GtkWidget *gtk_menu_new( void );
Создает меню в которое инкапсулируются остальные элементы меню.

Код:
GtkWidget *gtk_menu_item_new( void );
GtkWidget *gtk_menu_item_new_with_label( const char *label );
GtkWidget *gtk_menu_item_new_with_mnemnonic( const char *label );
Создают элементы меню. С первой функцией всё понятно просто элемент без видимой метки. Вторая с видимой меткой, а треть я подчеркиванием мнемоники.
Пока ничего сложного и интересного.

Код:
void gtk_menu_item_set_submenu(
GtkMenuItem *menu_item,
GtkWidget *submenu );
Привязываем  к элементу меню подменю.

Код:
void gtk_menu_bar_append(
GtkMenuBar *menu_bar,
GtkWidget *menu_item );
Далее крепим элемент меню к меню бару.

Код:
void gtk_menu_item_right_justify( GtkMenuItem *menu_item );

Если очень хочется можно элемент меню выровнять в меню баре по правому краю.
При нажатии на элемент меню вызывается событие activate .
Для создания сложных меню с минимальным вызовом функций существует фабрика элементов, но об этом в другой раз.
Пример кода из нашей программы:
Код:
/* Меню бар. */
menu_bar = gtk_menu_bar_new ();

/* Пакуем меню бар в коробку. И показываем его всем. */
gtk_box_pack_start (GTK_BOX (ver_box), menu_bar, FALSE, TRUE, 0);
gtk_widget_show (menu_bar);

/* Собственно меню "Файл". */
file_menu = gtk_menu_new();

/* Создаем элементы меню "Файл". */
open_item = gtk_menu_item_new_with_label ("Open");
save_item = gtk_menu_item_new_with_label ("Save");
save_as_item = gtk_menu_item_new_with_label ("Save as");
quit_item = gtk_menu_item_new_with_label ("Quit");

/* Пакуем элементы меню "Файл" в меню "Файл". */
gtk_menu_shell_append (GTK_MENU_SHELL (file_menu), open_item);
gtk_menu_shell_append (GTK_MENU_SHELL (file_menu), save_item);
gtk_menu_shell_append (GTK_MENU_SHELL (file_menu), save_as_item);
gtk_menu_shell_append (GTK_MENU_SHELL (file_menu), quit_item);

/* Подключаем к ним события. */
g_signal_connect (G_OBJECT (open_item), "activate",
G_CALLBACK (open_event), NULL);

g_signal_connect (G_OBJECT (save_item), "activate",
G_CALLBACK (save_event), NULL);

g_signal_connect (G_OBJECT (save_as_item), "activate",
G_CALLBACK (save_event),
(gpointer) "as");

g_signal_connect_swapped (G_OBJECT (quit_item), "activate",
G_CALLBACK (gtk_main_quit),
G_OBJECT(window));

/* Показываем элементы меню "Файл". */
gtk_widget_show(open_item);
gtk_widget_show(save_item);
gtk_widget_show(save_as_item);
gtk_widget_show(quit_item);

/* Создаем верхний элемент меню "Файл". */
file_item = gtk_menu_item_new_with_label ("File");
gtk_widget_show (file_item);

/* Подключаем к верхниму элементу меню. А его в меню бару. */
gtk_menu_item_set_submenu (GTK_MENU_ITEM (file_item), file_menu);
gtk_menu_bar_append (GTK_MENU_BAR(menu_bar), file_item);

Так же в программе мы использовали диалог открытия/создания(выбора) файла.

(КАРТИНКА)

Код:
GtkWidget *gtk_file_selection_new( const gchar *title );
Создает диалог выбора файла с заголовком  title.

Код:
void gtk_file_selection_set_filename(
GtkFileSelection *filesel,
const gchar *filename );
Устанавливаем название файла в диалоге например при нажатии "Сохранить как".

Код:
gchar *gtk_file_selection_get_filename( GtkFileSelection *filesel );
Берем из диалога имя файла.

Кроме того диалог содержит следующие элементы к которым тоже можно обращатся:
Код:
dir_list
file_list
selection_entry
selection_text
main_vbox
ok_button
cancel_button
help_button

Пример использования из программы:

Код:
	GtkWidget *file_open;

file_open = gtk_file_selection_new ("Save file as...");

/* Подключаем обработчик нажатия кнопки "Ok" в диалоге. */
g_signal_connect (
G_OBJECT(GTK_FILE_SELECTION(file_open)->ok_button),
"clicked", G_CALLBACK(save_ok_button_event),
NULL);

g_signal_connect_swapped (
G_OBJECT (GTK_FILE_SELECTION(file_open)->ok_button),
"clicked", G_CALLBACK(gtk_widget_destroy),
G_OBJECT (file_open));

g_signal_connect_swapped (
G_OBJECT (GTK_FILE_SELECTION(file_open)->cancel_button),
"clicked", G_CALLBACK(gtk_widget_destroy),
G_OBJECT (file_open));

gtk_widget_show (file_open);

Ну и самое недокументированное это text_view. Это некоторый аналог RichEdit из Windows только возможностей у text_view гораздо больше. Опишу только, то, что сам делал. Вот небольшой кусок кода использованного при создании  text_view:

Код:
	/* Создаем окно с прокруткой. */
scroll_window = gtk_scrolled_window_new (NULL, NULL);
gtk_scrolled_window_set_policy (
GTK_SCROLLED_WINDOW (scroll_window),
GTK_POLICY_AUTOMATIC,
GTK_POLICY_AUTOMATIC);

/* Создаем окно редактирования. */
text_view = gtk_text_view_new ();

/* Вытаскием из редактора буфер. */
buffer = gtk_text_view_get_buffer (GTK_TEXT_VIEW (text_view));

/* Создаем тэг для текста. Моноширный, жирный и крупный. */
gtk_text_buffer_create_tag (
buffer, "monospace_big_bold",
"family", "monospace",
"size", 20 * PANGO_SCALE,
"weight", PANGO_WEIGHT_BOLD,
NULL);

/* Засовываем текстовое окно в окно с прокруткой. */
gtk_container_add (GTK_CONTAINER (scroll_window), text_view);
gtk_widget_show (text_view);

Что проиходит в этом коде? Думаю здесь понятно:

Код:
	scroll_window = gtk_scrolled_window_new (NULL, NULL);
gtk_scrolled_window_set_policy (
GTK_SCROLLED_WINDOW (scroll_window),
GTK_POLICY_AUTOMATIC,
GTK_POLICY_AUTOMATIC);

Создаем окно с прокруткой и устанавливаем ему политику для ползунков, а именно отображаться по необходимости. Далее создаем text_view и грабим с него буфер. А зачем? А затем, что мы работаем с текстовым буфером, а не с окном . К тому же его можно подсунуть другому text_view в этом случае они будут отображать состояние одного буфера. Делается вот так:
Код:
	text_view2 = gtk_text_view_new (buffer);

Функция gtk_text_buffer_create_tag создает тэг для текста. Т.е. стиль отображения текста. Далее запихиваем text_view в окно с прокруткой.

С этим надеюсь понятно возникает вопрос, а как нам текст из файла запихать в редактор. Делаем это так
Код:
	gtk_text_buffer_insert_with_tags_by_name (
buffer,&iter,cbuffer,rval,
"monospace_big_bold", NULL);
или так:
Код:
	gtk_text_buffer_insert (buffer, &iter, cbuffer, rval);
Параметры:

  • buffer - буфер текста;
  • iter - итератор определяет позицию в тексте;
  • cbuffer - текст gchar *;
  • rval - количество символов для вставки, если -1, то вся строка. Должна заканчиваться нулём;
  • "monospace_big_bold" - название тега;
  • NULL - говорит, что тегов больше не будет.

В случае gtk_text_buffer_insert - используется тэг установленный для данной позиции.

Теперь возьмем текст из text_view:
Код:
	gtk_text_buffer_get_bounds (buffer, &start, &end);
cbuffer = gtk_text_buffer_get_text (buffer, &start, &end, TRUE);
Первой строкой берем начало и конец буфера. Второй сохраняем текст буфера в gchar *. TRUE означает, что грабит скрытые символы.

И напоследок. Весь текст в text_view в UTF-8 вот так. Так, что перед записью не английских символов в буфер убедитесь, что они в UTF-8. Вот что получилось.

(КАРТИНКА)



Листинг CoolEdit.c:

Код:
#include <gtk/gtk.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <sys/wait.h>
#include <fcntl.h>
#include <stdlib.h>
#include <unistd.h>
#include <stdio.h>
#include <signal.h>

GtkWidget *window; // Собственно окно.
GtkWidget *scroll_window; // Другое окно с прокруткой для редактора.
GtkWidget *ver_box; // Вертикальная коробка.
GtkWidget *text_view; // Наш виджет для текста.
GtkWidget *file_open; // Диалог открытия/сохранения файла.
GtkWidget *menu_bar; // И так ясно.

GtkWidget *file_menu; // Отсюда элементы меню.
GtkWidget *file_item;
GtkWidget *open_item;
GtkWidget *save_item;
GtkWidget *save_as_item;
GtkWidget *quit_item;

GtkWidget *help_menu;
GtkWidget *help_top_item;
GtkWidget *help_item;
GtkWidget *about_item; // Всё элементы меню кончились.

GtkTextBuffer *buffer; // Текстовый буфер для редактора текста
// его можно подсунуть еще кому нибудь
// и редактировать один буфер в двух и более окнах
// одновременно.
gchar *file_name = NULL; // Храним имя файла мало ли понадобится.
int workfile = -1; // Дескриптор открытого файла.

// Закрывает главное окно в принципе
void destroy(GtkWidget *widget, gpointer data)
{ // не нужна.
gtk_main_quit();
}

// Пишем всякую чушь по событию
void hello(GtkWidget *widget, gpointer data)
{
g_print ("%s was pressedn", (char *) data);
}

// Обратываем попытку
// Закрытия окна нажатием "крестика" в заголовке
gint delete_event( GtkWidget *widget, GdkEvent *event, gpointer data)
{
g_print ("delete event occurredn"); 
return FALSE;
}

/* Обрабатываем нажатие "Ok" в диалоге выбора файла для открытия. */
gint open_ok_button_event(
GtkWidget *widget,
GdkEvent *event,
gpointer data)
{
int rval;
void *cbuffer = calloc(512,sizeof(char));
GtkTextIter iter; // Итератор текстового буфера
pid_t child_pid;

if (file_name != NULL)  g_free(file_name);

/* Грабим имя файла из диалога. */
file_name = gtk_file_selection_get_filename (
GTK_FILE_SELECTION (file_open));

/* Сообщаем чего награбили. */
g_print ("Selected file %sn", file_name);

/* Открываем файл. */
workfile = open (file_name, O_RDWR);
if(workfile == -1) {
g_print ("Error open %sn", file_name);
return FALSE;
}

/* Устанавливаем итератор на начало текста. */
gtk_text_buffer_get_start_iter (buffer, &iter);

/* Читаем из файла пишем в буфер. */
while ((rval = read(workfile, cbuffer, 512)) != 0)
{
gtk_text_buffer_insert_with_tags_by_name (
buffer, &iter, cbuffer, rval,
"monospace_big_bold",
NULL);
}

free (cbuffer);
return FALSE;
}

/* Обрабатываем нажатие кнопки "Открыть" меню. */
gint open_event( GtkWidget *widget, GdkEvent *event, gpointer data)
{
g_print ("Open file widget call.n");

/* Открываем диалог. */
file_open = gtk_file_selection_new ("Open file...");

/* Подключаем обработчик нажатия кнопки "Ok" в диалоге. */
g_signal_connect (
G_OBJECT(GTK_FILE_SELECTION(file_open)->ok_button),
"clicked", G_CALLBACK(open_ok_button_event),
NULL);

g_signal_connect_swapped (
G_OBJECT (GTK_FILE_SELECTION(file_open)->ok_button),
"clicked", G_CALLBACK(gtk_widget_destroy),
G_OBJECT (file_open));

g_signal_connect_swapped (
G_OBJECT (GTK_FILE_SELECTION(file_open)->cancel_button),
"clicked", G_CALLBACK(gtk_widget_destroy),
G_OBJECT (file_open));

gtk_widget_show (file_open);

return FALSE;
}

/* Обрабатываем нажатие кнопки "Ok" в диалоге "Сохранить как". */
gint save_ok_button_event(
GtkWidget *widget,
GdkEvent *event,
gpointer data)
{
gchar *cbuffer;
GtkTextIter start, end;

if (file_name != NULL) g_free(file_name);

/* Грабим имя файла. */
file_name = gtk_file_selection_get_filename(
GTK_FILE_SELECTION (file_open));

/* Выводим чего награбили. */
g_print ("Selected file %sn", file_name);

/* Создаем файлик. */
workfile = open (file_name, O_CREAT | O_RDWR, S_IRUSR | S_IWUSR);
if(workfile == -1) {
g_print ("Error open %sn", file_name);
return FALSE;
}

/* Определяем начало и конец текста. Копируем текст в буффер. */
gtk_text_buffer_get_bounds (buffer, &start, &end);
cbuffer = gtk_text_buffer_get_text (buffer, &start, &end, TRUE);

/* Курсор на начало файла. Отрезаем лишнее. Сохраняем. */
lseek(workfile,0,0);
truncate(workfile, 0);
write(workfile, cbuffer, strlen(cbuffer));

/* Сколько на сохраняли. */
g_print("Writed %d bytes.n", strlen(cbuffer));

g_free (cbuffer);
return FALSE;
}

/* Обрабатываем нажатие "Сохранить" и "Сохранить как". */
gint save_event( GtkWidget *widget, GdkEvent *event, gpointer data)
{
gchar *cbuffer;
GtkTextIter start, end;

if ((workfile == -1) || ((char *) data)=="as") {
/* Открываем диалог. */
file_open = gtk_file_selection_new ("Save file as...");

/* Подключаем обработчик нажатия кнопки "Ok" в диалоге. */
g_signal_connect (
G_OBJECT(GTK_FILE_SELECTION(file_open)->ok_button),
"clicked", G_CALLBACK(save_ok_button_event),
NULL);

g_signal_connect_swapped (
G_OBJECT (GTK_FILE_SELECTION(file_open)->ok_button),
"clicked", G_CALLBACK(gtk_widget_destroy),
G_OBJECT (file_open));

g_signal_connect_swapped (
G_OBJECT (GTK_FILE_SELECTION(file_open)->cancel_button),
"clicked", G_CALLBACK(gtk_widget_destroy),
G_OBJECT (file_open));

gtk_widget_show (file_open);
return FALSE;
}

/* Определяем начало и конец текста. Копируем текст в буфер. */
gtk_text_buffer_get_bounds (buffer, &start, &end);
cbuffer = gtk_text_buffer_get_text(buffer, &start, &end, TRUE);

/* Курсор на начало файла. Отрезаем лишнее. Сохраняем. */
lseek(workfile,0,0);
truncate(workfile, 0);
write(workfile, cbuffer,strlen(cbuffer));

/* Сколько на сохраняли. */
g_print("Writed %d bytes.n", strlen(cbuffer));

g_free (cbuffer);
return FALSE;
}

/* Создаем окно и основные виджеты. */
int make_main_window()
{
/* Создаем окно. Устанавливаем размер. */
window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
gtk_window_set_default_size (GTK_WINDOW (window),400,400);

/* Устанавливаем заголовок окна. И бордюр. */
gtk_window_set_title (GTK_WINDOW (window),
"Out Cool Text Editor");

gtk_container_set_border_width (GTK_CONTAINER (window), 5);

/* Подключаем сигналы. */
g_signal_connect(G_OBJECT(window), "delete_event",
G_CALLBACK (delete_event), NULL);

g_signal_connect(G_OBJECT(window), "destroy",
G_CALLBACK (destroy), NULL);

/* Вертикальная коробка. */
ver_box = gtk_vbox_new(FALSE, 0);

/* Меню бар. */
menu_bar = gtk_menu_bar_new ();

/* Пакуем меню бар в коробку. И показываем его всем. */
gtk_box_pack_start (GTK_BOX (ver_box), menu_bar, FALSE, TRUE, 0);
gtk_widget_show (menu_bar);

/* Собственно меню "Файл". */
file_menu = gtk_menu_new();

/* Создаем элементы меню "Файл". */
open_item = gtk_menu_item_new_with_label ("Open");
save_item = gtk_menu_item_new_with_label ("Save");
save_as_item = gtk_menu_item_new_with_label ("Save as");
quit_item = gtk_menu_item_new_with_label ("Quit");

/* Пакуем элементы меню "Файл" в меню "Файл". */
gtk_menu_shell_append (GTK_MENU_SHELL (file_menu), open_item);
gtk_menu_shell_append (GTK_MENU_SHELL (file_menu), save_item);
gtk_menu_shell_append (GTK_MENU_SHELL (file_menu), save_as_item);
gtk_menu_shell_append (GTK_MENU_SHELL (file_menu), quit_item);

/* Подключаем к ним события. */
g_signal_connect (G_OBJECT (open_item), "activate",
G_CALLBACK (open_event), NULL);

g_signal_connect (G_OBJECT (save_item), "activate",
G_CALLBACK (save_event), NULL);

g_signal_connect (G_OBJECT (save_as_item), "activate",
G_CALLBACK (save_event), (gpointer) "as");

g_signal_connect_swapped (G_OBJECT (quit_item), "activate",
G_CALLBACK (gtk_main_quit), G_OBJECT(window));

/* Показываем элементы меню "Файл". */
gtk_widget_show(open_item);
gtk_widget_show(save_item);
gtk_widget_show(save_as_item);
gtk_widget_show(quit_item);

/* Создаем верхний элемент меню "Файл". */
file_item = gtk_menu_item_new_with_label ("File");
gtk_widget_show (file_item);

/* Подключаем к верхниму элементу меню. А его в меню бару. */
gtk_menu_item_set_submenu (GTK_MENU_ITEM (file_item), file_menu);
gtk_menu_bar_append (GTK_MENU_BAR(menu_bar), file_item);

/*Повторяем для меню "Помощь" теже действия,что и для меню "Файл"*/
help_menu = gtk_menu_new();

help_item = gtk_menu_item_new_with_label ("Help");
about_item = gtk_menu_item_new_with_label ("About");

gtk_menu_shell_append (GTK_MENU_SHELL (help_menu), help_item);
gtk_menu_shell_append (GTK_MENU_SHELL (help_menu), about_item);

g_signal_connect (G_OBJECT (help_item), "activate",
G_CALLBACK (hello), (gpointer) "Help Menu/Help");

g_signal_connect (G_OBJECT (about_item), "activate",
G_CALLBACK (hello), (gpointer) "Help Menu/About");

gtk_widget_show(help_item);
gtk_widget_show(about_item);

help_top_item = gtk_menu_item_new_with_label ("Help");
gtk_widget_show (help_top_item);

gtk_menu_item_set_submenu (
GTK_MENU_ITEM (help_top_item),
help_menu);

gtk_menu_bar_append (GTK_MENU_BAR(menu_bar), help_top_item);

/* Создаем окно с прокруткой. */
scroll_window = gtk_scrolled_window_new (NULL, NULL);
gtk_scrolled_window_set_policy (
GTK_SCROLLED_WINDOW (scroll_window),
GTK_POLICY_AUTOMATIC,
GTK_POLICY_AUTOMATIC);

/* Создаем окно редактирования. */
text_view = gtk_text_view_new ();

/* Вытаскием из редактора буфер. */
buffer = gtk_text_view_get_buffer (GTK_TEXT_VIEW (text_view));

/* Создаем тэг для текста. Моноширный, жирный и крупный. */
gtk_text_buffer_create_tag (buffer, "monospace_big_bold",
"family", "monospace",
"size", 20 * PANGO_SCALE,
"weight", PANGO_WEIGHT_BOLD,
NULL);

/* Засовываем текстовое окно в окно с прокруткой. */
gtk_container_add (GTK_CONTAINER (scroll_window), text_view);
gtk_widget_show (text_view);

/* Пакуем окно с прокруткой в коробку. */
gtk_box_pack_start (GTK_BOX (ver_box),scroll_window,TRUE,TRUE,0);
gtk_widget_show (scroll_window);

/* Коробку пакуем в главное окно. */
gtk_container_add(GTK_CONTAINER (window), ver_box);

/* Показываем, что наваяли. */
gtk_widget_show(ver_box);
gtk_widget_show(window);
return 0;
}

int main(int argc, char *argv[])
{
gtk_init (&argc, &argv);

make_main_window();

gtk_main();

return 0;
}

Для тех кто это дочитал до конца:
описание API
тутор GTK+ 2
среда разработки графических интерфейсов на GTK.

Снимок Glade:
(КАРТИНКА)

Версия для печати
Обсудить на форуме