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