Основы программирования в Linux - Мэтью Нейл

        +---- 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.