Scol » Lib2D GTK

h1. Dialogs boxes

!>http://library.gnome.org/devel/gtk/unstable/filechooser.png!

h2. _gtkDialogFileChooserNew

Create and display a File chooser dialog box.

For a better integration, the callback is defined to the creation.

Prototype : *fun [Chn ObjGtkWidget S P I [[I S S] r1] fun [ObjGtkWidget u0 S] u1 u0] ObjGtkWidget*

This seems complex but not, it is easy !

table.

|*channel*|Chn|any channel| |

|*parent*|ObjGtkWidget|the parent|Typically a window|

|*title*|S|a title for the dialog| |

|*initial_path*|P|initial path|Can be nil. If this case, it will be the root active partition|

|*flag*|I|a flag. It can be one of these value|SCOL_GTK_ACTION_OPEN open a file|

| | | |SCOL_GTK_ACTION_SAVE save a file|

| | | |SCOL_GTK_ACTION_SELECT_FOLDER select a folder|

| | | |SCOL_GTK_ACTION_CREATE_FOLDER create a folder|

|*filters*|[[I S S] r1]|the filters|each tuple is composed by a flag, the filter itself (e.g. "*.png" or "*.txt" ...) and a name which will be displayed

The flag can be : SCOL_GTK_DIALOG_FILTER_PATTERN (by default), SCOL_GTK_DIALOG_FILTER_MIMETYPE or SCOL_GTK_DIALOG_FILTER_IMAGE|

|*callback*|fun [ObjGtkWidget u0 S] u1|The callback called when the user click on a button| |

|*userparam*|u0|user parameter for the callback|at your convenience|

+Return+ : a Scol object or nil if error

h3. About the callback

Its prototype is fun [ObjGtkWidget u0 S] u1

The supplemental argument is the selected path. This path is relative to the partition.

It needn't to destroy this widget. It should be it automatically.

If the user clicks on the Cancel button or the close icon, the callback won't be called.

If no path is selected or the path is incorect, the supplemental argument is nil.

See [[Examples]]

Return [[Api]]