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/ptcontainerbox.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/ptcontainerbox.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/ptcontainerbox.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/ptcontainerbox.html on line 8

PtContainerBox()

Find the next widget in an area

Synopsis:

PtWidget_t * PtContainerBox( PtWidget_t *container,
                             PtWidget_t *start,
                             PhRect_t const *rect );

Library:

ph

Description:

This function returns a pointer to the first widget within the specified container that intersects with the rectangle defined in the PhRect_t structure pointed to by rect.

The widget identified by start tells the function where to start looking for intersections. First, the function checks start's brother behind. Then, it then checks the brother behind that, and so on.

Returns:

If no widget after start intersects with rect or if the provided container pointer doesn't actually point to a container, the function returns NULL.

Examples:

PtWidget_t *target_widget, *my_pane;
...

// In my_pane's RAW callback:
int
my_raw_cb( PtWidget_t *container, void *data, 
           PtCallbackInfo_t *cbinfo )
{
    ...
    rect = PhGetRects( cbinfo->event );
    if( target_widget = PtContainerBox( widget, 
           PtWidgetChildFront( container ) , &rect ) )
           PtDestroyWidget( target_widget );
    ...

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PhGetRects(), PhRect_t, PtContainerHit(), PtWidgetChildFront()


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/ptcontainerbox.html on line 124

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/ptcontainerbox.html on line 124