Lddlgpls: Difference between revisions

From Eigenvector Research Documentation Wiki
Jump to navigation Jump to search
imported>Jeremy
(Importing text file)
imported>Scott
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
===Purpose===
===Purpose===
Provide an "load" dialog box for use with GUIs.
 
Dialog to load variable from workspace or MAT file.
 
===Synopsis===
===Synopsis===
:[value,name,source] = lddlgpls(''klass,message'')
:[value,name,source] = lddlgpls(''klass,message'')
:[value,name,source,dir] = lddlgpls(''klass,message'')
===Description===
===Description===
LDDLPLS creates a dialog box that allows a function to load variables from the workspace or a MATLAB "mat" file into the function workspace. The location of the file to load from can be selecetd from the folders listed in the file list and from the "Look in" menu at the top of the dialog box. Optional input ''klass'' allows the user to select the workspace variable of class to load. Valid values for ''klass'' are:
 
LDDLPLS creates a dialog box that allows a function to load variables from the workspace or a MATLAB "mat" file into the function workspace. The location of the file to load from can be selected from the folders tree in the file list and from the "Look in" menu at the top of the dialog box. Optional input ''klass'' allows the user to select the workspace variable of class to load. Valid values for ''klass'' are:
 
* ''''double'''': loads 2-way DOUBLE variable {default},
* ''''double'''': loads 2-way DOUBLE variable {default},
* ''''cell'''': loads CELL variable,
* ''''cell'''': loads CELL variable,
* ''''char'''': loads 2-way CHAR variable,
* ''''char'''': loads 2-way CHAR variable,
* ''''struct'''': loads a STRUCT variable,
* ''''struct'''': loads a STRUCT variable,
* ''''dataset'''': loads a DATASET object,
* ''''dataset'''': loads a DATASET object,
* ''''doubdataset'''': loads a 2-way DOUBLE or DATASET, or
* ''''doubdataset'''': loads a 2-way DOUBLE or DATASET, or
* ''''\*'''': loads any class and size variable.
 
* ''''*'''': loads any class and size variable.
 
Optional text input ''message'' places a message in the load dialog box.
Optional text input ''message'' places a message in the load dialog box.
Outputs include value the value of the selected variable, name the original name of the variable, and location the filename from which the variable was loaded (will be empty if loaded from the base workspace).
 
Outputs ''value'', ''name'', and ''location'' return the information about the selected variable. ''location'' will be empty if the source was the base workspace. Output ''dir'' will be the directory the file was loaded from. ''dir'' will be ">> Base Workspace <<" if value was loaded from Matlab workspace.
 
See: [[Loading_and_Saving|Load Dialog Box]]
 
===Options===
 
''exitonall'' =  [ {0} | 1 ] when 1, selecting ">>> ALL <<<" from the list of variables will cause the load dialog to exit with an empty output.
 
===See Also===
===See Also===
[[erdlgpls]], [[svdlgpls]]
[[erdlgpls]], [[svdlgpls]]

Latest revision as of 16:22, 30 May 2013

Purpose

Dialog to load variable from workspace or MAT file.

Synopsis

[value,name,source] = lddlgpls(klass,message)
[value,name,source,dir] = lddlgpls(klass,message)

Description

LDDLPLS creates a dialog box that allows a function to load variables from the workspace or a MATLAB "mat" file into the function workspace. The location of the file to load from can be selected from the folders tree in the file list and from the "Look in" menu at the top of the dialog box. Optional input klass allows the user to select the workspace variable of class to load. Valid values for klass are:

  • 'double': loads 2-way DOUBLE variable {default},
  • 'cell': loads CELL variable,
  • 'char': loads 2-way CHAR variable,
  • 'struct': loads a STRUCT variable,
  • 'dataset': loads a DATASET object,
  • 'doubdataset': loads a 2-way DOUBLE or DATASET, or
  • '*': loads any class and size variable.

Optional text input message places a message in the load dialog box.

Outputs value, name, and location return the information about the selected variable. location will be empty if the source was the base workspace. Output dir will be the directory the file was loaded from. dir will be ">> Base Workspace <<" if value was loaded from Matlab workspace.

See: Load Dialog Box

Options

exitonall = [ {0} | 1 ] when 1, selecting ">>> ALL <<<" from the list of variables will cause the load dialog to exit with an empty output.

See Also

erdlgpls, svdlgpls