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

PtHit()

Identify a widget in the specified container

Synopsis:

PtWidget_t *PtHit( PtWidget_t *container,
                   unsigned n,
                   PhRect_t const *rect );

Library:

ph

Description:

This function returns container's nth child widget whose extent intersects with the rectangle defined in the PhRect_t pointed to by rect. The rectangle's coordinates must be relative to container's canvas. PtHit() ignores unrealized or procreated widgets.

Returns:

A pointer to the container's nth widget who's extent intersects with rect, or NULL if there's no such child widget.

Classification:

Photon

Safety:
Interrupt handler	No
Signal handler	No
Thread	No