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

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

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

fileChooserButtonNew Source

Arguments

:: GlibString string 
=> 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.

fileChooserButtonNewWithBackend Source

Arguments

:: GlibString string 
=> 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.

Removed in Gtk3.

fileChooserButtonNewWithDialog Source

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

fileChooserButtonGetTitle Source

Arguments

:: (FileChooserButtonClass self, GlibString string) 
=> self 
-> IO string

returns a pointer to the browse dialog's title.

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

fileChooserButtonSetTitle Source

Arguments

:: (FileChooserButtonClass self, GlibString string) 
=> self 
-> string

title - the new browse dialog title.

-> IO () 

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

fileChooserButtonGetWidthChars Source

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.

fileChooserButtonSetWidthChars Source

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 fileChooserDialog Source

Instance of the FileChooserDialog associated with the button.

fileChooserButtonTitle :: (FileChooserButtonClass self, GlibString string) => Attr self string Source

Title to put on the FileChooserDialog associated with the button.

Default value: "Select A File"

Signals

fileChooserButtonFileSet :: FileChooserButtonClass self => Signal self (IO ()) Source

Emitted when the user selects a file.