TestControl

Determine if a point is in a control

#include <Controls.h> Control Manager

short TestControl( theControl, localPt );

ControlHandle theControl ; handle of control in active window

Point localPt ; in local coordinates of the active window

returns a part code (or 0 if localPt is in no control)

TestControl tests a point, in local coordinates, to see if it is associated with

any control in the current window (and if so, which part of that control). This

function is NOT normally used by application programs.

theControl is a handle leading to a variable-length ControlRecord structure. It

specifies which control to test. It must be a control associated with

the current window if you want meaningful results.

localPt is a 4-byte Point structure, expressed in local coordinates of the

current window.

Returns: a short; 0 indicates localPt is not in any control or theControl is

inactive. Any other value is a "part code" whose meaning is specific

to the handler for theControl. See FindControl for a list of part

codes for standard controls.

Notes: This function is used internally by FindControl and TrackControl. It

might be used in a custom control handler as part of the routine to respond to

the testCntl message (see Custom Controls).

This function assumes that the control to test is in the current window

Referenced by (6):