Mapping Toolbox    
handlem

Get handles of graphics objects

Syntax

Description

handlem or handlem('taglist') displays a dialog box for selecting the objects for which handles are desired.

h = handlem('prompt') displays another dialog box, which allows greater control of object selection.

h = handlem(object) returns the handles of those objects specified by the input string. The options for the object string are:

'all'
 for all children of the current axes
'clabel'
 for contour labels on the current map axes
'contour'
 for contour lines on the current map axes
'frame'
 for the map frame
'grid'
 for the map grid lines
'hidden'
 for hidden objects on the current axes
'image'
 for image objects on the current axes
'light'
 for light objects on the current axes
'line'
 for line objects on the current axes
'map'
 for all objects on the map, excluding the frame (default)
'meridian'
 for longitude grid lines
'mlabel'
 for longitude labels
'parallel'
 for latitude grid lines
'patch'
 for patch objects on the current axes
'plabel'
 for latitude labels
'surface'
 for surface objects on the current axes
'text'
 for text objects on the current axes
'tissot'
 for tissot indicatrices on the current map axes
'visible'
 for visible objects on the current axes

Or any user-defined object tag string.

A prefix of 'all' can be applied to strings defining a Handle Graphics Object type ('allimage', 'allline', 'allsurface', 'allpatch', 'alltext') to determine all object handles that meet the type criteria. Without the 'all' prefix, those objects named by the user with the tagm command are not included (e.g., a line with the tag 'route' would not be included for a object string 'line', but would be for 'allline').

handlem('object',axesh) searches within the axes specified by the input handle axesh.

handlem('object',axesh,'searchmethod') controls the method used to match the 'str' input. If omitted, 'exact' is assumed. Search method 'strmatch' searches for matches at the beginning of the tag, similar to the MATLAB STRMATCH function. Search method 'findstr' searches within the tag, similar to the MATLAB FINDSTR function.

h = handlem(handles) returns those elements of an input vector of handles that are still valid.

See Also
clma
 Clear current map
clmo
 Clear specified graphics objects
hidem
 Hide specified graphics objects
namem
 Determine names of valid graphics objects
showm
 Show specified graphics objects
tagm
 Assign a name to graphics object tag property
            


  gtextm hidem