Figure Properties - SERC

2hggroup
Purpose Create hggroup object
Syntax h = hggroup
h = hggroup(...,'PropertyName',propertyvalue)
hggroup
Description An hggroup object can be the parent of any axes children, including other
hggroup objects. You can use hggroup objects to form a group of objects that can
be treated as a single object with respect to the following cases:
Visible — Setting the hggroup object’s Visible property also sets each child
object’s Visible property to the same value.
Selectable — Setting each hggroup child object’s HitTest property to off
enables you to select all children by clicking any child object.
Current object — Setting each hggroup child object’s HitTest property to off
enables the hggroup object to become the current object when any child
object is picked. See the next section for an example.
Examples This example defines a callback for the ButtonDownFcn property of an hggroup
object. In order for the hggroup to receive the mouse button down event that
executes the ButtonDownFcn callback, the HitTest properties of all the line
objects must be set to off. The event is then passed up the hierarchy to the
hggroup.
The following function creates a random set of lines that are parented to an
hggroup object. The subfunction set_lines defines a callback that executes
when the mouse button is pressed over any of the lines. The callback simply
increases the widths of all the lines by 1 with each button press.
Note If you are using the MATLAB help browser, you can run this example
or open it in the MATLAB editor.
function doc_hggroup
hg = hggroup('ButtonDownFcn',@set_lines);
hl = line(randn(5),randn(5),'HitTest','off','Parent',hg);
function set_lines(cb,eventdata)
hl = get(cb,'Children');% cb is handle of hggroup object
2-1065