<< Предыдущая Содержание Следующая >>
GNOME и GTK+ соотносятся между собой примерно так же, как KDE и Qt, с той разницей, что разработчики открытых сообществ GNOME и GTK+ всегда лучше взаимодействовали между собой, чем разработчики открытой оболочки KDE и не совсем открытого инструментария Qt.
Если вы стоите перед выбором, - использовать ли в своей программе только визуальные компоненты GTK+, или же добавить к ним расширения GNOME, соображения в пользу каждого варианта будут примерно такими же, что и при выборе между «чистым» Qt и KDE. Компоненты GNOME могут сделать больше (правда, ненамного больше), чем компоненты GTK+, но GNOME – это не просто набор виджетов, а оболочка, тк что программа, использующая возможности GNOME, сможет работать только на том компьютере, где установлена эта оболочка. В то же время программы, основанные на GTK+, могут быть перенесены в такие среды, где гномы не водятся, - например, на платформу Windows. Впрочем, говоря о том, что нет GNOME для Windows, я не совсем прав. Портирование GNOME под Windows выполняется в рамках проекта Cygwin. Однако нельзя сказать, чтобы CyGNOME был популярен среди пользователей Windows. Так что и желающих установить его ради одной вашей программы найдется немного.
В то время как в тандеме Qt/KDE практически каждому компоненту Qt соответствует свой компонент KDE, компоненты GTK+ и GNOME почти не дублируют друг друга. К богатому набору GTK+ GNOME добавляет в основном те компоненты, которые требуются для написания программ, взаимодействующих с оболочкой GNOME.
Среда GNOME включает в себя несколько разделяемых библиотек, с которыми связываются исполнимые файлы приложений GNOME. Важнейшими из этих библиотек являются две – libgnome (известная в документации как GNOME Library) и libgnomeui (в документации она значится под именем GNOME UI Library). Библиотека libgnome экспортирует базовые функции, необходимые для инициализации GNOME-программы, конфигурации программ GNOME и интернационализации. Кроме того, библиотека libgnome предоставляет в распоряжение программиста несколько функций для решения таких задач, как, например, отображение встроенной справки и работа со звуком. Библиотека libgnomeui экспортирует функции, обеспечивающие работу дополнительных визуальных элементов GNOME.
Наша первая программа для GNOME (файл openurl.c) не так уж сильно отличается от простой программы GTK+:
#include <gnome.h>
void button_clicked(GtkWidget * button, gpointer data)
{
GtkEntry * entry = data;
GError * error = NULL;
const char * url = gtk_entry_get_text(entry);
if (!gnome_url_show(url, &error)) {
g_print("%s\n", error->message);
g_error_free(error);
}
}
gint delete_event(GtkWidget *widget, GdkEvent *event, gpointer data)
{
gtk_main_quit();
return FALSE;
}
int main(int argc, char * argv[])
{
GnomeProgram * gnome_prog;
GtkWidget * mainwnd;
GtkWidget * hbox;
GtkWidget * button;
GtkWidget * entry;
gnome_prog = gnome_program_init("openurl", "0.1", LIBGNOMEUI_MODULE,
argc, argv, NULL, NULL);
mainwnd = gnome_app_new ("openurl", "Открыть URL");
gtk_signal_connect (GTK_OBJECT (mainwnd), "delete_event",
GTK_SIGNAL_FUNC(delete_event), NULL);
hbox = gtk_hbox_new (FALSE,5);
entry = gtk_entry_new();
gtk_box_pack_start (GTK_BOX(hbox), entry, TRUE, TRUE, 0);
button = gtk_button_new_with_label("Открыть");
gtk_signal_connect (GTK_OBJECT (button), "clicked",
GTK_SIGNAL_FUNC (button_clicked), entry);
gtk_box_pack_start (GTK_BOX(hbox), button, FALSE, FALSE, 0);
gnome_app_set_contents (GNOME_APP (mainwnd), hbox);
gtk_widget_show_all(mainwnd);
gtk_main ();
return 0;
}
Прежде чем разбирать исходный текст программы, полезно узнать, что она делает. Окно
программы openurl (рис. 1) содержит строку ввода и кнопку. Если ввести в строке
ввода ссылку URL, а затем щелкнуть кнопку мышью, программа запустит соответствующий
внешний Интернет-клиент, и передаст ему введенную URL. Под «соответствующим Интернет-клиентом»
в данном случае понимается клиентская программа, которая назначена в вашей системе
для обработки указанного в URL Интернет-протокола (HTTP, FTP и т.д.) по умолчанию.
Информацию о том, какую именно программу нужно запустить для обработки той или иной
ссылки URL программа openurl получает из настроек GNOME, так что если программа
не может открыть ссылку какого-то типа, проверьте, назначен ли для соответствующего
протокола клиент по умолчанию. Пошаговый разбор программы openurl мы начнем с заголовочного
файла. Хотя наша программа использует функции библиотек libgnome, libgnomeui и,
конечно, GTK+, нам достаточно включить в исходный текст один заголовочный файл -
Рисунок 1. Простоая программа GNOME
Функция gnome_program_init() возвращает указатель на объект GnomeProgram. Этот объект содержит много полезной информации о запускаемой GNOME-программе, но обращаться к нему мы далее не будем. После того, как все нужные нам библиотеки GNOME инициализированы, мы можем приступить к созданию интерфейса программы. Конструирование интерфейса мы начнем с главного окна, которое создается функцией gnome_app_new(). Первым аргументом этой функции должно быть имя программы, вторым аргументом – заголовок главного окна. Функция возвращает указатель на объект GnomeApp, который, вопреки своему названию, является всего лишь улучшенным вариантом (и потомком) объекта GtkWindow. Назначение обработчика события delete_event, создание контейнера для горизонтальной упаковки дочерних элементов, создание и упаковка самих элементов GtkEntry (строка ввода) и GtkButton (кнопка), так же как и назначение обработчика сигнала clicked кнопки, должны быть вам хорошо знакомы и мы их пропускаем. Функция gnome_app_set_contents() позволяет указать визуальный элемент, который будет отвечать за содержимое рабочей области главного окна программы. Первым аргументом функции gnome_app_set_contents() должен быть указатель на окно GnomeApp, вторым аргументом – указатель на его дочерний элемент, управляющий рабочей областью (в качестве такового в нашей программе выступает объект-контейнер hbox). Функция gtk_widget_show_all() является частью интерфейса GTK+, но мы с ней раньше не встречались, поэтому опишем ее подробнее. До сих пор мы делали каждый элемент управления программы видимым с помощью отдельного вызова gtk_widget_show(). Функция gtk_widget_show_all() позволяет «придать видимость» всем визуальным элементам программы за один вызов. Цикл обработки событий программы GNOME запускается с помощью функции gtk_main(), предоставляемой интерфейсом GTK+.
Перейдем теперь к обработчику сигнала clicked кнопки button - функции button_clicked(). В качестве дополнительного параметра функции-обработчику передается указатель на объект GtkEntry, из которого обработчик должен получить текст ссылки URL. Вся «магическая работа» по запуску внешней программы для обработки URL выполняется функцией gnome_url_show(). Первым параметром функции должна быть строка URL, второй параметр представляет собой указатель на указатель на структуру GError. Если в процессе обработки URL функцией gnome_url_show() возникла ошибка, функция создаст экземпляр структуры GError, и вернет указатель на него во втором параметре. При этом функция также вернет значение FALSE как результат вызова. Мы проверяем значение, возвращаемое gnome_url_show() и в случае возникновения ошибки распечатываем сообщение о ней (текст сообщения содержится в поле message структуры GError). Поскольку при возникновении ошибки каждый раз создается новый экземпляр структуры GError, мы должны удалять этот экземпляр с помощью функции g_error_free(), чтобы не заполнять оперативную память мусором. Обратите внимание, что функция gnome_url_show() следит за тем, чтобы переданная ей переменная-указатель на объект GError имела значение NULL. В противном случае функция может, немного-немало, досрочно завершить работу программы. Прежде чем вы начнете проверять, как работает программа openurl, необходимо сказать несколько слов о том, как функция gnome_url_show() обрабатывает переданные ей ссылки URL. Для того чтобы выбрать внешнюю программу для открытия ссылки URL, функция должна «знать» Интернет-протокол, который использует URL. Информацию о протоколе функция получает из префикса URL (http://, ftp:// и т.д.), поэтому, вводя URL в строке ввода программы, вы обязательно должны указывать префикс (если вы его не укажете, gnome_url_show() вернет сообщение об ошибке). Отметим так же, что ошибки, о которых может сообщить функция gnome_url_show(), относятся исключительно к синтаксису ссылки URL (но не к ресурсу, на который она ссылается). Как только функция находит программу, способную открыть данную URL, она запускает эту программу с текстом URL в качестве аргумента командной строки и возвращает управление. Вообще говоря, у нашей программы нет возможности проследить, чем закончилась работа программы, которую запустила функция gnome_url_show().
Компиляция и сборка программы для GNOME требуют дополнительных приготовлений. Лучше всего воспользоваться простым make-файлом. Рассмотрим фрагмент из make-файла, который вы найдете на диске (этот make-файл собирает все программы-примеры для этой статьи, а для того, чтобы собрать программу openurl, вы можете просто скомандовать “make openurl”):
CFLAGS =-g -Wall `pkg-config --cflags libgnome-2.0 libgnomeui-2.0`
LDFLAGS=`pkg-config --libs libgnome-2.0 libgnomeui-2.0`
Для генерации ключей компилятора и компоновщика мы вызываем утилиту pkg-config, указав ей пакеты libgnome-2.0 и libgnomeui-2.0. Теперь программу можно компилировать.
Запуск внешних Интернет-клиентов – далеко не все, на что способны программы GNOME (даже очень простые). В качестве примера более широких возможностей мы рассмотрим программу GNOME, способную запустить произвольно заданную программу. Наша вторая программа GNOME (ее исходный текст вы найдете в файле gnomeexec.c) похожа на первую (рис. 2). Введите имя программы, которую вы хотите запустить и щелкните кнопку «Запуск». Если вы собираетесь запустить консольную программу, то можете установить флажок «Запустить в окне терминала» (в этом случае при запуске программы будет открыто окно терминала, используемое GNOME по умолчанию).
Рисунок 2. Запуск приложений из прошраммы GNOME
Главная проблема, с которой сталкивается программист, пишущий Unix-программу, которая должна запускать другие программы, - это проблема файловых дескрипторов. По умолчанию дочерний процесс наследует все дескрипторы, открытые родительским процессом. В графической системе GNOME, в которой каждая программа открывает множество служебных дескрипторов, в том числе для связи с сервером X и CORBA, разделение этих дескрипторов с новым процессом может вызвать проблемы у обеих программ. Запуская новую программу, программист должен быть уверен, что она не унаследует дескрипторы, которые должны принадлежать исключительно родительской программе. Если вы думаете, что далее я приведу пример закрытия дескрипторов (как в статьях по программированию Unix API), то ошибаетесь. Дело в том, что интерфейс программирования GNOME предоставляет в распоряжение программиста целое семейство функций, предназначенных для запуска программ из программ GNOME. Все проблемы, связанные с дескрипторами, эти функции решают за нас.
Всего в нашем распоряжении восемь функций интерфейса GNOME, позволяющих запустить внешнюю программу. Мы воспользуемся двумя - gnome_execute_shell() и gnome_execute_terminal_shell(). Эти функции позволяют запускать внешние программы с теми переменными среды окружения, которые установлены в оболочке, используемой пользователем по умолчанию. Функция gnome_execute_shell() просто запускает программу на исполнение, а функция gnome_execute_terminal_shell() сначала открывает окно терминала и уже в нем запускает программу. У обеих функций два аргумента – рабочая директория программы и строка запуска. Если в качестве первого аргумента функциям передать значение NULL, рабочей директорией новой программы станет рабочая директория программы-родителя.
Рассмотрим подробнее обработчик сигнала clicked, определенный в программе gnomeexec. Именно в этом обработчике выполняется запуск внешней программы:
GtkWidget * entry;
GtkWidget * check_button;
void button_clicked(GtkWidget * button, gpointer data)
{
const char * cmdline = gtk_entry_get_text(GTK_ENTRY(entry));
if (gtk_toggle_button_get_active(GTK_TOGGLE_BUTTON(check_button)))
gnome_execute_terminal_shell(NULL, cmdline);
else
gnome_execute_shell(NULL, cmdline);
}
В программе openurl обработчику требовались данные только одного элемента управления – строки ввода. В программе gnomeexec обработчик должен, помимо строки запуска программы, получить данные о состоянии флажка, который определяет, следует ли запускать программу в окне терминала. В качестве строки ввода мы используем все тот же объект GtkEntry. Кнопка-флажок реализована в GTK+ с помощью объекта GtkCheckButton. Таким образом, обработчик сигнала clicked должен получить информацию стразу о двух объектах. Для того чтобы оба объекта были доступны обработчику, мы объявляем переменные entry и check_button глобально, в области видимости обработчика и функции main(). Из объекта entry обработчик извлекает строку запуска программы. То, какая именно из функций запуска внешней программы будет использована, зависит от того, установлен ли флажок. Состояние флажка мы проверяем с помощью функции gtk_toggle_button_get_active() (объект GtkCheckButton является потомком объекта GtkToggleButton, который служит предком всех кнопок-переключателей). Если функция gtk_toggle_button_get_active() возвращает TRUE, значит, флажок установлен и мы запускаем внешнюю программу в окне терминала с помощью функции gnome_execute_terminal_shell(). Если функция gtk_toggle_button_get_active() возвращает значение FALSE, для запуска программы используется функция gnome_execute_shell().
В программе gnomeexec есть еще несколько строчек кода, заслуживающих вашего внимания. Мы привыкли к тому, что если в окне программы есть «главная» кнопка, выполняющая некое действие, то нажатие клавиши [Enter] равносильно щелчку мышью по этой кнопке. Работая с программой openurl, вы наверняка заметили, что эта программа игнорирует клавишу [Enter], так что кнопку «Открыть» приходится щелкать мышью. В окне, где сначала нужно ввести текст с клавиатуры, необходимость переключаться на мышь для щелчка по кнопке неудобна вдвойне. В программе gnomeexec мы исправляем этот недостаток (но прежде – небольшое лирическое отступление). Мы любим программирование за то, что оно позволяет нам реализовать наши творческие замыслы, м ненавидим его за разные неожиданные препятствия, которые оно возводит на нашем пути. Как заставить кнопку реагировать на нажатие [Enter]? Знатоки графических интерфейсов могут ожидать, что существует какая-нибудь функция gtk_button_set_default(), которая делает заданную кнопку «кнопкой по умолчанию». Но ничего подобного в GTK+ API нет. Чтобы заставить кнопку реагировать на клавишу [Enter], нам придется вызвать две функции и один макрос. Прежде всего, если в окне есть объект GtkEntry (а в окне gnomeexec он есть), этот объект по умолчанию перехватывает все события, связанные с клавиатурой. Для того чтобы объект GtkEntry мог передать обработку нажатия на клавишу [Enter] другим элементам управления окна, мы должны вызвать функцию gtk_entry_set_activates_default(). Далее, оказывается, что кнопка GtkButton по умолчанию не относится к числу объектов, способных (простите за каламбур) обрабатывать нажатие [Enter] по умолчанию. Мы, однако, можем наделить кнопку GtkButton этой способностью, если вызовем макрос GTK_WIDGET_SET_FLAGS() с константой GTK_CAN_DEFAULT:
GTK_WIDGET_SET_FLAGS (button, GTK_CAN_DEFAULT);
Макрос GTK_WIDGET_SET_FLAGS() позволяет устанавливать различные флаги, влияющие на свойства и поведение визуальных элементов. Только теперь мы можем вызвать функцию gtk_widget_grab_default(), которая заставит кнопку реагировать на нажатие [Enter] как на щелчок мышью. Справедливости ради стоит отметить, что при использовании окна, создаваемого объектом GtkDialog, определение «кнопок по умолчанию» упрощается. После того, как поведение кнопки приведено в соответствие с правилами хорошего интерфейса, мы можем собрать программу, скомандовав
make gnomeexec
Интернационализация приложений GNOME выполняется почти так же, как интернационализация
приложений GTK+ (в связи с чем полезно перечитать вторую статью этого цикла), однако
есть и небольшие отличия. В процессе интернационализации приложений GTK+ нам требовалось
самим определить несколько макросов. В заголовочных файлах GNOME эти макросы уже
определены, и повторное их определение приведет к выдаче предупреждающих сообщений
компилятором. В качестве примера мы выполним интернационализацию программы gnomeexec
(этот вариант программы вы найдете в файле gnomeexec-i18n.c). Никаких дополнительных
заголовочных файлов в текст программы включать не требуется – достаточно уже имеющегося
bindtextdomain (GETTEXT_PACKAGE, LOCALEDIR);
bind_textdomain_codeset (GETTEXT_PACKAGE, "UTF-8");
textdomain (GETTEXT_PACKAGE);
То же самое мы делали в процессе интернационализации программы GTK+. Макросы располагаются в самом начале функции main(), еще до вызова функции gnome_program_init(). Наш второй шаг заключается в пометке всех строк, предназначенных для перевода, макросом _(). В GTK+ мы определяли этот макрос сами, в GNOME он уже определен. Нашим третьим шагом должно быть определение констант-макросов GETTEXT_PACKAGE и LOCALEDIR. Поскольку для компиляции программы мы используем make-файлы, будет удобно разместить объявления этих макросов в make-файле. В результате исходный текст нашей программы вообще не будет содержать никаких определений макросов. В make-файл для сборки программы gnomeexec-i18n мы добавим строку
CFLAGS =-g -Wall `pkg-config --cflags
libgnome-2.0 libgnomeui-2.0` -DLOCALEDIR=\""./locale"\" -DGETTEXT_PACKAGE=\""gnomeexec-i18n"\"
-DENABLE_NLS
Помимо двух вышеуказанных констант мы включаем директиву условной компиляции ENABLE_NLS,
которая делает доступными все макросы и функции интернационализации, объявленные
в файлах, включенных в файл
Я признаю, что программы из этой статьи отличались довольно незамысловатым интерфейсом. Все дело в том, что мне лень вручную громоздить контейнеры друг на друга (даже если эти контейнеры - всего лишь объекты GTK+). Следующая статья этой серии расскажет вам, как создавать роскошные интерфейсы GNOME с помощью программ Glade и Anjuta.
<< Предыдущая Содержание Следующая >>
© 2006-2007 Андрей Боровский <anb @ symmetrica.net>