The SelectInputData function method displays a dialog in which the user selects files for rasters or vectors.

Example


; Launch the application
e = ENVI()
 
; Create an ENVIRaster
file = FILEPATH('qb_boulder_msi', ROOT_DIR=e.ROOT_DIR, $
  SUBDIRECTORY = ['data'])
raster = e.OpenRaster(file)
 
; Get the UI object
UI = e.UI
 
; Choose a raster from the dialog box
raster = UI.SelectInputData(/RASTER)
 
; Now display the chosen raster.
view = e.GetView()
layer = view.CreateLayer(raster)

Syntax


Result = ENVIUI.SelectInputData([, Keywords=value])

Return Value


This method normally returns an ENVIRaster or ENVIVector. If the dialog is closed before a file is selected, or if Cancel is clicked, !NULL is returned.

Arguments


None

Keywords


Keywords are applied only during the initial creation of the object.

ALLOW_MULTIPLE

Set this keyword to allow multiple selection in the data-selection dialog. When this keyword is set, SelectInputData can return an array of data objects.

APPLY_SUBSET

Set this keyword to return a subsetted ENVIRaster from the extents and bands specified by the end user. This keyword cannot be used with the ALLOW_MULTIPLE keyword.

BANDS

Set this keyword to a named variable that will contain the spectral subset information chosen in the dialog.

DIALOG_PARENT

Set this keyword to the widget ID of a widget to be used as the parent of this dialog. When this ID is specified, the closing of the caller dialog results in the closing of the SelectInputData dialog.

DISABLE_BANDS

Set this keyword to disable the dialog option of choosing bands (all bands are used). All bands in the selected raster are returned by the BANDS keyword.

Note: This keyword is not applicable to vectors. If you select a vector file in the dialog, the dialog option of choosing bands will be disabled, and the keyword will be ignored.

DISABLE_MASK

Set this keyword to disable the dialog option of choosing a mask.

Note: This keyword is not applicable to vectors. If you select a vector file in the dialog, the option to choose bands will be disabled, and this keyword will be ignored.

DISABLE_SUB_RECT

Set this keyword to disable the dialog option of setting a spatial subset. The selected raster's full extent is returned by the SUB_RECT keyword.

Note: This keyword is not applicable to vectors. If you select a vector file in the dialog, the dialog option of setting a spatial subset will be disabled, and the keyword will be ignored.

ERROR

Set this keyword to a named variable that will contain any error message issued during execution of this routine. If no error occurs, the ERROR variable will be set to a null string (''). If an error occurs and the routine is a function, then the function result will be undefined.

When this keyword is not set and an error occurs, ENVI returns to the caller and execution halts. In this case, the error message is contained within !ERROR_STATE and can be caught using IDL's CATCH routine. See IDL Help for more information on !ERROR_STATE and CATCH.

See Manage Errors for more information on error handling in ENVI programming.

MODALITY

Set this keyword to specify that the dialog should only display rasters whose MODALITY property matches the requested modality. Possible values are Optical, Radar, DEM, and Thermal.

RASTER

Set this keyword to specify that the dialog should only display raster files that are supported by ENVI.

SUB_RECT

Set this keyword to a named variable that will contain the spatial subset information chosen in the dialog.

TITLE

Set this keyword to a string with a custom title bar for the dialog. The default title is Select Input Data.

VECTOR

Set this keyword to specify that the dialog should only display vector files that are supported by ENVI.

Note: The RASTER and VECTOR keywords may not both be set. If neither is set, the dialog displays all files with ENVI-supported formats.

Version History


ENVI 5

Introduced

ENVI 5.3

Added APPLY_SUBSET and DISABLE_MASK keywords

ENVI 6.1

Removed DISABLE_NO_DATA and NO_DATA keywords. Added MODALITY keyword.

API Version


4.3

See Also


ENVIUI, ENVIUI::SelectCoordinateSystem