GtkFileChooserButton
GtkFileChooserButton — Кнопка для запуска диалога выбора файла
Функции
| GtkWidget * | gtk_file_chooser_button_new () |
| GtkWidget * | gtk_file_chooser_button_new_with_dialog () |
| const gchar * | gtk_file_chooser_button_get_title () |
| void | gtk_file_chooser_button_set_title () |
| gint | gtk_file_chooser_button_get_width_chars () |
| void | gtk_file_chooser_button_set_width_chars () |
| gboolean | gtk_file_chooser_button_get_focus_on_click () |
| void | gtk_file_chooser_button_set_focus_on_click () |
Свойства
| GtkFileChooser * | dialog | Запись / Только для построения |
| char * | title | Чтение / Запись |
| int | ширина-символов | Чтение / Запись |
Сигналы
| void | file-set | Выполнять первым |
Типы и значения
| struct | GtkFileChooserButton |
| struct | GtkFileChooserButtonClass |
Иерархия объектов
GObject
╰── GInitiallyUnowned
╰── GtkWidget
╰── GtkContainer
╰── GtkBox
╰── GtkFileChooserButton
Реализованные интерфейсы
GtkFileChooserButton реализует AtkImplementorIface, GtkBuildable, GtkOrientable и GtkFileChooser.
Файлы заголовков
#include <gtk/gtk.h>
Описание
Виджет GtkFileChooserButton позволяет пользователю выбрать файл. Он реализует интерфейс GtkFileChooser. Визуально он представляет собой имя файла с кнопкой, которая открывает диалог GtkFileChooserDialog. Пользователь может использовать этот диалог для изменения файла, связанного с этой кнопкой. Данный виджет не поддерживает установку свойства “select-multiple” в TRUE.
Создайте кнопку, позволяющую пользователю выбрать файл в /etc
{
GtkWidget *button;
button = gtk_file_chooser_button_new (_("Select a file"),
GTK_FILE_CHOOSER_ACTION_OPEN);
gtk_file_chooser_set_current_folder (GTK_FILE_CHOOSER (button),
"/etc");
} GtkFileChooserButton поддерживает действия GtkFileChooserActions GTK_FILE_CHOOSER_ACTION_OPEN и GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER.
GtkFileChooserButton будет обрезать метку, и, следовательно, запрашивать небольшое горизонтальное пространство. Чтобы предоставить кнопке больше места, вы должны вызвать
gtk_widget_get_preferred_size(),gtk_file_chooser_button_set_width_chars()или упаковать кнопку таким образом, чтобы другие элементы интерфейса предоставляли пространство для виджета.
Узлы CSS
GtkFileChooserButton имеет узел CSS с именем «filechooserbutton», содержащий подузлы для внутренней кнопки с именем «button» и классом стиля «.file».
Функции
gtk_file_chooser_button_new ()
GtkWidget * gtk_file_chooser_button_new (const gchar *title,GtkFileChooserAction action);
Создаёт новый виджет кнопки для выбора файла.
Параметры
title | заголовок диалога выбора. | |
action | режим открытия для виджета. |
Возвращает
новый виджет кнопки.
С момента: 2.6
gtk_file_chooser_button_new_with_dialog ()
GtkWidget *
gtk_file_chooser_button_new_with_dialog
(GtkWidget *dialog); Создаёт виджет GtkFileChooserButton, который использует dialog в качестве окна выбора файла.
Обратите внимание, что dialog должен быть GtkDialog (или подклассом), реализующим интерфейс GtkFileChooser, и у него не должно быть установлено GTK_DIALOG_DESTROY_WITH_PARENT.
Также обратите внимание, что диалогу необходимо добавить кнопку подтверждения с ответом GTK_RESPONSE_ACCEPT или GTK_RESPONSE_OK, чтобы кнопка могла принять выбранный в диалоге файл.
Параметры
dialog | виджет, используемый в качестве диалога. | [type Gtk.Dialog] |
Возвращает
новый виджет кнопки.
С момента: 2.6
gtk_file_chooser_button_get_title ()
const gchar *
gtk_file_chooser_button_get_title (GtkFileChooserButton *button); Возвращает заголовок диалога выбора, используемого button. Возвращаемое значение не должно изменяться или освобождаться.
Параметры
button | виджет кнопки для проверки. |
Возвращает
указатель на заголовок диалога выбора.
С момента: 2.6
gtk_file_chooser_button_set_title ()
void gtk_file_chooser_button_set_title (GtkFileChooserButton *button,const gchar *title);
Изменяет title диалога выбора, используемого button.
Параметры
button | виджет кнопки для изменения. | |
title | новый заголовок диалога выбора. |
С момента: 2.6
gtk_file_chooser_button_get_width_chars ()
gint
gtk_file_chooser_button_get_width_chars
(GtkFileChooserButton *button); Возвращает ширину в символах поля ввода и/или метки виджета button.
Параметры
button | виджет кнопки для проверки. |
Возвращает
целое число ширины (в символах), которое кнопка будет использовать для задания своего размера.
С момента: 2.6
gtk_file_chooser_button_set_width_chars ()
void gtk_file_chooser_button_set_width_chars (GtkFileChooserButton *button,gint n_chars);
Устанавливает ширину (в символах), которую button будет использовать для n_chars.
Параметры
button | виджет кнопки для проверки. | |
n_chars | новая ширина в символах. |
С момента: 2.6
gtk_file_chooser_button_get_focus_on_click ()
gboolean
gtk_file_chooser_button_get_focus_on_click
(GtkFileChooserButton *button); gtk_file_chooser_button_get_focus_on_click устарел начиная с версии 3.20 и не должен использоваться в новых кодах.
Используйте gtk_widget_get_focus_on_click() вместо этого
Возвращает, получает ли кнопка фокус при нажатии мышью. См. gtk_file_chooser_button_set_focus_on_click().
Параметры
button |
Возвращает
TRUE если кнопка получает фокус при нажатии мышью.
С момента: 2.10
gtk_file_chooser_button_set_focus_on_click ()
void gtk_file_chooser_button_set_focus_on_click (GtkFileChooserButton *button,gboolean focus_on_click);
gtk_file_chooser_button_set_focus_on_click устарел начиная с версии 3.20 и не должен использоваться в новых кодах.
Используйте gtk_widget_set_focus_on_click() вместо этого
Устанавливает, получит ли кнопка фокус при нажатии мышью. Отключение захвата фокуса при нажатии мышью полезно в таких местах, как панели инструментов, где не нужно удалять фокус клавиатуры из основной области приложения.
Параметры
button | ||
focus_on_click | получит ли кнопка фокус при нажатии мышью |
С момента: 2.10
Типы и значения
struct GtkFileChooserButton
struct GtkFileChooserButton;
struct GtkFileChooserButtonClass
struct GtkFileChooserButtonClass {
GtkBoxClass parent_class;
void (* file_set) (GtkFileChooserButton *fc);
};
Члены
| Сигнал, генерируемый при выборе пользователем файла. |
Подробное описание свойств
Свойство “dialog”
“dialog” GtkFileChooser *
Экземпляр GtkFileChooserDialog, связанный с кнопкой.
Владелец: GtkFileChooserButton
Флаги: Запись / Только для построения
С момента: 2.6
Свойство “title”
“title” char *
Заголовок, который следует поместить на GtkFileChooserDialog, связанный с кнопкой.
Владелец: GtkFileChooserButton
Флаги: Чтение / Запись
Значение по умолчанию: «Выбрать файл»
С момента: 2.6
Свойство “width-chars”
“width-chars” int
Ширина поля ввода и метки внутри кнопки в символах.
Владелец: GtkFileChooserButton
Флаги: Чтение / Запись
Допустимые значения: >= -1
Значение по умолчанию: -1
С момента: 2.6
Подробное описание сигналов
Сигнал “file-set”
void user_function (GtkFileChooserButton *widget, gpointer user_data)
Сигнал ::file-set генерируется при выборе пользователем файла.
Обратите внимание, что этот сигнал генерируется только при изменении файла.
Параметры
widget | объект, получивший сигнал. | |
user_data | данные пользователя, установленные при подключении обработчика сигналов. |
Флаги: Выполнить сначала
С момента: 2.12
См. также
© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.24/GtkFileChooserButton.html
