MATLAB Function Reference (Volume 2: Graphics)

Figure PropertiesFixed color definitions reside in the system color table and do not appear in thefigure colormap. For this reason, fixed colors can limit the number ofsimultaneously displayed colors if the number of fixed colors plus the numberof entries in the figure colormap exceed your system’s maximum number ofcolors.(See the root ScreenDepth property for information on determining the totalnumber of colors supported on your system. See the MinColorMap andShareColors properties for information on how MATLAB shares colorsbetween applications.)HandleVisibility{on} | callback | offControl access to object’s handle by command-line users and GUIs. Thisproperty determines when an object’s handle is visible in its parent’s list ofchildren. HandleVisibility is useful for preventing command-line users fromaccidentally drawing into or deleting a figure that contains only user interfacedevices (such as a dialog box).Handles are always visible when HandleVisibility is on.Setting 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.2-174