WDS_Divider

WDS_Divider

wds

1998 12-05


CLASS

WDS_Divider - divider widget


SYNOPSIS

Class WDS_Divider allows a user to view one of many children at a time and freely switch between them. A row of divider "tabs" is placed at the top of the widget with one tab for each child widget. Pressing on a divider tab selects the child to be displayed in the remaining area of the widget. Double-clicking a divider tab can cause the associated child to pop out to its own window.


The labels on the divider tabs are defined by using WDS_Widget::SetLabel() for each of the child widgets.


PUBLIC MEMBER FUNCTIONS

Inheritance from class WDS_Widget



void SetSelected(WDS_Widget *set)

WDS_Widget *GetSelected(void)
Set/Get the selected child. If the selected child is NULL or not present on the divider's widgetlist, the first unpopped child will be selected automatically.



void SetPoppable(WDS_Widget *set)

WDS_Widget *GetPoppable(void)
Set/Get the poppability capabilty. If set to nonzero, children can be popped out to their own windows by double-clicking their divider tab. They are popped back when they are again selected on the original parent divider.


STATE CHANGES


WDS_STATE_0 No tab selected -> defaulting to an available tab
WDS_STATE_1 New tab selected


FILES

wds/divider.h Divider header file


SEE ALSO

WDS_intro(3), WDS_Widget(3)


NOTES

The divider widget hides the other widgets by making them invisible and dormant. Only the selected child recieves events, resizes, and redraws.