Insert a widget in the widget family hierarchy
int PtWidgetInsert ( PtWidget_t *widget, PtWidget_t *new_sibling, int behind );
This function inserts widget into the widget family hierarchy as a brother of the widget new_sibling, based on the value of behind:
Use this function to insert a widget into the focus order of a group.
|Remember that the focus order goes from the back of the widget family hierarchy to the front.|
For example, if you have widget A and widget C with a focus order of A→C, you can insert widget B into the focus order after widget A by making the following call:
PtWidgetInsert (B, A, 0);
The focus order is then A→B→C.
PtGetParentWidget(), PtWidgetBrotherBehind(), PtWidgetBrotherInFront(), PtWidgetChildBack(), PtWidgetChildFront(), PtWidgetParent(), PtWidgetToBack(), PtWidgetToFront()
“Ordering widgets” in the Managing Widgets in Application Code chapter of the Photon Programmer's Guide