Figure Properties - SERC

Line Properties
color with that of the pixel behind it) and ignore three-dimensional sorting to
obtain greater rendering speed. However, these techniques are not applied to
the printed output.
You can use the MATLAB getframe command or other screen capture
application to create an image of a figure containing nonnormal mode objects.
HitTest {on} | off
Selectable by mouse click. HitTest determines if the line can become the
current object (as returned by the gco command and the figure CurrentObject
property) as a result of a mouse click on the line. If HitTest is off, clicking the
line selects the object below it (which may be the axes containing it).
HandleVisibility {on} | callback | off
Control access to object’s handle by command-line users and GUIs. This
property determines when an object’s handle is visible in its parent’s list of
children. HandleVisibility is useful for preventing command-line users from
accidentally drawing into or deleting a figure that contains only user interface
devices (such as a dialog box).
Handles are always visible when HandleVisibility is on.
Setting HandleVisibility to callback causes handles to be visible from
within callback routines or functions invoked by callback routines, but not from
within functions invoked from the command line. This provides a means to
protect GUIs from command-line users, while allowing callback routines to
have complete access to object handles.
Setting HandleVisibility to off makes handles invisible at all times. This
may be necessary when a callback routine invokes a function that might
potentially damage the GUI (such as evaluating a user-typed string), and so
temporarily 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 be returned
by functions that obtain handles by searching the object hierarchy or querying
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’s
handle does not appear in its parent’s Children property, figures do not appear
in the root’s CurrentFigure property, objects do not appear in the root’s
CallbackObject property or in the figure’s CurrentObject property, and axes
do not appear in their parent’s CurrentAxes property.
2-1327