GtkFileChooserButton
GtkFileChooserButton — Кнопка для запуска диалога выбора файла
Функции
Свойства
| GtkFileChooser * | dialog | Запись/Только для создания |
| gchar * | title | Чтение/Запись |
| gint | ширина-символов | Чтение/Запись |
Сигналы
| 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()или разместить кнопку таким образом, чтобы другие элементы интерфейса предоставляли пространство для виджета.
Функции
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, связанный с кнопкой.
Флаги: Запись / Только для создания
С: 2.6
Свойство “title”
“title” gchar *
Заголовок для GtkFileChooserDialog, связанного с кнопкой.
Флаги: Чтение / Запись
Значение по умолчанию: "Выбрать файл"
С: 2.6
Свойство “width-chars”
“width-chars” gint
Ширина поля ввода и метки внутри кнопки в символах.
Флаги: Чтение / Запись
Разрешённые значения: >= -1
Значение по умолчанию: -1
С: 2.6
Подробное описание сигналов
Сигнал “file-set”
void user_function (GtkFileChooserButton *widget, gpointer user_data)
Сигнал ::file-set испускается при выборе пользователем файла.
Обратите внимание, что этот сигнал испускается только при изменении файла пользователем.
Параметры
widget | объект, получивший сигнал. | |
user_data | пользовательские данные, установленные при подключении обработчика сигнала. |
Флаги: Run First
С: 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.22/GtkFileChooserButton.html
