get

Arguments

h

handle, the handle of the entity to retrieve a property. h can be a vector of handles, in which case get returns the property value for all objects contained in h. h can also be 0 to get the root object properties.

prop

character string name of the property.

val

value of the property.

Description

This routine can be used to retrieve the value of a specified property from a graphics entity or a GUI object. In this case it is equivalent to use the dot operator on an handle. For exemple, get(h,"background") is equivalent to h.background.

Property names are character strings. To get the list of all existing properties see graphics_entities or uicontrol for User Interface objects.

get function can be also called with only a property as argument. In this case, the property must be one of the following:

current_entity or hdl

returns a handle on the lastly created (and still existent) entity. get('current_entity') and get('hdl') are equivalent to gce.

current_figure

returns a handle on the current graphic figure. get('current_figure') is equivalent to gcf.

current_axes

returns a handle on the current axes entity. get('current_axes') is equivalent to gca.

default_figure

returns a handle on the default figure entity. get('default_figure') is equivalent to gdf.

default_axes

returns a handle on the default axes entity. get('default_axes') is equivalent to gda.

figures_id

returns a row vector containing ids of all opened graphic figures. get('figures_id') is equivalent to winsid.

Examples

// for graphics entities
 clf()
    
// simple graphics objects  
subplot(121);
x=[-.2:0.1:2*%pi]';
plot2d(x-2,x.^2);
subplot(122);
xrect(.2,.7,.5,.2);     
xrect(.3,.8,.3,.2);
xfarc(.25,.55,.1,.15,0,64*360);
xfarc(.55,.55,.1,.15,0,64*360);
xstring(0.2,.9,"Example <<A CAR>>");
 
h=get("current_entity") //get the newly object created
h.font_size=3;
 
f=get("current_figure") //get the current figure 
f.figure_size
f.figure_size=[700 500];
f.children
f.children(2).type
f.children(2).children
f.children(2).children.children.thickness=4; 
 
a=get("current_axes") //get the current axes
a.children.type
a.children.foreground //get the foreground color of a set of graphics objects
a.children.foreground=9;

// for  User Interface objects
h=uicontrol('string', 'Button'); // Opens a window with a  button.
p=get(h,'position'); // get the geometric aspect of the button
disp('Button width: ' + string(p(3))); // print the width of the button
close(); // close figure

See Also

• uicontrol — create a Graphic User Interface object
• root_properties — description of the root object properties.
• graphics_entities — description of the graphics entities data structures
• set — set a property value of a graphic entity object or of a User Interface object.

Authors

Djalel ABDEMOUCHE