provides the functionality needed
for configuring/referencing component options with the
"<agg_widget_instance>_<component_option>"
notation
for component layout by calling their onInstantiate
method
The basic orientation of the sizer is determined by the
constructor keyword argument "orientation".
By convention, a component of name "foo" is stored as an
attribute "_foo" and can be referenced with .foo (although
the .getComponent method is preferable for this purpose).
Components are declared in the class name space of the
aggregated widget class as a dictionary "COMPONENTS", which
is of the form
{ <component name> : <component instance> }
where <component instance> is an instance of a (subclass of)
Component, a simple wrapper that allows static definition
of widgets to be instantiated later.
Optionally, a tuple "ADDOPTIONS" of the form
( (<component name>, <sizer arguments>), ... )
where <sizer arguments> is a tuple of arguments to be passed
to the Add method of the sizer for the component specified
by <component name> to specify the layout of the components.
If it is defined, it needs to supply layout options for each
of the components declared in the "COMPONENTS" dictionary.
|