| Каталог документации / Раздел "Программирование, языки" / Оглавление документа |
| |
|
|
GTK+ 2.0 Tutorial |
||
|---|---|---|
|
Контейнерные виджеты (Container Widgets) |
||
Панели инструментов обычно используются для группировки некоторого числа виджетов, чтобы упростить настройку их вида и расположения. Обычно панель состоит из кнопок с изображениями и текстовыми ярлыками, но можно добавить и любой другой виджет на панель. Объекты на панели могут выравниваться горизонтально или вертикально, а кнопки могут отображаться с пиктограммами, текстовыми ярлыками или с тем и другим сразу.
GtkWidget *gtk_toolbar_new( void ); |
После создания панели в неё можно добавлять пункты (короткие текстовые строки) или элементы (любые виджеты). Чтобы описать пункт, нужен текстовый ярлык, пиктограмма, текст подсказки, текст расширенной подсказки и функция обратного вызова. Для прикрепления к панели пункта можно использовать функции:
GtkWidget *gtk_toolbar_append_item( GtkToolbar *toolbar,
const char *text,
const char *tooltip_text,
const char *tooltip_private_text,
GtkWidget *icon,
GtkSignalFunc callback,
gpointer user_data );
GtkWidget *gtk_toolbar_prepend_item( GtkToolbar *toolbar,
const char *text,
const char *tooltip_text,
const char *tooltip_private_text,
GtkWidget *icon,
GtkSignalFunc callback,
gpointer user_data );
|
Если Вы хотите использовать gtk_toolbar_insert_item(), единственный дополнительный параметр который должен быть определен - положение в которое пункт должен быть вставлен, выглядит это таким образом:
GtkWidget *gtk_toolbar_insert_item( GtkToolbar *toolbar,
const char *text,
const char *tooltip_text,
const char *tooltip_private_text,
GtkWidget *icon,
GtkSignalFunc callback,
gpointer user_data,
gint position );
|
Чтобы упростить добавку места между пунктами панели инструментов, вы можете использовать следующие функции:
void gtk_toolbar_append_space( GtkToolbar *toolbar );
void gtk_toolbar_prepend_space( GtkToolbar *toolbar );
void gtk_toolbar_insert_space( GtkToolbar *toolbar,
gint position );
|
Если требуется, ориентация панели инструментов и ее стиля может быть изменена "на лету" используя следующие функции:
void gtk_toolbar_set_orientation( GtkToolbar *toolbar,
GtkOrientation orientation );
void gtk_toolbar_set_style( GtkToolbar *toolbar,
GtkToolbarStyle style );
void gtk_toolbar_set_tooltips( GtkToolbar *toolbar,
gint enable );
|
Где аргумент orientation одно из двух значений GTK_ORIENTATION_HORIZONTAL или GTK_ORIENTATION_VERTICAL. Аргумент style используется для установки одного из возможных вариантов отображения пунктов на панели GTK_TOOLBAR_ICONS, GTK_TOOLBAR_TEXT или GTK_TOOLBAR_BOTH.
Чтобы показать некоторые дополнительные действия, которые могут быть сделаны с панелью инструментов, давайте рассмотрим следующую программу (мы прервем пример с некоторыми дополнительными объяснениями):
#include <gtk/gtk.h>
/* Эта функция подключается к кнопке Close или
* закрытию окна с помощью WM */
gint delete_event (GtkWidget *widget, GdkEvent *event, gpointer data)
{
gtk_main_quit ();
return FALSE;
}
|
Вышеупомянутое начало кажется наверняка знакомым, если это не первая ваша программа GTK. Дополнительно мы включили изображение (XPM picture) для всех кнопок.
GtkWidget* close_button; /* Эта кнопка создаёт сигнал для
* закрытия приложения */
GtkWidget* tooltips_button; /* включить/выключить (enable/disable) подсказки */
GtkWidget* text_button,
* icon_button,
* both_button; /* кнопка переключения стиля панели */
GtkWidget* entry; /* ввод текста для упаковки в какой нибудь виджет при отображении на панели */
|
Фактически не все вышеупомянутые виджеты необходимы здесь, но для более ясного понимания мы разместили их все вместе.
/* при переключении кнопки мы проверяем какой стиль был активным
* и делаем соответствующие установки
* ВНИМАНИЕ: панель передаётся как данные для обратного вызова! */
void radio_event (GtkWidget *widget, gpointer data)
{
if (GTK_TOGGLE_BUTTON (text_button)->active)
gtk_toolbar_set_style (GTK_TOOLBAR (data), GTK_TOOLBAR_TEXT);
else if (GTK_TOGGLE_BUTTON (icon_button)->active)
gtk_toolbar_set_style (GTK_TOOLBAR (data), GTK_TOOLBAR_ICONS);
else if (GTK_TOGGLE_BUTTON (both_button)->active)
gtk_toolbar_set_style (GTK_TOOLBAR (data), GTK_TOOLBAR_BOTH);
}
/* проверяем переключатель для включения/выключения подсказок */
void toggle_event (GtkWidget *widget, gpointer data)
{
gtk_toolbar_set_tooltips (GTK_TOOLBAR (data),
GTK_TOGGLE_BUTTON (widget)->active );
}
|
В зависимости от того какая кнопка нажата, будет вызвана одна из двух функций. Вам знакомо это, если вы уже использовали переключатели и кнопки выбора (radio buttons).
Из всего вышеперечисленного в объяснении нуждается только «удобный контейнер» (handle box). «Удобный контейнер» используется для упаковки виджетов, но отличается от обычных контейнеров. Различие заключается в том, что «удобный контейнер» может быть отсоединен от основного окна для произвольного позиционирования виджетов размещенных в нем (в пределах родительского окна). Обычно он используется для создания съёмных панелей инструментов.
/* панель будет размещена горизонтально с пиктограммами и текстом, * между пунктами будет промежуток в 5pxl * и всё это будет упаковано в handlebox */ toolbar = gtk_toolbar_new (); gtk_toolbar_set_orientation (GTK_TOOLBAR (toolbar), GTK_ORIENTATION_HORIZONTAL); gtk_toolbar_set_style (GTK_TOOLBAR (toolbar), GTK_TOOLBAR_BOTH); gtk_container_set_border_width (GTK_CONTAINER (toolbar), 5); gtk_toolbar_set_space_size (GTK_TOOLBAR (toolbar), 5); gtk_container_add (GTK_CONTAINER (handlebox), toolbar); |
То, что сделано выше, является прямой инициализацией виджета панели инструментов.
/* наш первый пункт кнопка <close> */
iconw = gtk_image_new_from_file ("gtk.xpm"); /* icon widget */
close_button =
gtk_toolbar_append_item (GTK_TOOLBAR (toolbar), /* наша панель */
"Close", /* ярлык кнопки */
"Closes this app", /* подсказка кнопки */
"Private", /* подробная подсказка */
iconw, /* icon widget */
GTK_SIGNAL_FUNC (delete_event), /* сигнал */
NULL);
gtk_toolbar_append_space (GTK_TOOLBAR (toolbar)); /* пробел после пункта */
|
В вышеупомянутом коде вы видите самый простой способ добавления кнопки на панель инструментов. Как раз перед добавлением нового пункта, мы должны сконструировать виджет изображения (image widget), чтобы служить изображением для этого пункта; этот шаг должен будет быть повторен для каждого нового пункта. Также мы добавляем пробел после пункта для избежания касания с ним других пунктов. Как вы видите, функция gtk_toolbar_append_item() возвращает указатель на вновь созданную кнопку, вы можете работать с ним как обычно.
/* создаём группу кнопок выбора */
iconw = gtk_image_new_from_file ("gtk.xpm");
icon_button = gtk_toolbar_append_element (
GTK_TOOLBAR (toolbar),
GTK_TOOLBAR_CHILD_RADIOBUTTON, /* тип элемента */
NULL, /* указатель на виджет */
"Icon", /* ярлык */
"Only icons in toolbar", /* подсказка */
"Private", /* расширенная подсказка */
iconw, /* пиктограмма */
GTK_SIGNAL_FUNC (radio_event), /* сигнал */
toolbar); /* данные сигнала */
gtk_toolbar_append_space (GTK_TOOLBAR (toolbar));
|
Для создания группы переключателей мы использовали gtk_toolbar_append_element. Фактически используя эту функцию можно легко добавлять пункты или пробелы (type = GTK_TOOLBAR_CHILD_SPACE или +GTK_TOOLBAR_CHILD_BUTTON). В создании других радио-кнопок для этой группы требуется указатель на предыдущую кнопку в группе, чтобы легко построить список кнопок (см. секцию Radio Buttons).
/* following radio buttons refer to previous ones */
iconw = gtk_image_new_from_file ("gtk.xpm");
text_button =
gtk_toolbar_append_element (GTK_TOOLBAR (toolbar),
GTK_TOOLBAR_CHILD_RADIOBUTTON,
icon_button,
"Text",
"Only texts in toolbar",
"Private",
iconw,
GTK_SIGNAL_FUNC (radio_event),
toolbar);
gtk_toolbar_append_space (GTK_TOOLBAR (toolbar));
iconw = gtk_image_new_from_file ("gtk.xpm");
both_button =
gtk_toolbar_append_element (GTK_TOOLBAR (toolbar),
GTK_TOOLBAR_CHILD_RADIOBUTTON,
text_button,
"Both",
"Icons and text in toolbar",
"Private",
iconw,
GTK_SIGNAL_FUNC (radio_event),
toolbar);
gtk_toolbar_append_space (GTK_TOOLBAR (toolbar));
gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (both_button), TRUE);
|
В конце мы должны установить статус одной из кнопок вручную (иначе, они все остаются в активном статусе, препятствуя нам переключаться между ними).
/* простая кнопка переключения */
iconw = gtk_image_new_from_file ("gtk.xpm");
tooltips_button =
gtk_toolbar_append_element (GTK_TOOLBAR (toolbar),
GTK_TOOLBAR_CHILD_TOGGLEBUTTON,
NULL,
"Tooltips",
"Toolbar with or without tips",
"Private",
iconw,
GTK_SIGNAL_FUNC (toggle_event),
toolbar);
gtk_toolbar_append_space (GTK_TOOLBAR (toolbar));
gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (tooltips_button), TRUE);
|
Переключатель создаётся очевидным способом (если вы уже знаете как создать кнопку выбора).
/* упаковываем виджет в панель и прикрепляем соответствующую подсказку */
entry = gtk_entry_new ();
gtk_toolbar_append_widget (GTK_TOOLBAR (toolbar),
entry,
"This is just an entry",
"Private");
/* отображаем созданное */
gtk_widget_show (entry);
|
Как вы видите, добавить любой виджет к панели инструментов достаточно просто. Однако вы должны помнить, что этот виджет нужно показать вручную (вопреки другим пунктам, которые будут показаны вместе с панелью инструментов).
/* выводим на экран всё сразу. */ gtk_widget_show (toolbar); gtk_widget_show (handlebox); gtk_widget_show (dialog); /* переходим в цикл ожидания событий */ gtk_main (); return 0; } |
Наша пиктограмма (XPM icon):
/* XPM */
static char * gtk_xpm[] = {
"32 39 5 1",
". c none",
"+ c black",
"@ c #3070E0",
"# c #F05050",
"$ c #35E035",
"................+...............",
"..............+++++.............",
"............+++++@@++...........",
"..........+++++@@@@@@++.........",
"........++++@@@@@@@@@@++........",
"......++++@@++++++++@@@++.......",
".....+++@@@+++++++++++@@@++.....",
"...+++@@@@+++@@@@@@++++@@@@+....",
"..+++@@@@+++@@@@@@@@+++@@@@@++..",
".++@@@@@@+++@@@@@@@@@@@@@@@@@@++",
".+#+@@@@@@++@@@@+++@@@@@@@@@@@@+",
".+##++@@@@+++@@@+++++@@@@@@@@$@.",
".+###++@@@@+++@@@+++@@@@@++$$$@.",
".+####+++@@@+++++++@@@@@+@$$$$@.",
".+#####+++@@@@+++@@@@++@$$$$$$+.",
".+######++++@@@@@@@++@$$$$$$$$+.",
".+#######+##+@@@@+++$$$$$$@@$$+.",
".+###+++##+##+@@++@$$$$$$++$$$+.",
".+###++++##+##+@@$$$$$$$@+@$$@+.",
".+###++++++#+++@$$@+@$$@++$$$@+.",
".+####+++++++#++$$@+@$$++$$$$+..",
".++####++++++#++$$@+@$++@$$$$+..",
".+#####+++++##++$$++@+++$$$$$+..",
".++####+++##+#++$$+++++@$$$$$+..",
".++####+++####++$$++++++@$$$@+..",
".+#####++#####++$$+++@++++@$@+..",
".+#####++#####++$$++@$$@+++$@@..",
".++####++#####++$$++$$$$$+@$@++.",
".++####++#####++$$++$$$$$$$$+++.",
".+++####+#####++$$++$$$$$$$@+++.",
"..+++#########+@$$+@$$$$$$+++...",
"...+++########+@$$$$$$$$@+++....",
".....+++######+@$$$$$$$+++......",
"......+++#####+@$$$$$@++........",
".......+++####+@$$$$+++.........",
".........++###+$$$@++...........",
"..........++##+$@+++............",
"...........+++++++..............",
".............++++..............."};
|
|
Button Boxes |
Notebooks |
|
Закладки на сайте Проследить за страницей |
Created 1996-2024 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |