|
Derived from: BFlattenable
Declared in: be/media/ParameterWeb.h
Library: libmedia.so
Allocation: Constructor only
Summary: more...
A BParameterGroup object serves as a logical grouping of BParameters. Each BParameter belongs to exactly one BParameterGroup, and is in fact created by the BParameterGroup object to which it belongs, via the BParameterWeb::MakeGroup() function.
BParamaeterGroups can be nested one inside another.
A BParameterGroup object that's owned by a BParameterWeb is a logical candidate for a pane in a multi-pane control panel such as a BTabView, wherein each tab causes another BParameterGroup's BParameters to be displayed.
BParameterGroup() |
BParameterGroup() Rather than directly creating a BParameterGroup object via the new operator, you should call BParameterWeb::MakeGroup() to create a top-level group, or BParameterGroup::MakeGroup() if you want to create a subgroup.
~BParameterGroup() |
~BParameterGroup() You don't need to delete a BParameterGroup object; the BParameterWeb that owns it will do this for you when the web is deleted.
CountGroups() |
int32 CountGroups(void) Returns the number of subgroups in the group. This count doesn't subgroups nested within subgroups.
CountParameters() |
int32 CountParameters(void) Returns the number of BParameters in the group. This count doesn't include BParameters in subgroups.
GroupAt() |
BParameterGroup *ParameterGroup(int32 index) Returns the subgroup at the specified index within the BParameterGroup. If the index is negative, or is greater than CountGroups()-1, NULL is returned.
MakeNullParameter() |
BNullParameter *MakeNullParameter(int32 id, media_type type,
const char *name, const char *kind)Creates a new BNullParameter within the group, with the internal ID specified by id, which should be unique within the BParameterWeb that owns the group.
The type of media data that travels through the null parameter is indicated by type, which could be B_MEDIA_UNKNOWN_TYPE or B_MEDIA_NO_TYPE. The parameter's name will be displayed by client applications that display information about the node, and the parameter has the specified kind.
These kinds are used when a control panel needs to draw a signal flow diagram, so it can use the appropriate symbols for these points in the flow.
If you create your own kind, you won't break anything, but you should contact Be Developer Support for guidance, so we can standardize given your needs.
See also: the BNullParameter class.
MakeDiscreteParameter() |
BContinuousParameter *MakeContinuousParameter(int32 id, media_type type,
const char *name, const char *kind)Creates a new BDiscreteParameter object and attaches it to the group. The BDiscreteParameter will have the specified internal id, which should be unique within the BParameterWeb that owns the group.
The BDiscreteParameter will affect media data of the specified type, and will have the specified name.
The kind of discrete parameter is specified by kind, and may be any of the following values:
MakeContinuousParameter() |
BContinuousParameter *MakeContinuousParameter(int32 id, media_type type,
const char *name, const char *kind, const char *unit,
float minValue, float maxValue, float step)Creates a new BContinuousParameter object and attaches it to the group. The BContinuousParameter will have the specified internal id, which should be unique within the BParameterWeb that owns the group.
The BContinuousParameter will affect media data of the specified type, and will have the specified name.
The kind of parameter the BContinuousParameter represents is specified by kind, and may be any of the following values:
The units of measurement are specified by unit, and the parameter's value can range from minValue to maxValue, with a granularity of step.
Name() |
const char *Name(void) Returns the name of the BParameterGroup. This name can be displayed to the user; for example, it could be used as the label of a BTab.
ParameterAt() |
BParameter *ParameterAt(int32 index) Returns the BParameter at the specified index within the BParameterGroup. If the index is negative, or is greater than CountParameters()-1, NULL is returned.
Web() |
BParameterWeb *Web(void) Returns the BParameterWeb that owns the group.
|
Copyright © 2000 Be, Inc. All rights reserved..