Handles of displayed map objects


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


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 children


Contour labels


hggroups containing contours


hggroups containing filled contours


Map frame


Map grid lines


All hggroup objects


Hidden objects


Untagged image objects


Untagged light objects


Untagged line objects


All objects on the map, excluding the frame and grid


Longitude grid lines


Longitude labels


Latitude grid lines


Latitude labels


Untagged patch objects


Scaleruler objects


Untagged surface objects


Untagged text objects


Tissot indicatrices


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?