GtkFileChooserButton
GtkFileChooserButton — Кнопка для запуска диалога выбора файла
Функции
Свойства
| GtkFileChooser * | dialog | Запись / Только для создания |
| gchar * | title | Чтение / Запись |
| gint | width-chars | Чтение / Запись |
Сигналы
Типы и значения
| 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 устарело и его не следует использовать в новом коде.
Возвращает, захватывает ли кнопка фокус при щелчке мышью. См. gtk_file_chooser_button_set_focus_on_click().
Параметры
button | виджет GtkFileChooserButton |
Возвращает
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 устарело и его не следует использовать в новом коде.
Устанавливает, захватывает ли кнопка фокус при щелчке мышью. Использование функции для избежания захвата фокуса полезно в таких местах, как панели инструментов, где вы не хотите удалять фокус клавиатуры с основной области приложения.
Параметры
button | виджет GtkFileChooserButton | |
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 | данные пользователя, заданные при подключении обработчика сигнала. |
Флаги: Выполнение сначала
С: 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.20/GtkFileChooserButton.html
