MATLAB Function Reference (Volume 2: Graphics)

Patch Propertiesprotect GUIs from command-line users, while allowing callback routines tohave complete access to object handles.Setting HandleVisibility to off makes handles invisible at all times. Thismay be necessary when a callback routine invokes a function that mightpotentially damage the GUI (such as evaluating a user-typed string), and sotemporarily hides its own handles during the execution of that function.When a handle is not visible in its parent’s list of children, it cannot bereturned by functions that obtain handles by searching the object hierarchy orquerying handle properties. This includes get, findobj, gca, gcf, gco, newplot,cla, clf, and close.When a handle’s visibility is restricted using callback or off, the object’shandle does not appear in its parent’s Children property, figures do not appearin the root’s CurrentFigure property, objects do not appear in the root’sCallbackObject property or in the figure’s CurrentObject property, and axesdo not appear in their parent’s Currentaxes property.You can set the root ShowHiddenHandles property to on to make all handlesvisible, regardless of their HandleVisibility settings (this does not affect thevalues of the HandleVisibility properties).Handles that are hidden are still valid. If you know an object’s handle, you canset and get its properties, and pass it to any function that operates on handles.HitTest{on} | offSelectable by mouse click. HitTest determines if the patch can become thecurrent object (as returned by the gco command and the figure CurrentObjectproperty) as a result of a mouse click on the patch. If HiTest is off, clicking onthe patch selects the object below it (which maybe the axes containing it).Interruptible {on} | offCallback routine interruption mode. The Interruptible property controlswhether a patch callback routine can be interrupted by subsequently invokedcallback routines. Only callback routines defined for the ButtonDownFcn areaffected by the Interruptible property. MATLAB checks for events that caninterrupt a callback routine only when it encounters a drawnow, figure,getframe, or pause command in the routine. See the BusyAction property forrelated information.2-335