Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
2024.1.0 - English


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
Report an issue
<< uigetfont GUI usecanvas >>

Copyright (c) 2022-2024 (Dassault Systèmes)
Copyright (c) 2017-2022 (ESI Group)
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Mon Jun 17 17:49:17 CEST 2024