Warning: main(/www/www/htdocs/style/globals.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/lib_ref/pt/ptwidgetinsert.html on line 1

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/globals.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/lib_ref/pt/ptwidgetinsert.html on line 1

Warning: main(/www/www/htdocs/style/header.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/lib_ref/pt/ptwidgetinsert.html on line 8

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/header.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/lib_ref/pt/ptwidgetinsert.html on line 8

PtWidgetInsert()

Insert a widget in the widget family hierarchy

Synopsis:

int PtWidgetInsert ( PtWidget_t *widget,
                     PtWidget_t *new_sibling,
                     int behind );

Library:

ph

Description:

This function inserts widget into the widget family hierarchy as a brother of the widget new_sibling, based on the value of behind:

0
Insert widget in front of new_sibling.
1
Insert widget behind new_sibling.

Use this function to insert a widget into the focus order of a group.


Note: 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 AC, 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 ABC.

Returns:

0
Success.
-1
An error occurred.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PtGetParentWidget(), PtWidgetBrotherBehind(), PtWidgetBrotherInFront(), PtWidgetChildBack(), PtWidgetChildFront(), PtWidgetParent(), PtWidgetToBack(), PtWidgetToFront()

Ordering widgets in the Managing Widgets in Application Code chapter of the Photon Programmer's Guide


Warning: main(/www/www/htdocs/style/footer.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/lib_ref/pt/ptwidgetinsert.html on line 146

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/footer.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/lib_ref/pt/ptwidgetinsert.html on line 146