A container that divides space among its children
PtWidget → PtBasic → PtContainer → PtCompound → PtDivider
For more information, see the diagram of the widget hierarchy.
<photon/PtDivider.h>
The PtDivider widget is a container that lays out its children like a one-row or one-column PtGroup widget, but lets you resize the children by dragging “handles” placed between the children.
The PtDivider class inherits resources from the PtGroup class. Access to these resources is controlled through PtDivider's exporting mechanism.
A blocking mechanism lets PtDivider block the inheritance of certain resources from its subordinate PtGroup widget. This prevents any actions that would negatively affect the look and behavior of a PtDivider widget. For more information, see the “Exported subordinate children” section.
In this example, we use the Pt_CB_DIVIDER_HANDLE_CALLBACK callback to set the default widget sizes:
static int default_sizes[] = { 100, 50, 60, 200, ... }; int drag_handle_cb( PtWidget_t *dvdr, ApInfo_t *data, PtCallbackInfo_t *cbinfo ) ) { PtDividerHandleCallback_t *cbdata = cbinfo->cbdata; PhEvent_t *ev = cbinfo->event; PhPointerEvent_t *pe = PhGetData( ev ); if( ev->type == Ph_EV_BUT_RELEASE && ev->subtype == Ph_EV_RELEASE_REAL && pe->click_count == 2 ) { // Set the default size on a double click PtSetResource( cbdata->left, Pt_ARG_WIDTH, default_sizes[cbdata->index], 0 ); } }
Resource | C type | Pt type | Default |
---|---|---|---|
Pt_ARG_DIVIDER_FLAGS | unsigned short | Flag | Pt_DIVIDER_RESIZE_BOTH |
Pt_ARG_DIVIDER_OFFSET | short | Scalar | 0 |
Pt_ARG_DIVIDER_SIZES | PtDividerSizes_t *, short | Array | NULL, 0 (read-only) |
Pt_CB_DIVIDER_DRAG | PtCallback_t * | Link | NULL |
Pt_CB_DIVIDER_HANDLE_CALLBACK | PtCallback_t * | Link | NULL |
C type | Pt type | Default |
---|---|---|
unsigned short | Flag | Pt_DIVIDER_RESIZE_BOTH |
Possible values:
C type | Pt type | Default |
---|---|---|
short | Scalar | 0 |
This number is added to positions of child widgets (relative to the position of the PtDivider widget) when the values for the Pt_ARG_DIVIDER_SIZES resource are calculated. By setting Pt_ARG_DIVIDER_OFFSET, you can make the Pt_ARG_DIVIDER_SIZES relative to any arbitrary point.
C type | Pt type | Default |
---|---|---|
PtDividerSizes_t *, short | Array | NULL, 0 |
The array of positions and sizes of realized children of the divider. Each PtDividerSizes_t structure contains:
C type | Pt type | Default |
---|---|---|
PtCallback_t * | Link | NULL |
A list of PtCallback_t structures that define the callbacks that are invoked when the widget receives a drag event.
If the widget has the Pt_CALLBACKS_ACTIVE bit set in its Pt_ARG_FLAGS resource, these callbacks are also invoked when your application changes the size of a child by calling PtSetResource() or PtSetResources().
Each callback is passed a PtCallbackInfo_t structure that contains at least the following members:
These callbacks should return Pt_CONTINUE.
C type | Pt type | Default |
---|---|---|
PtCallback_t * | Link | NULL |
A list of PtCallback_t structures that define the callbacks that are invoked when you press the pointer button when pointing at widget's resize handles, and also when the button is released.
Each callback is passed a PtCallbackInfo_t structure that contains at least the following members:
These callbacks should return Pt_CONTINUE.
Unless the resources are already defined in PtDivider, the PtDivider class uses the resources of its exported subordinate child, PtGroup.
Where PtDivider and PtGroup both define resources having the same name, the resource defined in PtDivider takes precedence.
If PtDivider modifies an inherited resource, the “Default override” column indicates the new value. If PtDivider inherits a resource from PtGroup, the default value assigned by PtGroup is inherited too; the “Default override” column shows this default value.
Defines the “graphics bandwidth” threshold that determines whether the widget resizes the children after each received drag event or only once, when the drag is completed — see PtQuerySystemInfo().
The value of this resource can be only Pt_GROUP_HORIZONTAL or Pt_GROUP_VERTICAL.