groupgclass


Class:                  groupgclass
Superclass:             gadgetclass
Description:            Composite gadget objects
Include File:           


New Methods:
------------

None


Changed Methods:
----------------

OM_SET - Passes most attributes to the superclass, but propagates
changes in position to its members appropriately. Also, GA_Width and
GA_Height are calculated from the position and dimension of the
membership.


OM_ADDMEMBER - add a gadget to the group list.  Add the gadgets you want
in the group right after you create it and leave them there until you
are done.  Note that all members of the groupgclass object will be
deleted by OM_DISPOSE.


OM_DISPOSE - this class will dispose of the object and all its member
gadgets.


Attributes:
-----------

LAYOUTA_Orientation
LAYOUTA_Spacing
LAYOUTA_LayoutObj

These attributes specify simple layout parameters and a "layout object
delegate" are not currently implemented.  GA_Width and GA_Height are
calculated from the membership.


GA_Left                         (IS)
GA_Position                     (IS)

These are propagated magically to the membership.

The gadget relative flags (GA_RelWidth, GA_RelHeight, and so on) are not
supported.

Notes

This is one of the more elusive classes since there aren't any readily available examples given in the RKMs. It turns out that its actually simple to use and subclasses can make GUIs more convenient. To use it you simply create the groupgclass and then use the OM_ADDMEMBER method and add whatever gadgets you want. You can then move, add, remove the group gadget and all of the gadgets that it contains will go with it making manipulation much easier. Common GUI elements, such as a proportional scroll bar and its accompanying arrows, can be easily created by making a subclass of groupgclass and have its OM_NEW method automatically create and add gadgets to the groupgclass.