Наши партнеры

Библиотека сайта rus-linux.net

Возможности тулкита GTK+ и сопутствующих библиотек

Автор: А.Панин
Дата публикации: 3 декабря 2014 г.

Механизм для работы с файлами, содержащими пары ключ-значение

5. Пример использования

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

Размера и названия шрифта
Цвета шрифта
Режима переноса строк
Указания на необходимость открытия последнего открытого файла при запуске приложения

При этом для реализации возможности автоматического открытия последнего открытого файла при запуске приложения также производится сохранение полного пути к этому файлу.

Ввиду того, что приложение разработано исключительно в качестве примера, при формировании пути к файлу конфигурации используется функция для получения пути к директории для хранения временных файлов g_get_tmp_dir(). При разработке реального приложения следует использовать вместо нее функцию для получения пути к пользовательской директории для хранения файлов конфигурации g_get_user_config_dir().

Исходный код приложения представлен в Листинге 1, "Код приложения", а также находится в архиве gkeyfile.tar.gz вместе с файлом Makefile для упрощения сборки. Для лучшего понимания в коде используются комментарии. Особое внимание следует уделить функциям открытия файла конфигурации и чтения конфигурационных данных (application_open_config_file()), записи конфигурационных данных и закрытия файла конфигурации (application_close_config_file()), вывода значений параметров конфигурации приложения в диалоге для их редактирования (application_show_settings()), применения параметров конфигурации приложения (application_apply_settings()), сохранения параметров конфигурации приложения (application_save_settings()) и сохранения пути к последнему открытому файлу (application_save_opened_file()). Вы можете осуществить сборку приложения либо просто перейдя в директорию с извлеченным из архива файлом исходного кода и введя команду make, либо воспользовавшись следующей командой:

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

Листинг 1. Код приложения

#include <gtk/gtk.h>
#include <stdio.h>

/*Данные приложения*/
typedef struct {
	/*Объект приложения*/
	GtkApplication *app;
	/*Объект для хранения пар ключ-значение*/
	GKeyFile *keyfile;
	/*Путь к файлу конфигурации*/
	gchar *keyfilename;
	/*Путь к открытому текстовому файлу*/
	gchar *textfilename;
	/*Виджет основного окна приложения*/
	GtkWidget *mainwin; 
	/*Виджет кнопки выбора шрифта*/
	GtkWidget *font_selector;
	/*Виджет кнопки выбора цвета шрифта*/
	GtkWidget *color_selector;
	/*Виджет раскрывающегося меню для выбора режима переноса строк*/
	GtkWidget *wrap_selector;
	/*Виджет переключателя для активации функции автоматического открытия файла*/
	GtkWidget *openfile_selector;
	/*Виджет поля для редактирования текста*/
	GtkWidget *file_contents_textview;
	/*Виджет строки состояния*/
	GtkWidget *statusbar;
	/*Идентификатор последнего сообщения виджета строки состояния*/
	guint statusmsgid;
	/*Идентификатор контекста виджета строки состояния*/
	guint statusconid;
} appdata;

/*Функция для форматированного вывода сообщения средствами виджета строки состояния*/
static void application_log_action(appdata *data, const gchar *action)
{
	GDateTime *datetime;
	guint h, m, s;
	gchar *statusmsg;
		
	g_assert(data != NULL);
	g_assert(action != NULL);
	
	datetime = g_date_time_new_now_local();
	if (datetime != NULL) {
		/*Получение значений часов, минут и секунд*/
		h = g_date_time_get_hour(datetime);
		m = g_date_time_get_minute(datetime);
		s = g_date_time_get_second(datetime);
		/*Форматирование строки*/
		if (data->textfilename != NULL) {
			statusmsg = g_strdup_printf("%u%u:%u%u:%u%u: Файл %s %s", h/10, h%10, m/10, m%10, s/10, s%10, data->textfilename, action);
		} else {
			statusmsg = g_strdup_printf("%u%u:%u%u:%u%u: Файл %s", h/10, h%10, m/10, m%10, s/10, s%10, action);
		}
		/*Удаление предыдущей строки*/
		if (data->statusmsgid != 0) {
			gtk_statusbar_remove(GTK_STATUSBAR(data->statusbar), data->statusconid, data->statusmsgid);
		}
		/*Вывод строки*/
		data->statusmsgid = gtk_statusbar_push(GTK_STATUSBAR(data->statusbar), data->statusconid, statusmsg);
		/*Освобождение ресурсов*/
		g_free(statusmsg);
		g_date_time_unref(datetime);
	} 
}

/*Функция для открытия файла конфигурации*/
static gboolean application_open_config_file(appdata *data)
{
	gchar *configdir;
	
	g_assert(data != NULL);
	
	data->keyfile = NULL;
	data->keyfilename = NULL;
	
	/*Формирование пути к директории для хранения файла конфигурации*/
	configdir = g_build_path(G_DIR_SEPARATOR_S, g_get_tmp_dir(), "GKeyFileTest", NULL);
	
	/*Проверка наличия директории и ее создание при необходимости*/
	if (!g_file_test((const gchar *)configdir, G_FILE_TEST_IS_DIR)) {
		if (g_mkdir_with_parents(configdir, 0755) == -1) {
			g_warning("Не удалось создать директорию для сохранения файла конфигурации\n");
			g_free(configdir);
			return FALSE;
		}
	}
	/*Создание объекта типа GKeyFile и формирование пути к файлу конфигурации*/
	data->keyfile = g_key_file_new();
	data->keyfilename = g_build_filename(configdir, "settings.conf", NULL);
	g_free(configdir);
	
	/*Загрузка данных из файла на диске в случае наличия файла*/
	g_key_file_load_from_file(data->keyfile, (const gchar *)data->keyfilename, G_KEY_FILE_NONE, NULL);
	
	return TRUE;
}

/*Функция для записи данных конфигурации на диск и закрытия файла конфигурации*/
static gboolean application_close_config_file(appdata *data)
{
	gchar *contents;
	gsize length;
	GError *error;
	
	g_assert(data != NULL);
	
	if ((data->keyfile == NULL) || (data->keyfilename == NULL)) return FALSE;
	
	error = NULL;
	/*Получение строкового представления файла конфигурации*/
	contents = g_key_file_to_data(data->keyfile, &length, &error);
	
	if (contents == NULL) {
		g_warning("Не удалось получить строковоеое представление файла конфигурации: %s\n", error->message);
		g_error_free(error);
		g_free(data->keyfilename);
		g_key_file_free(data->keyfile);
		return FALSE;
	}
	/*Уничтожение объекта типа GKeyFile*/
	g_key_file_free(data->keyfile);
	
	/*Запись строкового представления файла конфигурации в файл на диске*/
	if (!g_file_set_contents((const gchar *)data->keyfilename, (const gchar *)contents, (gssize)length, &error)) {
		g_warning("Не удалось записать строковое представление файла конфигурации на диск: %s\n", error->message);
		g_error_free(error);
		g_free(contents);
		g_free(data->keyfilename);
		return FALSE;
	}
	/*Освобождение ресурсов*/
	g_free(contents);
	g_free(data->keyfilename);
	
	return TRUE;
}

/*Функция для вывода установленных значений в диалоге для редактирования параметров конфигурации приложения*/ 
static void application_show_settings(appdata *data) 
{ 
	gchar *strvalue; 
	gint intvalue; 
	gboolean boolvalue; 
	GdkRGBA rgba; 
		 
	g_assert(data != NULL); 
	 
	if (data->keyfile == NULL) return; 
	/*Получение и вывод описания шрифта*/ 
	strvalue = g_key_file_get_string(data->keyfile, "settings", "font", NULL); 
	if (strvalue != NULL) { 
		gtk_font_button_set_font_name(GTK_FONT_BUTTON(data->font_selector), (const gchar *)strvalue); 
		g_free(strvalue); 
	} 
	/*Получение и вывод описания цвета шрифта*/ 
	strvalue = g_key_file_get_string(data->keyfile, "settings", "color", NULL); 
	if (strvalue != NULL) { 
		if (gdk_rgba_parse(&rgba, (const gchar *)strvalue)) { 
			gtk_color_chooser_set_rgba(GTK_COLOR_CHOOSER(data->color_selector), (const GdkRGBA *)&rgba); 
		} 
		g_free(strvalue); 
	} 
	/*Получение и вывод идентификатора режима переноса строк*/ 
	intvalue = g_key_file_get_integer(data->keyfile, "settings", "wrap", NULL); 
	if ((intvalue <= 3) && (intvalue >= 0)) { 
		gtk_combo_box_set_active(GTK_COMBO_BOX(data->wrap_selector), intvalue); 
	} else { 
		gtk_combo_box_set_active(GTK_COMBO_BOX(data->wrap_selector), 0); 
	} 
	/*Получение и вывод флага автоматического открытия файла*/ 
	boolvalue = g_key_file_get_boolean(data->keyfile, "settings", "openlast", NULL); 
	gtk_switch_set_active(GTK_SWITCH(data->openfile_selector), boolvalue); 
}

/*Функция для применения параметров конфигурации приложения*/ 
static void application_apply_settings(appdata *data, gboolean initialization) 
{ 
	gchar *strvalue; 
	gint intvalue; 
	gboolean boolvalue; 
	PangoFontDescription *fontdesc; 
	GdkRGBA rgba; 
	gchar *contents; 
	gsize length; 
	GtkTextBuffer *buffer; 
		 
	g_assert(data != NULL); 
	 
	if (data->keyfile == NULL) return; 
	/*Получение и применение описания шрифта*/ 
	strvalue = g_key_file_get_string(data->keyfile, "settings", "font", NULL); 
	if (strvalue != NULL) { 
		fontdesc = pango_font_description_from_string(strvalue); 
		if (fontdesc != NULL) { 
			gtk_widget_override_font(data->file_contents_textview, fontdesc); 
			pango_font_description_free(fontdesc); 
		} 
		g_free(strvalue); 
	} 
	/*Получение и применение описания цвета шрифта*/ 
	strvalue = g_key_file_get_string(data->keyfile, "settings", "color", NULL); 
	if (strvalue != NULL) { 
		if (gdk_rgba_parse(&rgba, (const gchar *)strvalue)) { 
			gtk_widget_override_color(data->file_contents_textview, GTK_STATE_FLAG_NORMAL, &rgba); 
		} 
		g_free(strvalue); 
	} 
	/*Получение и применение идентификатора переноса строк*/ 
	intvalue = g_key_file_get_integer(data->keyfile, "settings", "wrap", NULL); 
	switch (intvalue) { 
		case 0: 
			gtk_text_view_set_wrap_mode(GTK_TEXT_VIEW(data->file_contents_textview), GTK_WRAP_WORD); 
			break; 
		case 1: 
			gtk_text_view_set_wrap_mode(GTK_TEXT_VIEW(data->file_contents_textview), GTK_WRAP_CHAR); 
			break; 
		case 2: 
			gtk_text_view_set_wrap_mode(GTK_TEXT_VIEW(data->file_contents_textview), GTK_WRAP_WORD_CHAR); 
			break; 
		case 3: 
			gtk_text_view_set_wrap_mode(GTK_TEXT_VIEW(data->file_contents_textview), GTK_WRAP_NONE); 
			break; 
		default: 
			gtk_text_view_set_wrap_mode(GTK_TEXT_VIEW(data->file_contents_textview), GTK_WRAP_WORD); 
			break; 
	} 
	/*Получение флага автоматического открытия файла и открытие файла в случае запуска приложения*/ 
	boolvalue = g_key_file_get_boolean(data->keyfile, "settings", "openlast", NULL); 
	if ((initialization) && (boolvalue)) { 
		/*Получение пути к последнему открытому файлу*/ 
		data->textfilename = g_key_file_get_string(data->keyfile, "settings", "lastfile", NULL); 
		if (data->textfilename != NULL) { 
			/*Загрузка и вывод содержимого файла*/ 
			if (g_file_get_contents((const gchar *)data->textfilename, &contents, &length, NULL)) { 
				buffer = gtk_text_view_get_buffer(GTK_TEXT_VIEW(data->file_contents_textview)); 
				gtk_text_buffer_set_text(buffer, (const gchar *)contents, length); 
				g_free(contents); 
				/*Вывод сообщения об открытии файла*/ 
				application_log_action(data, "открыт автоматически"); 
			} 
		} 
	} 
}

/*Функция для сохранения параметров конфигурации приложения*/ 
static void application_save_settings(GtkDialog *dialog, gint response_id, gpointer user_data) 
{ 
	appdata *data; 
	GdkRGBA rgba; 
	gchar *strvalue; 
		 
	g_assert(user_data != NULL); 
	 
	data = (appdata *)user_data; 
		 
	if (data->keyfile != NULL) { 
		/*Сохранение описания шрифта*/ 
		strvalue = (gchar *)gtk_font_button_get_font_name(GTK_FONT_BUTTON(data->font_selector)); 
		if (strvalue != NULL) { 
			g_key_file_set_string(data->keyfile, "settings", "font", strvalue); 
		} 
		/*Сохранение описания цвета шрифта*/ 
		gtk_color_chooser_get_rgba(GTK_COLOR_CHOOSER(data->color_selector), &rgba); 
		strvalue = gdk_rgba_to_string((const GdkRGBA *)&rgba); 
		if (strvalue != NULL) { 
			g_key_file_set_string(data->keyfile, "settings", "color", strvalue); 
			g_free(strvalue); 
		} 
		/*Сохранение идентификатора режима переноса строк*/ 
		g_key_file_set_integer(data->keyfile, "settings", "wrap", gtk_combo_box_get_active(GTK_COMBO_BOX(data->wrap_selector))); 
		/*Сохранение флага открытия последнего открытого файла при запуске приложения*/ 
		g_key_file_set_boolean(data->keyfile, "settings", "openlast", gtk_switch_get_active(GTK_SWITCH(data->openfile_selector)));	 
		/*Применение параметров конфигурации приложения*/ 
		application_apply_settings(data, FALSE); 
	} 
	/*Уничтожение окна диалога для редактирования параметров конфигурации приложения*/ 
	gtk_widget_destroy(GTK_WIDGET(dialog)); 
}

/*Функция для сохранения пути к последнему открытому файлу*/ 
static void application_save_opened_file(appdata *data) 
{ 
	g_assert(data != NULL); 
	g_assert(data->textfilename != NULL); 
	 
	if (data->keyfile != NULL) { 
		g_key_file_set_string(data->keyfile, "settings", "lastfile", data->textfilename); 
	} 
}

/*Функция для завершения работы приложения*/ 
static void application_quit(GtkToolButton *toolbutton, gpointer user_data) 
{ 
	appdata *data; 
	 
	g_assert(user_data != NULL); 
	 
	data = (appdata *)user_data; 
	 
	g_application_quit(G_APPLICATION(data->app));	 
}

/*Функция для создания диалога для редактирования параметров конфигурации приложения*/ 
static void application_preferences(GtkToolButton *toolbutton, gpointer user_data) 
{ 
	appdata *data; 
	GtkWidget *dialog, *content; 
	GtkGrid *grid; 
	GtkWidget *label; 
	 
	g_assert(user_data != NULL); 
	 
	data = (appdata *)user_data; 
	 
	/*Создание диалога для редактирования параметров конфигурации приложения*/ 
	dialog = gtk_dialog_new_with_buttons("Параметры", 
										GTK_WINDOW(data->mainwin), 
										GTK_DIALOG_MODAL|GTK_DIALOG_DESTROY_WITH_PARENT, 
										"Закрыть", 
										GTK_RESPONSE_NONE, 
										NULL); 
	 
	content = gtk_dialog_get_content_area(GTK_DIALOG(dialog)); 
	/*Создание сетки с виджетами для редактирования параметров конфигурации приложения*/ 
	grid = (GtkGrid *)gtk_grid_new(); 
	gtk_grid_set_row_spacing(grid, 5); 
	gtk_grid_set_column_spacing(grid, 5); 
	gtk_container_set_border_width(GTK_CONTAINER(grid), 10); 
	 
	label = gtk_label_new("Шрифт редактора"); 
	gtk_widget_set_halign(label, GTK_ALIGN_START); 
	gtk_grid_attach(grid, label, 0, 0, 1, 1); 
	 
	data->font_selector = gtk_font_button_new(); 
	gtk_grid_attach(grid, data->font_selector, 1, 0, 1, 1); 
	 
	label = gtk_label_new("Цвет символов"); 
	gtk_widget_set_halign(label, GTK_ALIGN_START); 
	gtk_grid_attach(grid, label, 0, 1, 1, 1); 
	 
	data->color_selector = gtk_color_button_new(); 
	gtk_grid_attach(grid, data->color_selector, 1, 1, 1, 1); 
	 
	label = gtk_label_new("Разрывы строк"); 
	gtk_widget_set_halign(label, GTK_ALIGN_START); 
	gtk_grid_attach(grid, label, 0, 2, 1, 1); 
	 
	data->wrap_selector = gtk_combo_box_text_new(); 
	gtk_combo_box_text_append_text(GTK_COMBO_BOX_TEXT(data->wrap_selector), "По словам"); 
	gtk_combo_box_text_append_text(GTK_COMBO_BOX_TEXT(data->wrap_selector), "По символам"); 
	gtk_combo_box_text_append_text(GTK_COMBO_BOX_TEXT(data->wrap_selector), "По символам и словам"); 
	gtk_combo_box_text_append_text(GTK_COMBO_BOX_TEXT(data->wrap_selector), "Не используются"); 
	gtk_grid_attach(grid, data->wrap_selector, 1, 2, 1, 1); 
	 
	label = gtk_label_new("Открывать последний файл"); 
	gtk_widget_set_halign(label, GTK_ALIGN_START); 
	gtk_grid_attach(grid, label, 0, 3, 1, 1); 
	 
	data->openfile_selector = gtk_switch_new(); 
	gtk_grid_attach(grid, data->openfile_selector, 1, 3, 1, 1); 
	/*Показ загруженных параметров конфигурации приложения*/ 
	application_show_settings(data); 
	/*Сигнал для сохранения параметров конфигурации приложения и уничтожения диалога*/ 
	g_signal_connect(dialog, "response", G_CALLBACK(application_save_settings), data); 
	/*Добавление сетки с виджетами в окно приложения и показ диалога*/ 
	gtk_container_add(GTK_CONTAINER(content), GTK_WIDGET(grid)); 
	gtk_widget_show_all(dialog); 
}

/*Функция для сохранения текстового файла*/
static void application_save_file(GtkToolButton *toolbutton, gpointer user_data)
{
	appdata *data;
	GtkWidget *dialog;
	GtkTextBuffer *buffer;
	GtkTextIter start, end;
	gchar *contents;
	GError *error;
	
	g_assert(user_data != NULL);
	
	data = (appdata *)user_data;
	
	if (data->textfilename == NULL) {
		/*Создание диалога сохранения файла*/
		dialog = gtk_file_chooser_dialog_new("Сохранить файл",
											GTK_WINDOW(data->mainwin),
											GTK_FILE_CHOOSER_ACTION_SAVE,
											"Отмена", GTK_RESPONSE_CANCEL,
											"Сохранить", GTK_RESPONSE_ACCEPT,
											NULL);
		
		gtk_file_chooser_set_do_overwrite_confirmation(GTK_FILE_CHOOSER(dialog), TRUE);
		gtk_file_chooser_set_current_name(GTK_FILE_CHOOSER(dialog), "file.txt");
		/*Получение пути к выбранному текстовому файлу*/
		if (gtk_dialog_run(GTK_DIALOG(dialog)) == GTK_RESPONSE_ACCEPT) {
			data->textfilename = gtk_file_chooser_get_filename(GTK_FILE_CHOOSER(dialog));
		}
		/*Уничтожение диалога*/
		gtk_widget_destroy(dialog);
	}
	
	if (data->textfilename != NULL) {
		/*Получение содержимого виджета поля для редактирования текста*/
		buffer = gtk_text_view_get_buffer(GTK_TEXT_VIEW(data->file_contents_textview));
		gtk_text_buffer_get_bounds(buffer, &start, &end);
		contents = gtk_text_buffer_get_text(buffer, (const GtkTextIter *)&start, (const GtkTextIter *)&end, FALSE);
		/*Запись полученных данных в файл на диск*/
		error = NULL;
		if (g_file_set_contents((const gchar *)data->textfilename, contents, -1, &error)) {
			/*Сохранение пути к текстовому файлу*/
			application_save_opened_file(data);
			/*Вывод сообщения о сохранении текстового файла*/
			application_log_action(data, "сохранен");
		} else if (error != NULL) {
			g_warning("Не удалось записать содержимое редактируемого текстового файла на диск: %s\n", error->message);
			g_error_free(error);
		}
		/*Освобождение использованной памяти*/
		g_free(contents);
	}
}

/*Функция для открытия текстового файла*/
static void application_open_file(GtkToolButton *toolbutton, gpointer user_data)
{
	appdata *data;
	GtkWidget *dialog;
	GtkTextBuffer *buffer;
	GtkTextIter start, end;
	gchar *contents;
	gsize length;
	GError *error;
		
	g_assert(user_data != NULL);
	
	data = (appdata *)user_data;
	
	/*Создание диалога открытия файла*/
	dialog = gtk_file_chooser_dialog_new("Открыть файл",
										GTK_WINDOW(data->mainwin),
										GTK_FILE_CHOOSER_ACTION_SAVE,
										"Отмена", GTK_RESPONSE_CANCEL,
										"Открыть", GTK_RESPONSE_ACCEPT,
										NULL);
	
	if (gtk_dialog_run(GTK_DIALOG(dialog)) == GTK_RESPONSE_ACCEPT) {
		if (data->textfilename != NULL) {
			g_free(data->textfilename);
		}
		/*Получение пути к выбранному текстовому файлу*/
		data->textfilename = gtk_file_chooser_get_filename(GTK_FILE_CHOOSER(dialog));
		/*Удаление содержимого поля для редактирования текста*/
		buffer = gtk_text_view_get_buffer(GTK_TEXT_VIEW(data->file_contents_textview));
		gtk_text_buffer_get_bounds(buffer, &start, &end);
		gtk_text_buffer_delete(buffer, &start, &end);
		/*Загрузка данных из файла с диска и размещение их в виджете поля для редактирования текста*/
		error = NULL;
		if (g_file_get_contents((const gchar *)data->textfilename, &contents, &length, &error)) {
			gtk_text_buffer_set_text(buffer, (const gchar *)contents, length);
			/*Сохранение пути к текстовому файлу*/
			application_save_opened_file(data);
			g_free(contents);
			/*Вывод сообщения об открытии текстового файла*/
			application_log_action(data, "открыт");
		} else if (error != NULL) {
			g_warning("Не удалось прочитать содержимое файла с диска: %s\n", error->message);
			g_error_free(error);
		}
	}
	/*Уничтожение диалога открытия файла*/
	gtk_widget_destroy(dialog);
}

/*Функция для создания нового текстового файла*/
static void application_new_file(GtkToolButton *toolbutton, gpointer user_data)
{
	appdata *data;
	GtkTextBuffer *buffer;
	GtkTextIter start, end;
		
	g_assert(user_data != NULL);
	
	data = (appdata *)user_data;
	
	/*Удаление устаревшего пути к текстовому файлу*/
	if (data->textfilename != NULL) {
		g_free(data->textfilename);
		data->textfilename = NULL;
	}
	/*Удаление содержимого виджета поля для редактирования текста*/
	buffer = gtk_text_view_get_buffer(GTK_TEXT_VIEW(data->file_contents_textview));
	gtk_text_buffer_get_bounds(buffer, &start, &end);
	gtk_text_buffer_delete(buffer, &start, &end);
	/*Вывод сообщения о создании текстового файла*/
	application_log_action(data, "создан");
}

/*Функция для создания главного окна приложения*/
static void application_activate(GtkApplication *application, gpointer user_data)
{
	appdata *data;
	GtkWidget *vbox;
	GtkWidget *toolbar;
	GtkToolItem *newtb, *opentb, *savetb, *septb1, *preftb, *septb2, *quittb;
	GtkWidget *scrollwin;
		
	g_assert(user_data != NULL);
	
	data = (appdata *)user_data;
	
	application_open_config_file(data);
	
	/*Создание главного окна*/
	data->mainwin = gtk_application_window_new(application);
	gtk_window_set_title(GTK_WINDOW(data->mainwin), "Пример использования класса GKeyFile");
	gtk_widget_set_size_request(data->mainwin, 600, 400);
	/*Создание контейнера для хранения элементов главного окна*/
	vbox = gtk_box_new(GTK_ORIENTATION_VERTICAL, 0);
	/*Создание панели инструментов и кнопок этой панели*/
	toolbar = gtk_toolbar_new();
	gtk_toolbar_set_style(GTK_TOOLBAR(toolbar), GTK_TOOLBAR_BOTH_HORIZ);
	
	newtb = gtk_tool_button_new(NULL, "Создать");
	gtk_tool_button_set_icon_name(GTK_TOOL_BUTTON(newtb), "document-new");
	gtk_tool_item_set_is_important(GTK_TOOL_ITEM(newtb), TRUE);
	g_signal_connect(newtb, "clicked", G_CALLBACK(application_new_file), data);
	gtk_toolbar_insert(GTK_TOOLBAR(toolbar), GTK_TOOL_ITEM(newtb), -1);
		
	opentb = gtk_tool_button_new(NULL, "Открыть");
	gtk_tool_button_set_icon_name(GTK_TOOL_BUTTON(opentb), "document-open");
	gtk_tool_item_set_is_important(GTK_TOOL_ITEM(opentb), TRUE);
	g_signal_connect(opentb, "clicked", G_CALLBACK(application_open_file), data);
	gtk_toolbar_insert(GTK_TOOLBAR(toolbar), GTK_TOOL_ITEM(opentb), -1);
	
	savetb = gtk_tool_button_new(NULL, "Сохранить");
	gtk_tool_button_set_icon_name (GTK_TOOL_BUTTON (savetb), "document-save");
	gtk_tool_item_set_is_important(GTK_TOOL_ITEM(savetb), TRUE);
	g_signal_connect(savetb, "clicked", G_CALLBACK(application_save_file), data);
	gtk_toolbar_insert(GTK_TOOLBAR(toolbar), GTK_TOOL_ITEM(savetb), -1);
	
	septb1 = gtk_separator_tool_item_new();
	gtk_toolbar_insert(GTK_TOOLBAR(toolbar), septb1, -1);
	
	preftb = gtk_tool_button_new(NULL, "Параметры");
	gtk_tool_button_set_icon_name(GTK_TOOL_BUTTON(preftb), "preferences-system");
	gtk_tool_item_set_is_important(GTK_TOOL_ITEM(preftb), TRUE);
	g_signal_connect(preftb, "clicked", G_CALLBACK(application_preferences), data);
	gtk_toolbar_insert(GTK_TOOLBAR(toolbar), GTK_TOOL_ITEM(preftb), -1);
	
	septb2 = gtk_separator_tool_item_new();
	gtk_toolbar_insert(GTK_TOOLBAR(toolbar), septb2, -1);
	
	quittb = gtk_tool_button_new(NULL, "Выход");
	gtk_tool_button_set_icon_name (GTK_TOOL_BUTTON (quittb), "application-exit");
	gtk_tool_item_set_is_important(GTK_TOOL_ITEM(quittb), TRUE);
	g_signal_connect(quittb, "clicked", G_CALLBACK(application_quit), data);
	gtk_toolbar_insert(GTK_TOOLBAR(toolbar), GTK_TOOL_ITEM(quittb), -1);
	
	gtk_box_pack_start(GTK_BOX(vbox), toolbar, FALSE, TRUE, 0); 
	/*Создание окна для прокрутки содержимого виджета поля для редактирования текста*/
	scrollwin = gtk_scrolled_window_new(NULL, NULL);
	gtk_scrolled_window_set_shadow_type(GTK_SCROLLED_WINDOW(scrollwin), GTK_SHADOW_IN);
	/*Создание виджета поля для редактирования текста*/
	data->file_contents_textview = gtk_text_view_new();
	gtk_container_add(GTK_CONTAINER(scrollwin), data->file_contents_textview);
	
	gtk_box_pack_start(GTK_BOX(vbox), scrollwin, TRUE, TRUE, 0);
	/*Создание виджета строки состояния*/
	data->statusbar = gtk_statusbar_new();
	data->statusmsgid = 0;
	data->statusconid = gtk_statusbar_get_context_id(GTK_STATUSBAR(data->statusbar), "GKeyFileTest");
	gtk_box_pack_start(GTK_BOX(vbox), data->statusbar, FALSE, TRUE, 0);
		
	gtk_container_add(GTK_CONTAINER(data->mainwin), GTK_WIDGET(vbox));
	/*Применение загруженных значений параметров конфигурации приложения*/
	application_apply_settings(data, TRUE);
	/*Показ главного окна приложения*/
	gtk_application_add_window(application, GTK_WINDOW(data->mainwin));
	gtk_widget_show_all(data->mainwin);
}

/*Функция, вызываемая перед завершением работы приложения*/
static void application_shutdown(GtkApplication *application, gpointer user_data)
{
	appdata *data;
		
	g_assert(user_data != NULL);
	
	data = (appdata *)user_data;
	/*Запись строкового представления файла конфигурации в файл на диск*/
	application_close_config_file(data);
}

int main(int argc, char **argv)
{
	appdata *data;
	gint res;
	
	/*Создание структуры для хранения данных приложения*/
	data = g_new0(appdata, 1);
	/*Создание объекта приложения*/
	data->app = gtk_application_new("org.gtk.GKeyFileTest", G_APPLICATION_FLAGS_NONE);
	/*Установка обработчиков основных сигналов объекта приложения*/
	g_signal_connect(data->app, "activate", G_CALLBACK(application_activate), data);
	g_signal_connect(data->app, "shutdown", G_CALLBACK(application_shutdown), data);
	/*Запуск основного цикла обработки событий приложения*/
	res = g_application_run(G_APPLICATION(data->app), 0, NULL);
	/*Освобождение памяти перед завершением работы приложения*/
	g_free(data);
	
	return res;
}

Как ясно из кода, данное приложение имеет графический интерфейс, но в случае использования класса GKeyFile вы вполне можете ограничиться интерфейсом командной строки, связывая ваше приложение с библиотекой GLib вместо GTK+ (в случае использования библиотеки GTK+ связывание с библиотекой GLib осуществляется автоматически). В случае связывания приложения с библиотекой GLib для его компиляции может использоваться следующая команда:

gcc `pkg-config --cflags --libs glib-2.0` <имя файла исходного кода> -o <имя исполняемого файла>

На иллюстрациях ниже представлены снимки главного окна приложения и диалога для редактирования значений параметров конфигурации приложения.

Рисунок 1. Главное окно приложения

Рисунок 2. Диалог для редактирования значений параметров конфигурации приложения

Заключение

Класс GKeyFile может вполне успешно применяться для хранения данных конфигурации приложений различных типов. В том случае, если ваше приложение использует небольшой объем данных конфигурации и вы хотите использовать простой и удобный механизм для хранения этих данных, класс GKeyFile является идеальным решением. Если же вам необходимо использовать множество уровней вложения наборов данных или вы желаете максимально интегрировать ваше приложение в окружение рабочего стола GNOME, вам следует ознакомиться со следующими статьями, так как в них будут описываться другие механизмы, которые могут использоваться для хранения данных конфигурации приложений на основе тулкита GTK+ и/или библиотеки GLib.

Следующая статья : Простой механизм разбора документов формата XML.