MATLAB Functions

Get object properties

get(h)
get(h,'PropertyName')
<m-by-n value cell array> = get(H,<property cell array>)
a = get(h)
a = get(0,'Factory')
a = get(0,'FactoryObjectTypePropertyName')
a = get(h,'Default')
a = get(h,'DefaultObjectTypePropertyName')

Description

get(h)

returns all properties and their current values of the graphics object identified by the handle h.

get(h,'PropertyName')

returns the value of the property 'PropertyName' of the graphics object identified by h.

<m-by-n value cell array> = get(H,pn)

returns n property values for m graphics objects in the m-by-n cell array, where m = length(H) and n is equal to the number of property names contained in pn.

a = get(h)

returns a structure whose field names are the object's property names and whose values are the current values of the corresponding properties. h must be a scalar. If you do not specify an output argument, MATLAB displays the information on the screen.

a = get(0,'Factory')

returns the factory-defined values of all user-settable properties. a is a structure array whose field names are the object property names and whose field values are the values of the corresponding properties. If you do not specify an output argument, MATLAB displays the information on the screen.

a = get(0,'FactoryObjectTypePropertyName')

returns the factory-defined value of the named property for the specified object type. The argument, FactoryObjectTypePropertyName is the word Factory concatenated with the object type (e.g., Figure) and the property name (e.g., Color).

a = get(h,'Default')

returns all default values currently defined on object h. a is a structure array whose field names are the object property names and whose field values are the values of the corresponding properties. If you do not specify an output argument, MATLAB displays the information on the screen.

a = get(h,'DefaultObjectTypePropertyName')

returns the factory-defined value of the named property for the specified object type. The argument, DefaultObjectTypePropertyName is the word Default concatenated with the object type (e.g., Figure) and the property name (e.g., Color).

Examples

You can obtain the default value of the LineWidth property for Line graphics objects defined on the Root level with the statement:

get(0,'DefaultLineLineWidth')
ans =
     0.5000

To query a set of properties on all Axes children define a cell array of property names:

props = {'HandleVisibility', 'Interruptible';
        'SelectionHighlight', 'Type'};
output = get(get(gca,'Children'),props);

The variable output is a cell array of dimension: length(get(gca,'Children') by 4.

For example, type:

patch;surface;text;line
output = get(get(gca,'Children'),props)
output = 

    'off'    'on'    'off'    'line' 
    'off'    'on'    'off'    'text' 
    'off'    'on'    'off'    'surface'
    'off'    'on'    'off'    'patch'