Synopsis

gtk.FileChooserButton a button to launch a gtk.FileChooserDialog (new in PyGTK 2.6) Synopsis gtk.FileChooserButton gtk.HBox gtk.FileChooserButton title backendNone gtk.FileChooserButton dialog get_title set_title title get_width_chars set_width_chars n_chars get_focus_on_click set_focus_on_click focus_on_click Ancestry +-- gobject.GObject +-- gtk.Object +-- gtk.Widget +-- gtk.Container +-- gtk.Box +-- gtk.HBox +-- gtk.FileChooserButton (implements gtk.FileChooser) Implemented Interfaces gtk.FileChooserButton implements gtk.Buildable gtk.FileChooserButton Properties gtk.FileChooser Properties gtk.Object Properties gtk.Widget Properties gtk.Container Properties gtk.Box Properties

"dialog" Write-Construct Only The gtk.FileChooserDialog associated with the button. Available in GTK+ 2.6. "focus-on-click" Read-Write If True the gtk.FileChooserButton button grabs focus when it is clicked with the mouse. Default value: True. Available in GTK+ 2.10. "title" Read-Write The string to use as the title on the gtk.FileChooserDialog associated with the button. Default value: "Select A File". Available in GTK+ 2.6. "width-chars" Read-Write The width of the entry and label inside the button, in characters. Allowed values: >= -1. Default value: -1. Available in GTK+ 2.6.

gtk.FileChooserButton Style Properties gtk.Widget Style Properties gtk.FileChooserButton Child Properties gtk.Box Child Properties gtk.FileChooserButton Signal Prototypes gobject.GObject Signal Prototypes gtk.Object Signal Prototypes gtk.Widget Signal Prototypes gtk.Container Signal Prototypes gtk.FileChooser Signal Prototypes "file-set" callback filechooserbutton user_param1 ... Description This widget is available in PyGTK 2.6 and above. The gtk.FileChooserButton is a widget that lets the user select a file. It implements the gtk.FileChooser interface. Visually, it is a file name with a button to bring up a gtk.FileChooserDialog. 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. For example to create a gtk.FileChooserButton and set the current folder to '/etc' use: filechooserbutton = gtk.FileChooserButton('Select a File') filechooserbutton.set_current_folder('/etc') The gtk.FileChooserButton supports the gtk.FILE_CHOOSER_ACTION_OPEN and gtk.FILE_CHOOSER_ACTION_SELECT_FOLDER actions of the . The gtk.FileChooserButton will ellipsize the label, and thus will thus request little horizontal space. To give the button more space, you should call the gtk.Widget.size_request() method, the set_width_chars() method, or pack the button in such a way that other interface elements give space to the widget. Constructor gtk.FileChooserButton gtk.FileChooserButton title backendNone title : the title of the browse dialog backend : the name of a file system backend or None Returns : a new gtk.FileChooserButton This constructor is available in PyGTK 2.6 and above. Creates a new button widget that opens a gtk.FileChooserDialog when clicked. The title of the gtk.FileChooserDialog is specified by title. If backend is specified it is the name of a file system backend. gtk.FileChooserButton gtk.FileChooserButton dialog dialog : a gtk.FileChooserDialog Returns : a new gtk.FileChooserButton This constructor is available in PyGTK 2.6 and above. Creates a new button widget that opens a gtk.FileChooserDialog specified by dialog when clicked. Methods gtk.FileChooserButton.get_title get_title Returns : the title of the gtk.FileChooserDialog This method is available in PyGTK 2.6 and above. The get_title() method returns the value of the "title" property which contains the title of the associated gtk.FileChooserDialog. gtk.FileChooserButton.set_title set_title title title : a string to use as the title of the associated gtk.FileChooserDialog. This method is available in PyGTK 2.6 and above. The set_title() method sets the "title" property to the value of title. The "title" property contains the title string of the associated gtk.FileChooserDialog. gtk.FileChooserButton.get_width_chars get_width_chars Returns : : the width in characters of the button This method is available in PyGTK 2.6 and above. The get_width_chars() method returns the value of the "width-characters" property which contains the number of characters the button width should be set to. gtk.FileChooserButton.set_width_chars set_width_chars n_chars n_chars : the width in characters for the button This method is available in PyGTK 2.6 and above. The set_width_chars() method sets the "width-chars" property to the value of n_chars. The "width-chars" property contains the width in characters that the button should be set to. gtk.FileChooserButton.get_focus_on_click get_focus_on_click Returns : True if the button grabs focus when it is clicked with the mouse. This method is available in PyGTK 2.10 and above. The get_focus_on_click() method returns the value of the "focus-on-click" property. If the return value is True if the button grabs focus when it is clicked with the mouse. See the set_focus_on_click() method. gtk.FileChooserButton.set_focus_on_click set_focus_on_click focus_on_click focus_on_click : If True, the button grabs focus when clicked with the mouse This method is available in PyGTK 2.10 and above. The set_focus_on_click() method sets the "focus-on-click" property to the value of focus_on_click. If focus_on_click is True, the button will grab focus when it is 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. Signals The "file-set" gtk.FileChooserButton Signal callback filechooserbutton user_param1 ... filechooserbutton : the filechooserbutton that received the signal user_param1 : the first user parameter (if any) specified with the connect() method ... : additional user parameters (if any) This signal is available in GTK+ 2.12 and above. The "file-set" signal is emitted when the user selects a file. Note that this signal is only emitted when the user changes the file.