<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Graphics.UI.Gtk.Selectors.FileChooserDialog</title><link href="ocean.css" rel="stylesheet" type="text/css" title="Ocean" /><script src="haddock-util.js" type="text/javascript"></script><script type="text/javascript">//<![CDATA[
window.onload = function () {pageLoad();setSynopsis("mini_Graphics-UI-Gtk-Selectors-FileChooserDialog.html");};
//]]>
</script></head><body><div id="package-header"><ul class="links" id="page-menu"><li><a href="src/Graphics-UI-Gtk-Selectors-FileChooserDialog.html">Source</a></li><li><a href="index.html">Contents</a></li><li><a href="doc-index.html">Index</a></li></ul><p class="caption">gtk-0.12.0: Binding to the Gtk+ graphical user interface library.</p></div><div id="content"><div id="module-header"><table class="info"><tr><th>Portability</th><td>portable (depends on GHC)</td></tr><tr><th>Stability</th><td>provisional</td></tr><tr><th>Maintainer</th><td>gtk2hs-users@lists.sourceforge.net</td></tr></table><p class="caption">Graphics.UI.Gtk.Selectors.FileChooserDialog</p></div><div id="table-of-contents"><p class="caption">Contents</p><ul><li><a href="#g:1">Detail
</a><ul><li><a href="#g:2">Response Codes
</a></li></ul></li><li><a href="#g:3">Class Hierarchy
</a></li><li><a href="#g:4">Types
</a></li><li><a href="#g:5">Constructors
</a></li></ul></div><div id="description"><p class="caption">Description</p><div class="doc"><p>A file chooser dialog, suitable for "File/Open" or "File/Save"
commands
</p><ul><li> Module available since Gtk+ version 2.4
</li></ul></div></div><div id="synopsis"><p id="control.syn" class="caption expander" onclick="toggleSection('syn')">Synopsis</p><ul id="section.syn" class="hide" onclick="toggleSection('syn')"><li class="src short"><span class="keyword">data</span> <a href="#t:FileChooserDialog">FileChooserDialog</a> </li><li class="src short"><span class="keyword">class</span> <a href="Graphics-UI-Gtk-Windows-Dialog.html#t:DialogClass">DialogClass</a> o => <a href="#t:FileChooserDialogClass">FileChooserDialogClass</a> o </li><li class="src short"><a href="#v:castToFileChooserDialog">castToFileChooserDialog</a> :: <a href="/usr/share/doc/ghc/html/libraries/glib-0.12.0/System-Glib-GObject.html#t:GObjectClass">GObjectClass</a> obj => obj -> <a href="Graphics-UI-Gtk-Selectors-FileChooserDialog.html#t:FileChooserDialog">FileChooserDialog</a></li><li class="src short"><a href="#v:gTypeFileChooserDialog">gTypeFileChooserDialog</a> :: <a href="Graphics-UI-Gtk-Abstract-Widget.html#t:GType">GType</a></li><li class="src short"><a href="#v:toFileChooserDialog">toFileChooserDialog</a> :: <a href="Graphics-UI-Gtk-Selectors-FileChooserDialog.html#t:FileChooserDialogClass">FileChooserDialogClass</a> o => o -> <a href="Graphics-UI-Gtk-Selectors-FileChooserDialog.html#t:FileChooserDialog">FileChooserDialog</a></li><li class="src short"><a href="#v:fileChooserDialogNew">fileChooserDialogNew</a> :: <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/Data-Maybe.html#t:Maybe">Maybe</a> <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/Data-Char.html#t:String">String</a> -> <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/Data-Maybe.html#t:Maybe">Maybe</a> <a href="Graphics-UI-Gtk-Windows-Window.html#t:Window">Window</a> -> <a href="Graphics-UI-Gtk-Selectors-FileChooser.html#t:FileChooserAction">FileChooserAction</a> -> [(<a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/Data-Char.html#t:String">String</a>, <a href="Graphics-UI-Gtk-Windows-Dialog.html#t:ResponseId">ResponseId</a>)] -> <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/System-IO.html#t:IO">IO</a> <a href="Graphics-UI-Gtk-Selectors-FileChooserDialog.html#t:FileChooserDialog">FileChooserDialog</a></li><li class="src short"><a href="#v:fileChooserDialogNewWithBackend">fileChooserDialogNewWithBackend</a> :: <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/Data-Maybe.html#t:Maybe">Maybe</a> <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/Data-Char.html#t:String">String</a> -> <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/Data-Maybe.html#t:Maybe">Maybe</a> <a href="Graphics-UI-Gtk-Windows-Window.html#t:Window">Window</a> -> <a href="Graphics-UI-Gtk-Selectors-FileChooser.html#t:FileChooserAction">FileChooserAction</a> -> [(<a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/Data-Char.html#t:String">String</a>, <a href="Graphics-UI-Gtk-Windows-Dialog.html#t:ResponseId">ResponseId</a>)] -> <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/Data-Char.html#t:String">String</a> -> <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/System-IO.html#t:IO">IO</a> <a href="Graphics-UI-Gtk-Selectors-FileChooserDialog.html#t:FileChooserDialog">FileChooserDialog</a></li></ul></div><div id="interface"><h1 id="g:1">Detail
</h1><div class="doc"><p><code><a href="Graphics-UI-Gtk-Selectors-FileChooserDialog.html#t:FileChooserDialog">FileChooserDialog</a></code> is a dialog box suitable for use with "File/Open"
or "File/Save as" commands. This widget works by putting a
<code><a href="Graphics-UI-Gtk-Selectors-FileChooserWidget.html#t:FileChooserWidget">FileChooserWidget</a></code> inside a <code><a href="Graphics-UI-Gtk-Windows-Dialog.html#t:Dialog">Dialog</a></code>. It exposes the <code><a href="Graphics-UI-Gtk-Selectors-FileChooser.html#t:FileChooser">FileChooser</a></code>,
interface, so you can use all of the
<code><a href="Graphics-UI-Gtk-Selectors-FileChooser.html#t:FileChooser">FileChooser</a></code> functions on the file chooser dialog as well as those for
<code><a href="Graphics-UI-Gtk-Windows-Dialog.html#t:Dialog">Dialog</a></code>.
</p><p>Note that <code><a href="Graphics-UI-Gtk-Selectors-FileChooserDialog.html#t:FileChooserDialog">FileChooserDialog</a></code> does not have any methods of its own.
Instead, you should use the functions that work on a <code><a href="Graphics-UI-Gtk-Selectors-FileChooser.html#t:FileChooser">FileChooser</a></code>.
</p></div><h2 id="g:2">Response Codes
</h2><div class="doc"><p><code><a href="Graphics-UI-Gtk-Selectors-FileChooserDialog.html#t:FileChooserDialog">FileChooserDialog</a></code> inherits from <code><a href="Graphics-UI-Gtk-Windows-Dialog.html#t:Dialog">Dialog</a></code>, so buttons that go in its
action area have response codes such as <code><a href="Graphics-UI-Gtk-Windows-Dialog.html#v:ResponseAccept">ResponseAccept</a></code> and
<code><a href="Graphics-UI-Gtk-Windows-Dialog.html#v:ResponseCancel">ResponseCancel</a></code>.
</p></div><h1 id="g:3">Class Hierarchy
</h1><div class="doc"><pre>
| <code><a href="/usr/share/doc/ghc/html/libraries/glib-0.12.0/System-Glib-GObject.html#t:GObject">GObject</a></code>
| +----<code><a href="Graphics-UI-Gtk-Abstract-Object.html#t:Object">Object</a></code>
| +----<code><a href="Graphics-UI-Gtk-Abstract-Widget.html#t:Widget">Widget</a></code>
| +----<code><a href="Graphics-UI-Gtk-Abstract-Container.html#t:Container">Container</a></code>
| +----<code><a href="Graphics-UI-Gtk-Abstract-Bin.html#t:Bin">Bin</a></code>
| +----<code><a href="Graphics-UI-Gtk-Windows-Window.html#t:Window">Window</a></code>
| +----<code><a href="Graphics-UI-Gtk-Windows-Dialog.html#t:Dialog">Dialog</a></code>
| +----FileChooserDialog
</pre></div><h1 id="g:4">Types
</h1><div class="top"><p class="src"><span class="keyword">data</span> <a name="t:FileChooserDialog" class="def">FileChooserDialog</a> <a href="src/Graphics-UI-Gtk-Types.html#FileChooserDialog" class="link">Source</a></p><div class="subs instances"><p id="control.i:FileChooserDialog" class="caption collapser" onclick="toggleSection('i:FileChooserDialog')">Instances</p><div id="section.i:FileChooserDialog" class="show"><table><tr><td class="src"><a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/Data-Eq.html#t:Eq">Eq</a> <a href="Graphics-UI-Gtk-Selectors-FileChooserDialog.html#t:FileChooserDialog">FileChooserDialog</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/Data-Ord.html#t:Ord">Ord</a> <a href="Graphics-UI-Gtk-Selectors-FileChooserDialog.html#t:FileChooserDialog">FileChooserDialog</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="/usr/share/doc/ghc/html/libraries/glib-0.12.0/System-Glib-GObject.html#t:GObjectClass">GObjectClass</a> <a href="Graphics-UI-Gtk-Selectors-FileChooserDialog.html#t:FileChooserDialog">FileChooserDialog</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="Graphics-UI-Gtk-Selectors-FileChooser.html#t:FileChooserClass">FileChooserClass</a> <a href="Graphics-UI-Gtk-Selectors-FileChooserDialog.html#t:FileChooserDialog">FileChooserDialog</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="Graphics-UI-Gtk-Selectors-FileChooserDialog.html#t:FileChooserDialogClass">FileChooserDialogClass</a> <a href="Graphics-UI-Gtk-Selectors-FileChooserDialog.html#t:FileChooserDialog">FileChooserDialog</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="Graphics-UI-Gtk-Windows-Dialog.html#t:DialogClass">DialogClass</a> <a href="Graphics-UI-Gtk-Selectors-FileChooserDialog.html#t:FileChooserDialog">FileChooserDialog</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="Graphics-UI-Gtk-Windows-Window.html#t:WindowClass">WindowClass</a> <a href="Graphics-UI-Gtk-Selectors-FileChooserDialog.html#t:FileChooserDialog">FileChooserDialog</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="Graphics-UI-Gtk-Abstract-Bin.html#t:BinClass">BinClass</a> <a href="Graphics-UI-Gtk-Selectors-FileChooserDialog.html#t:FileChooserDialog">FileChooserDialog</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="Graphics-UI-Gtk-Abstract-Container.html#t:ContainerClass">ContainerClass</a> <a href="Graphics-UI-Gtk-Selectors-FileChooserDialog.html#t:FileChooserDialog">FileChooserDialog</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="Graphics-UI-Gtk-Abstract-Widget.html#t:WidgetClass">WidgetClass</a> <a href="Graphics-UI-Gtk-Selectors-FileChooserDialog.html#t:FileChooserDialog">FileChooserDialog</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="Graphics-UI-Gtk-Abstract-Object.html#t:ObjectClass">ObjectClass</a> <a href="Graphics-UI-Gtk-Selectors-FileChooserDialog.html#t:FileChooserDialog">FileChooserDialog</a></td><td class="doc empty"> </td></tr></table></div></div></div><div class="top"><p class="src"><span class="keyword">class</span> <a href="Graphics-UI-Gtk-Windows-Dialog.html#t:DialogClass">DialogClass</a> o => <a name="t:FileChooserDialogClass" class="def">FileChooserDialogClass</a> o <a href="src/Graphics-UI-Gtk-Types.html#FileChooserDialogClass" class="link">Source</a></p><div class="subs instances"><p id="control.i:FileChooserDialogClass" class="caption collapser" onclick="toggleSection('i:FileChooserDialogClass')">Instances</p><div id="section.i:FileChooserDialogClass" class="show"><table><tr><td class="src"><a href="Graphics-UI-Gtk-Selectors-FileChooserDialog.html#t:FileChooserDialogClass">FileChooserDialogClass</a> <a href="Graphics-UI-Gtk-Selectors-FileChooserDialog.html#t:FileChooserDialog">FileChooserDialog</a></td><td class="doc empty"> </td></tr></table></div></div></div><div class="top"><p class="src"><a name="v:castToFileChooserDialog" class="def">castToFileChooserDialog</a> :: <a href="/usr/share/doc/ghc/html/libraries/glib-0.12.0/System-Glib-GObject.html#t:GObjectClass">GObjectClass</a> obj => obj -> <a href="Graphics-UI-Gtk-Selectors-FileChooserDialog.html#t:FileChooserDialog">FileChooserDialog</a><a href="src/Graphics-UI-Gtk-Types.html#castToFileChooserDialog" class="link">Source</a></p></div><div class="top"><p class="src"><a name="v:gTypeFileChooserDialog" class="def">gTypeFileChooserDialog</a> :: <a href="Graphics-UI-Gtk-Abstract-Widget.html#t:GType">GType</a><a href="src/Graphics-UI-Gtk-Types.html#gTypeFileChooserDialog" class="link">Source</a></p></div><div class="top"><p class="src"><a name="v:toFileChooserDialog" class="def">toFileChooserDialog</a> :: <a href="Graphics-UI-Gtk-Selectors-FileChooserDialog.html#t:FileChooserDialogClass">FileChooserDialogClass</a> o => o -> <a href="Graphics-UI-Gtk-Selectors-FileChooserDialog.html#t:FileChooserDialog">FileChooserDialog</a><a href="src/Graphics-UI-Gtk-Types.html#toFileChooserDialog" class="link">Source</a></p></div><h1 id="g:5">Constructors
</h1><div class="top"><p class="src"><a name="v:fileChooserDialogNew" class="def">fileChooserDialogNew</a><a href="src/Graphics-UI-Gtk-Selectors-FileChooserDialog.html#fileChooserDialogNew" class="link">Source</a></p><div class="subs arguments"><p class="caption">Arguments</p><table><tr><td class="src">:: <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/Data-Maybe.html#t:Maybe">Maybe</a> <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/Data-Char.html#t:String">String</a></td><td class="doc"><p>Title of the dialog (or default)
</p></td></tr><tr><td class="src">-> <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/Data-Maybe.html#t:Maybe">Maybe</a> <a href="Graphics-UI-Gtk-Windows-Window.html#t:Window">Window</a></td><td class="doc"><p>Transient parent of the dialog (or none)
</p></td></tr><tr><td class="src">-> <a href="Graphics-UI-Gtk-Selectors-FileChooser.html#t:FileChooserAction">FileChooserAction</a></td><td class="doc"><p>Open or save mode for the dialog
</p></td></tr><tr><td class="src">-> [(<a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/Data-Char.html#t:String">String</a>, <a href="Graphics-UI-Gtk-Windows-Dialog.html#t:ResponseId">ResponseId</a>)]</td><td class="doc"><p>Buttons and their response codes
</p></td></tr><tr><td class="src">-> <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/System-IO.html#t:IO">IO</a> <a href="Graphics-UI-Gtk-Selectors-FileChooserDialog.html#t:FileChooserDialog">FileChooserDialog</a></td><td class="doc empty"> </td></tr></table></div><div class="doc"><p>Creates a new <code><a href="Graphics-UI-Gtk-Selectors-FileChooserDialog.html#t:FileChooserDialog">FileChooserDialog</a></code>.
</p></div></div><div class="top"><p class="src"><a name="v:fileChooserDialogNewWithBackend" class="def">fileChooserDialogNewWithBackend</a><a href="src/Graphics-UI-Gtk-Selectors-FileChooserDialog.html#fileChooserDialogNewWithBackend" class="link">Source</a></p><div class="subs arguments"><p class="caption">Arguments</p><table><tr><td class="src">:: <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/Data-Maybe.html#t:Maybe">Maybe</a> <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/Data-Char.html#t:String">String</a></td><td class="doc"><p>Title of the dialog (or default)
</p></td></tr><tr><td class="src">-> <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/Data-Maybe.html#t:Maybe">Maybe</a> <a href="Graphics-UI-Gtk-Windows-Window.html#t:Window">Window</a></td><td class="doc"><p>Transient parent of the dialog (or none)
</p></td></tr><tr><td class="src">-> <a href="Graphics-UI-Gtk-Selectors-FileChooser.html#t:FileChooserAction">FileChooserAction</a></td><td class="doc"><p>Open or save mode for the dialog
</p></td></tr><tr><td class="src">-> [(<a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/Data-Char.html#t:String">String</a>, <a href="Graphics-UI-Gtk-Windows-Dialog.html#t:ResponseId">ResponseId</a>)]</td><td class="doc"><p>Buttons and their response codes
</p></td></tr><tr><td class="src">-> <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/Data-Char.html#t:String">String</a></td><td class="doc"><p>The name of the filesystem backend to use
</p></td></tr><tr><td class="src">-> <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/System-IO.html#t:IO">IO</a> <a href="Graphics-UI-Gtk-Selectors-FileChooserDialog.html#t:FileChooserDialog">FileChooserDialog</a></td><td class="doc empty"> </td></tr></table></div><div class="doc"><p>Creates a new <code><a href="Graphics-UI-Gtk-Selectors-FileChooserDialog.html#t:FileChooserDialog">FileChooserDialog</a></code> with a specified backend. This is
especially useful if you use <code><a href="Graphics-UI-Gtk-Selectors-FileChooser.html#v:fileChooserSetLocalOnly">fileChooserSetLocalOnly</a></code> to allow non-local
files and you use a more expressive vfs, such as gnome-vfs, to load files.
</p></div></div></div></div><div id="footer"><p>Produced by <a href="http://www.haskell.org/haddock/">Haddock</a> version 2.9.2</p></div></body></html>
