The OpenNET Project / Index page

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

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

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




Партнёры:
PostgresPro
Inferno Solutions
Hosting by Hoster.ru
Хостинг:

Закладки на сайте
Проследить за страницей
Created 1996-2024 by Maxim Chirkov
Добавить, Поддержать, Вебмастеру