Tests whether a specified point is within the rectangle of the text services object.
HRESULT TxQueryHitPoint( [in] DWORD dwDrawAspect, LONG lindex, [in] void *pvAspect, [in] DVTARGETDEVICE *ptd, [in] HDC hdcDraw, [in] HDC hicTargetDev, [in] LPCRECT lprcClient, [in] INT x, [in] INT y, [out] DWORD *pHitResult );
- dwDrawAspect [in]
Draw aspect can be one of the following values.
Renders a screen image of the text content to the hdcDraw device context.
The hicTargetDev and ptd parameters give information on the target device context if any (usually a printer).
Renders the object to the hdcDraw device context as though it were printed to a printer. Thus, the text services object can optimize for the printer (for example, not painting the background color, if white). Also, certain screen-specific elements (such as the selection) should not be rendered.
ITextServices::TxGetNaturalSize should render the lprcClient rectangle, starting at the current scrolling position.
- pvAspect [in]
Information for drawing optimizations.
- ptd [in]
Information on the target device.
- hdcDraw [in]
Rendering device context.
- hicTargetDev [in]
Target information context.
- lprcClient [in]
The control's client rectangle, in client (device) coordinates of the view in which the hit testing is done.
- x [in]
x-coordinate to check, in client coordinates, of the view in which hit testing is done.
- y [in]
y-coordinate to check, in client coordinates, of the view in which hit testing is done.
- pHitResult [out]
The result of the hit test. It can be any of the following TXTHITRESULT enumeration values.
The return value is an HRESULT code.
This method allows the host to implement transparent hit testing on text.
Minimum supported client
|Windows Vista [desktop apps only]|
Minimum supported server
|Windows Server 2003 [desktop apps only]|