uiputfile

Open standard dialog box for selecting and saving file.

Syntax

PathFileName = uiputfile()
PathFileName = uiputfile(file_mask)
PathFileName = uiputfile(file_mask, dir)
PathFileName = uiputfile(file_mask, dir, boxTitle)
[PathFileName, Path] = uiputfile(..)
[PathFileName, Path, FilterIndex] = uiputfile(..)

Arguments

Input parameters

file_mask

Matrix of strings providing the file masks to use for file selection. file_mask is written with Unix conventions. The default value is '*'.

A description of each mask may be provided in column#2 and displayed, for example ["*.xcos|*.zcos*","Xcos files"; "*.scg", "Scilab graphics"].

dir

a character string which gives the initial directory used for file search. By default uiputfile uses the previously selected directory.

boxTitle

a character string which gives the title of the uiputfile window. By default uiputfile's title is 'uiputfile'.

Output parameters

PathFileName: String which gives the user selected file (path + file name) if the user quits with "OK", or " " if the user quits with "Cancel".
Path: is the user selected file path if user answers "Ok" or the " " string if user answers "Cancel".
FilterIndex: is the user selected filter index on the list box if the user quits with "OK", or "0" if the user quits with "Cancel".

Description

Creates a dialog window for file saving.

Examples

uiputfile(["*.bin"; "*.sce"; "*.cos*"])
uiputfile(["*.xcos|*.zcos", "Xcos files"; "*.sce|*.sci", "Scilab scripts"])
uiputfile(["*.sci"; "*.bin"], "SCI/modules/gui/macros/")
uiputfile(["*.sc*"; "*.bin"], "SCI/modules/gui/macros/")
uiputfile(["*.x*","X files"; "*.bin","BIN files"], "SCI/modules/gui/macros/")
uiputfile(["*.sce"; "*.bin"], "SCI/modules/gui/macros/", "Choose a file name");

Report an issue
<< uigetfont	GUI	usecanvas >>