MATLAB Function Reference (Volume 2: Graphics)

Surface PropertiesSetting HandleVisibility to callback causes handles to be visible fromwithin callback routines or functions invoked by callback routines, but not fromwithin functions invoked from the command line. This provides a means toprotect 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 surface can become thecurrent object (as returned by the gco command and the figure CurrentObjectproperty) as a result of a mouse click on the surface. If HiTest is off, clickingon the surface selects the object below it (which maybe the axes containing it).Interruptible {on} | offCallback routine interruption mode. The Interruptible property controlswhether a surface 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,2-488