+---- GtkBin
+---- GtkWindow
Существуют десятки вызовов API
GtkWindow
, но далее приведены функции, заслуживающие особого внимания.
<b>GtkWidget* gtk_window_new(GtkWindowType type);</b>
<b>void gtk_window_set_title(GtkWindow *window, const gchar *title);</b>
<b>void gtk_window_set_position(GtkWindow *window, GtkWindowPosition position);</b>
<b>void gtk_window_set_default_size(GtkWindow *window, gint width, gint height);</b>
<b>void gtk_window_resize(GtkWindow *window, gint width, gint height);</b>
<b>void gtk_window_set_resizable(GtkWindow *window, gboolean resizable);</b>
<b>void gtk_window_present(GtkWindow *window);</b>
<b>void gtk_window_maximize(GtkWindow *window);</b>
<b>void gtk_window_unmaximize(GtkWindow *window);</b>
Как вы видели, функция
gtk_window_new
создает в памяти новое пустое окно. Заголовок окна не задан и размер и местоположение окна не определены. Обычно вы будете заполнять окно виджетами и задавать меню и панель инструментов перед выводом окна на экран с помощью вызова функции
gtk_widget_show
.
Функция
gtk_window_set_title
изменяет текст полосы заголовка, информируя оконный менеджер запроса.
Примечание
Поскольку за отображение оформления окна отвечает оконный менеджер, а не библиотека GTK+, шрифт, цвет и размер текста зависят от вашего выбора оконного менеджера.
Функция
gtk_window_setposition
управляет начальным местоположением на экране. Параметр
position
может принимать пять значений, перечисленных в табл. 16.2.
Таблица 16.2
| Параметр position
| Описание |
GTK_WIN_POS_NONE
| Окно располагается по усмотрению оконного менеджера |
GTK_WIN_POS_CENTER
| Окно центрируется на экране |
GTK_WIN_POS_MOUSE
| Расположение окна задаётся указателем мыши |
GTK_WIN_POS_CENTER_ALWAYS
| Окно остается отцентрированным независимо от его размера |
GTK_WIN_POS_CENTER_ON_PARENT
| Окно центрируется относительно родительского окна (удобно для диалоговых окон) |
Функция
gtk_window_set_default_size
задает окно на экране в единицах отображения GTK+. Явное задание размера окна гарантирует, что содержимое окна не будет закрыто чем-либо или скрыто. Для того чтобы изменить размеры окна после его вывода на экран, можно воспользоваться функцией
gtk_window_resize
. По умолчанию пользователь может изменить размеры окна, перемещая обычным способом его границу мышью. Если вы хотите помешать этому, можно вызвать функцию
gtk_window_set_resizeable
, приравненную FALSE.
Для того чтобы убедиться в том, что ваше окно присутствует на экране и видно пользователю, т.е. не свернуто или скрыто, подойдет функция
gtk_window_present
. Она полезна для диалоговых окон, т.к. позволяет убедиться в том, что окна не свернуты, когда вам нужен какой-либо пользовательский ввод. В противном случае, для раскрытия окна на весь экран и его сворачивания у вас есть функции
gtk_window_maximize
и
gtk_window_minimize
.
GtkEntry
GtkEntry
— виджет однострочного текстового поля, который обычно применяется для ввода простых текстовых данных, например, адреса электронной почты, имени пользователя или имени узла сети. Существуют вызовы API, позволяющие задать как считывание введенного текста, так и его максимальную длину в символах, а также другие параметры, управляющие местоположением текста и его выделением.
GtkWidget
+----GtkEntry
Можно настроить
GtkEntry
на отображение звездочек (или любого другого определенного пользователем символа) на месте набранных буквенно-цифровых символов, что очень удобно для ввода паролей, когда вы не хотите, чтобы кто-то заглядывал через ваше плечо и читал текст.
Мы опишем большинство самых полезных функций виджета
GtkEntry
:
<b>GtkWidget* gtk_entry_new(void);</b>
<b>GtkWidget* gtk_entry_new_with_max_length(gint max);</b>
<b>void gtk_entry_set_max_length(GtkEntry *entry, gint max);</b>
<b>G_CONST_RETURN gchar* gtk_entry_get_text(GtkEntry *entry);</b>
<b>void gtk_entry_set_text(GtkEntry *entry, const gchar *text);</b>
<b>void gtk_entry_append_text(GtkEntry *entry, const gchar *text);</b>
<b>void gtk_entry_prepend_text(GtkEntry* entry, const gchar *text);</b>
<b>void gtk_entry_set_visibility(GtkEntry *entry, gboolean visible);</b>
<b>void gtk_entry_set_invisible_char(GtkEntry *entry, gchar invch);</b>
<b>void gtk_entry_set_editable(GtkEntry *entry, gboolean editable);</b>
Вы можете создать
GtkEntry
с помощью функции
gtk_entry_new
или при вводе текста фиксированной длины с помощью функции
gtk_entry_new_with_max_length
. Ограничение ввода определенной длиной текста избавляет вас от проверки корректности длины ввода и, возможно, необходимости информировать пользователя о том, что текст слишком длинный.
Для получения содержимого виджета
GtkEntry
вызывайте функцию
gtk_entry_get_text
, которая возвращает указатель
const char
, внутренний по отношению к
GtkEntry
(
G_CONST_RETURN
— макрос, определенный в библиотеке GLib). Если вы хотите изменить текст или передать его в функцию, которая может его модифицировать, следует скопировать строку с помощью, например, функции
strcpy
.
