Prev

Up

Home

GTK+ Reference Manual

Next

Top  |  Description  |  Object Hierarchy  |  Implemented Interfaces  |  Properties

GtkFileChooserButton

GtkFileChooserButton Кнопка для переключения файлов диалога выбора

Краткое описание

#include <gtk/gtk.h> GtkFileChooserButton; GtkWidget* gtk_file_chooser_button_new (const gchar *title, GtkFileChooserAction action); GtkWidget* gtk_file_chooser_button_new_with_backend (const gchar *title, GtkFileChooserAction action, const gchar *backend); GtkWidget* gtk_file_chooser_button_new_with_dialog (GtkWidget *dialog); const gchar* gtk_file_chooser_button_get_title (GtkFileChooserButton *button); void gtk_file_chooser_button_set_title (GtkFileChooserButton *button, const gchar *title); gint gtk_file_chooser_button_get_width_chars (GtkFileChooserButton *button); void gtk_file_chooser_button_set_width_chars (GtkFileChooserButton *button, gint n_chars); gboolean gtk_file_chooser_button_get_focus_on_click (GtkFileChooserButton *button); void gtk_file_chooser_button_set_focus_on_click (GtkFileChooserButton *button, gboolean focus_on_click);

Иерархия объектов

GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBox +----GtkHBox +----GtkFileChooserButton

Реализуемые интерфейсы

GtkFileChooserButton реализует GtkFileChooser и AtkImplementorIface.

Свойства

"dialog" GtkFileChooserDialog : Write / Construct Only "focus-on-click" gboolean : Read / Write "title" gchararray : Read / Write "width-chars" gint : Read / Write

Описание

GtkFileChooserButton это виджет который позволяет пользователю выбирать файл. Он реализует интерфейс GtkFileChooser. Визуально, это имя файла с кнопкой для выдвижения GtkFileChooserDialog. Пользователь может потом использовать этот диалог для изменения файла связанного с кнопкой. Этот виджет не поддерживает установку свойства "select-multiple" в значение TRUE.

Пример 6. Создание кнопки позволяющей выбрать пользователю файл в /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 will ellipsize the label, and thus will thus request little horizontal space. Для получения кнопкой большего пространства, вы должны вызвать gtk_widget_size_request(), gtk_file_chooser_button_set_width_chars(), или упаковать кнопку таким образом что другие элементы интерфейса получат интервал для виджета.

Детали

GtkFileChooserButton

typedef struct _GtkFileChooserButton GtkFileChooserButton;

К этой структуре нет непосредственного доступа. Функции доступа описаны ниже.


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_backend ()

GtkWidget* gtk_file_chooser_button_new_with_backend (const gchar *title, GtkFileChooserAction action, const gchar *backend);

Создаёт новый виджет кнопку выбора файла используя backend.

title :

заголовок диалога выбора.

action :

режим открытия для виджета.

backend :

имя GtkFileSystem модуля для использования.

Возвращает :

новый виджет кнопка.

Начиная с версии 2.6


gtk_file_chooser_button_new_with_dialog ()

GtkWidget* gtk_file_chooser_button_new_with_dialog (GtkWidget *dialog);

Создаёт GtkFileChooserButton виджет который использует dialog как окно захвата файла. Помните что dialog должен быть GtkFileChooserDialog (или подкласс) и не установлен в GTK_DIALOG_DESTROY_WITH_PARENT.

dialog :

GtkFileChooserDialog виджет для использования.

Возвращает :

новый виджет кнопка.

Начиная с версии 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);

Изменяет заголовок диалога выбора использующего 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_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);

Устанавливает перехватывает ли кнопка фокус когда на неё нажимают мышкой. Не перехватывать фокус во время нажатия мышки полезно например в панели инструментов когда вам не нужно перемещать фокус из основного окна приложения.

button :

GtkFileChooserButton

focus_on_click :

Перехватывать ли фокус при нажатии мышкой

Начиная с версии 2.10

Детали свойств

Свойство "dialog"

  "dialog"               GtkFileChooserDialog  : Write / Construct Only

Экземпляр GtkFileChooserDialog связанный с кнопкой.

Начиная с версии 2.6


Свойство "focus-on-click"

  "focus-on-click"       gboolean              : Read / Write

Перехватывает ли GtkFileChooserButton кнопка фокус при нажатии на неё мышкой.

Значение по умолчанию: TRUE

Начиная с версии 2.10


Свойство "title"

  "title"                gchararray            : Read / Write

Заголовок помещаемый в GtkFileChooserDialog связанный с кнопкой.

Значение по умолчанию: "Select A File"

Начиная с версии 2.6


Свойство "width-chars"

  "width-chars"          gint                  : Read / Write

Ширина ввода и ярлыка внутри кнопки, в символах.

Допустимые значения: >= -1

Значение по умолчанию: -1

Начиная с версии 2.6

Смотрите также

GtkFileChooserDialog