[ новости /+++ | форум | теги | ]

Каталог документации / Раздел "Программирование, языки" / Оглавление документа

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

#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);

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

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

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

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

gtk_file_chooser_button_get_title ()

const gchar* gtk_file_chooser_button_get_title
                                            (GtkFileChooserButton *button);

Получает заголовок диалога выбора использующего button. Возвращаемое значение не должно изменяться или освобождаться.

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

gtk_file_chooser_button_set_title ()

void        gtk_file_chooser_button_set_title
                                            (GtkFileChooserButton *button,
                                             const gchar *title);

Изменяет заголовок диалога выбора использующего button.

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

gtk_file_chooser_button_get_width_chars ()

gint        gtk_file_chooser_button_get_width_chars
                                            (GtkFileChooserButton *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.

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

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

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

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

Партнёры:

Хостинг: