handlem

Handles of displayed map objects

Syntax

handlem
handlem('taglist')
handlem('prompt')
h = handlem(object)
h = handlem(tagstr)
h = handlem(___,axesh)
h = handlem(___,axesh,'searchmethod')
h = handlem(handles)

Description

handlem displays a dialog box for selecting objects that have their Tag property set.

handlem('taglist') displays a dialog box for selecting objects that have their Tag property set.

handlem('prompt') displays a dialog box for selecting objects based on the object strings listed below.

h = handlem(object) returns the handles of those objects in the current axes specified by the input string, object. The options for the object string are defined by the following list:

'all'

All children

'clabel'

Contour labels

'contour'

hggroups containing contours

'fillcontour'

hggroups containing filled contours

'frame'

Map frame

'grid'

Map grid lines

'hggroup'

All hggroup objects

'hidden'

Hidden objects

'image'

Untagged image objects

'light'

Untagged light objects

'line'

Untagged line objects

'map'

All objects on the map, excluding the frame and grid

'meridian'

Longitude grid lines

'mlabel'

Longitude labels

'parallel'

Latitude grid lines

'plabel'

Latitude labels

'patch'

Untagged patch objects

'scaleruler'

Scaleruler objects

'surface'

Untagged surface objects

''text''

Untagged text objects

'tissot'

Tissot indicatrices

'visible'

Visible objects

h = handlem(tagstr) returns the handles for any objects whose tags match the string tagstr.

h = handlem(___,axesh) searches within the axes specified by the input handle axesh.

h = handlem(___,axesh,'searchmethod') controls the method used to match the object input. If omitted, 'exact' is assumed. Search method 'strmatch' searches for matches that start at the beginning of the tag. Search method 'findstr' searches anywhere within the tag for the object string.

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

A prefix of 'all' may be applied to strings defining a Handle Graphics® object type (text, line, patch, light, surface, or image) to find all object handles that meet the type criteria (for example, 'allimage'). Without the 'all' prefix, only handles with an empty tag are returned.

See Also

Was this topic helpful?