Scilab Home page | Wiki | Bug tracker | Forge | Mailing list archives | ATOMS | File exchange
Please login or create an account
Change language to: English - Français - Português - 日本語 -
Справка Scilab >> GUI > uiputfile

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");

See also

  • uigetfile — dialog window to get a file(s) name(s), path and filter index
  • uigetdir — dialog for selecting a directory
Scilab Enterprises
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Mon Feb 12 20:08:39 CET 2018