28.12.2012 Views

Figure Properties - SERC

Figure Properties - SERC

Figure Properties - SERC

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

Image <strong>Properties</strong><br />

2-1134<br />

Setting HandleVisibility to off makes handles invisible at all times. This<br />

may be necessary when a callback routine invokes a function that might<br />

potentially damage the GUI (such as evaluating a user-typed string), and so<br />

temporarily hides its own handles during the execution of that function.<br />

When a handle is not visible in its parent’s list of children, it cannot be returned<br />

by functions that obtain handles by searching the object hierarchy or querying<br />

handle properties. This includes get, findobj, gca, gcf, gco, newplot, cla, clf,<br />

and close.<br />

When a handle’s visibility is restricted using callback or off, the object’s<br />

handle does not appear in its parent’s Children property, figures do not appear<br />

in the root’s Current<strong>Figure</strong> property, objects do not appear in the root’s<br />

CallbackObject property or in the figure’s CurrentObject property, and axes<br />

do not appear in their parent’s CurrentAxes property.<br />

You can set the root ShowHiddenHandles property to on to make all handles<br />

visible, regardless of their HandleVisibility settings (this does not affect the<br />

values of the HandleVisibility properties).<br />

Handles that are hidden are still valid. If you know an object’s handle, you can<br />

set and get its properties, and pass it to any function that operates on handles.<br />

HitTest {on} | off<br />

Selectable by mouse click. HitTest determines if the image can become the<br />

current object (as returned by the gco command and the figure CurrentObject<br />

property) as a result of a mouse click on the image. If HitTest is off, clicking<br />

the image selects the object below it (which may be the axes containing it).<br />

Interruptible {on} | off<br />

Callback routine interruption mode. The Interruptible property controls<br />

whether an image callback routine can be interrupted by callback routines<br />

invoked subsequently. Only callback routines defined for the ButtonDownFcn<br />

are affected by the Interruptible property. MATLAB checks for events that<br />

can interrupt a callback routine only when it encounters a drawnow, figure,<br />

getframe, or pause command in the routine.<br />

Parent handle of parent axes, hggroup, or hgtransform<br />

Parent of image object. This property contains the handle of the image object’s<br />

parent. The parent of an image object is the axes, hggroup, or hgtransform<br />

object that contains it.

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!