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

#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