Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

PtSurfaceHit()

Find the control surface hit by a given point

Synopsis:

PtSurface_t *PtSurfaceHit(
                PtWidget_t *widget,
                PhPoint_t const *point,
                ulong_t event_mask,
                PtSurface_t const *surface );

Library:

ph

Description:

PtSurfaceHit() finds the control surface, belonging to the given widget, at the coordinates pointed to by point.

The event_mask specifies the event types to which the control surface must be sensitive. A value of 0 means any event types.

The surface argument, if not NULL is the control surface to test first.

Returns:

A pointer to the control surface hit by the given point, or NULL if there isn't one or an error occurred.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PhPoint_t, PtSurfaceCalcBoundingBox(), PtSurfaceRect(), PtSurfaceTestPoint()

Control Surfaces chapter of the Photon Programmer's Guide