gtk-0.11.0: Binding to the Gtk+ graphical user interface library.

Portabilityportable (depends on GHC)
Stabilityprovisional
Maintainergtk2hs-users@lists.sourceforge.net

Graphics.UI.Gtk.Selectors.FileChooserButton

Contents

Description

A button to launch a file selection dialog

  • Module available since Gtk+ version 2.6

Synopsis

Detail

The FileChooserButton is a widget that lets the user select a file. It implements the FileChooser interface. Visually, it is a file name with a button to bring up a 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.

The FileChooserButton supports the FileChooserActions FileChooserActionOpen and FileChooserActionSelectFolder.

Class Hierarchy

 | GObject
 | +----Object
 | +----Widget
 | +----Container
 | +----Box
 | +----HBox
 | +----FileChooserButton

Types

Constructors

fileChooserButtonNewSource

Arguments

:: String

title - the title of the browse dialog.

-> FileChooserAction

action - the open mode for the widget.

-> IO FileChooserButton 

Creates a new file-selecting button widget.

fileChooserButtonNewWithBackendSource

Arguments

:: String

title - the title of the browse dialog.

-> FileChooserAction

action - the open mode for the widget.

-> String

backend - the name of the file system backend to use.

-> IO FileChooserButton 

Creates a new file-selecting button widget using backend.

fileChooserButtonNewWithDialogSource

Arguments

:: FileChooserDialogClass dialog 
=> dialog

dialog - the FileChooserDialog widget to use.

-> IO FileChooserButton 

Creates a FileChooserButton widget which uses dialog as it's file-picking window.

Methods

fileChooserButtonGetTitleSource

Arguments

:: FileChooserButtonClass self 
=> self 
-> IO String

returns a pointer to the browse dialog's title.

Retrieves the title of the browse dialog used by the button.

fileChooserButtonSetTitleSource

Arguments

:: FileChooserButtonClass self 
=> self 
-> String

title - the new browse dialog title.

-> IO () 

Modifies the title of the browse dialog used by the button.

fileChooserButtonGetWidthCharsSource

Arguments

:: FileChooserButtonClass self 
=> self 
-> IO Int

returns an integer width (in characters) that the button will use to size itself.

Retrieves the width in characters of the button widget's entry and/or label.

fileChooserButtonSetWidthCharsSource

Arguments

:: FileChooserButtonClass self 
=> self 
-> Int

nChars - the new width, in characters.

-> IO () 

Sets the width (in characters) that the button will use to nChars.

Attributes

fileChooserButtonDialog :: (FileChooserButtonClass self, FileChooserDialogClass fileChooserDialog) => WriteAttr self fileChooserDialogSource

Instance of the FileChooserDialog associated with the button.

fileChooserButtonTitle :: FileChooserButtonClass self => Attr self StringSource

Title to put on the FileChooserDialog associated with the button.

Default value: "Select A File"