Main Content

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 objects listed below.

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

'all'

All children

'clabel'

Contour labels

'contour'

hggroup containing contours

'fillcontour'

hggroup 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 any graphics objects whose tags match the value of tagstr.

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

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 .

h = handlem(handles) returns those graphics objects in the input vector of graphics objects that are still valid.

You can apply the prefix 'all' when defining an object type (text, line, patch, light, surface, or image) to find all objects that meet the type criteria (for example, 'allimage'). Without the 'all' prefix, handlem returns only objects with an empty tag.

See Also

Introduced before R2006a