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 a 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.