Scilab Home page | Wiki | Bug tracker | Forge | Mailing list archives | ATOMS | File exchange
Please login or create an account
Change language to: Français - Português - 日本語 - Русский
Scilab Help >> GUI > getvalue

getvalue

xwindow dialog for data acquisition

Syntax

[ok, x1,..,x14] = getvalue(desc, labels, typ, ini)

Arguments

desc

column vector of strings, dialog general comment. Any "<" character must be replaced with "&lt;".

labels

n column vector of strings, labels(i) is the label of the ith required value.

typ

list(typ_1,dim_1,..,typ_n,dim_n)

typ_i

defines the type of the ith value. By default, inputs are interpreted as decimal numbers. Columns of (rows of) values must be separated with ";". typ_i may have the following values:

"mat"matrix
"col"column vector
"row"row vector
"vec"vector (free orientation)
"intvec"scalar, vector or matrix of integers.
"str"scalar, vector or matrix of texts, delimited with ".."
"lis"list: not implemented.
dim_i

defines the size of the ith value it must be an integer or a 2-vector of integer, -1 stands for undefined dimension.

ini

n column vector of strings, ini(i) gives the suggested response for the ith required value

ok

boolean ,%t if ok button pressed, %f if cancel button pressed

xi

contains the ith value if ok=%t. If left hand side has one more xi than required values the last xi contains the vector of answered strings.

Description

This function encapsulate x_mdialog function with error checking, evaluation of numerical response, ...

All valid expressions can be used as inputs. For matrices and vectors, getvalues() automatically adds [ ] around each group of input before their evaluation.

Examples

labels=["magnitude" ; "frequency" ; "phase    "];
[ok,mag,Freq,ph] = getvalue("define sine signal",labels,...
     list("vec",1,"vec",1,"vec",1), ["0.85";"10^2";"%pi/3"])

See also

  • x_mdialog — Dialog for interactive vector/matrix input.
  • x_matrix — Xwindow editing of matrix
  • x_dialog — Dialog for interactive multi-lines input.
Scilab Enterprises
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Tue Feb 25 08:49:21 CET 2020