A button to launch a file selection dialog
Class GtkFileChooserButton( title, action )
| title | the title of the browse dialog. |
| action | the open mode for the widget (GtkFileChooserAction). |
The GtkFileChooserButton is a widget that lets the user select a file. It implements the GtkFileChooser interface. Visually, it is a file name with a button to bring up a GtkFileChooserDialog. The user can then use that dialog to change the file associated with that button. This widget does not support setting the "select-multiple" property to TRUE.
[...]
| Methods | |
| get_focus_on_click | Returns whether the button grabs focus when it is clicked with the mouse. |
| get_title | Retrieves the title of the browse dialog used by button. |
| get_width_chars | Retrieves the width in characters of the button widget's entry and/or label. |
| new_with_dialog | Creates a GtkFileChooserButton widget which uses dialog as its file-picking window. |
| set_focus_on_click | Sets whether the button will grab focus when it is clicked with the mouse. |
| set_title | Modifies the title of the browse dialog used by button. |
| set_width_chars | Sets the width (in characters) that button will use to n_chars. |
| signal_file_set | The file-set signal is emitted when the user selects a file. |
Returns whether the button grabs focus when it is clicked with the mouse.
GtkFileChooserButton.get_focus_on_click()
| Return | true if the button grabs focus when it is clicked with the mouse |
Retrieves the title of the browse dialog used by button.
GtkFileChooserButton.get_title()
| Return | the browse dialog's title. |
Retrieves the width in characters of the button widget's entry and/or label.
GtkFileChooserButton.get_width_chars()
| Return | an integer width (in characters) that the button will use to size itself. |
Creates a GtkFileChooserButton widget which uses dialog as its file-picking window.
GtkFileChooserButton.new_with_dialog( dialog )
| dialog | the widget to use as dialog |
| Return | a new button widget. |
Note that dialog must be a GtkDialog (or subclass) which implements the GtkFileChooser interface and must not have GTK_DIALOG_DESTROY_WITH_PARENT set.
Also note that the dialog needs to have its confirmative button added with response GTK_RESPONSE_ACCEPT or GTK_RESPONSE_OK in order for the button to take over the file selected in the dialog.
Sets whether the button will grab focus when it is clicked with the mouse.
GtkFileChooserButton.set_focus_on_click( focus_on_click )
| focus_on_click | whether the button grabs focus when clicked with the mouse |
Making mouse clicks not grab focus is useful in places like toolbars where you don't want the keyboard focus removed from the main area of the application.
Modifies the title of the browse dialog used by button.
GtkFileChooserButton.set_title( title )
| title | the new browse dialog title. |
Sets the width (in characters) that button will use to n_chars.
GtkFileChooserButton.set_width_chars( n_chars )
| n_chars | the new width, in characters. |
The file-set signal is emitted when the user selects a file.
GtkFileChooserButton.signal_file_set()
Note that this signal is only emitted when the user changes the file.