HitTestPoint method

  • Article

Gets a value that specifies whether the point is contained in the Dynamic HTML (DHTML) behavior.

Syntax

HRESULT retVal = object.HitTestPoint(pPoint, pReserved, pbHit);

Parameters

  • pPoint [in]
    Type: POINT

    A pointer to a POINT structure that specifies the point to test.

  • pReserved [in]
    Type: IUnknown

    Reserved. Must be set to NULL.

  • pbHit [out, retval]
    Type: BOOL

    A pointer to a Boolean value that returns TRUE if the point indicates a hit.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

Use this method to provide accurate hit testing for irregularly shaped objects.

You must return the BEHAVIORRENDERINFO_HITTESTING flag from the IElementBehaviorRender::GetRenderInfo method to participate in hit testing.

This method is available in Microsoft Internet Explorer 5, but is not supported in later versions. Instead, use the IHTMLPainter interface and the IHTMLPaintSite interface.