## wb_sys_dlg_save

string wb_sys_dlg_save (int parent [, string title [, string filter[, string path[, string filename [, string default_extension]]]]])

Displays the standard Save As dialog box. Returns the typed file name, if any, or a blank string if the dialog box was canceled. Returns NULL if not successful.

# Parameters

parent is a handle to the WinBinder object that will serve as the parent for the dialog box.
title is the optional string to be displayed as the dialog box caption.
filter is an optional two-dimensional array composed of pairs of file descriptions and valid file name patterns (usually file extensions). If filter is NULL, the dialog box will display a default "All files" filter. The filter takes the following generic form:

array(array(descr1, pat1) [, array(descr2, pat2) [, ...]])

path is an optional folder used to initialize the dialog box.
filename is an optional default name for the file. If parameter filter is NULL, the file extension will be used as the filter instead.
default_extension is optional and defines a default extension for the dialog box.

# Example

// Snippet showing how to use a standard Save As dialog box $filename = wb_sys_dlg_save($window, "Save As", NULL, $path, $currentfile, 'txt'); if($filename) { // Do action here }

# See also

wb_sys_dlg_open
Dialog functions