ITextServices：：TxQueryHitPoint 方法 (textserv.h)

發行項
08/26/2023

測試指定的點是否在文字服務物件的矩形內。

語法

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
);

參數

[in] dwDrawAspect

類型： DWORD

繪製層面可以是下列其中一個值。

值	意義
DVASPECT_CONTENT	將文字內容的螢幕影像轉譯為 hdcDraw 裝置內容。如果任何 (通常是印表機) ， hicTargetDev 和 ptd 參數會提供目標裝置內容的相關資訊。
DVASPECT_DOCPRINT	將物件轉譯為 hdcDraw 裝置內容，就像列印到印表機一樣。因此，如果白色) ，文字服務物件可以針對印表機優化 (，而不是繪製背景色彩。此外，不應該轉譯選取範圍) 之類的特定螢幕特定專案 (。 ITextServices：：TxGetNaturalSize 應該轉譯 lprcClient 矩形，從目前的捲動位置開始。

lindex

類型： LONG

不支援。

[in] pvAspect

類型： void*

繪圖優化的資訊。

[in] ptd

類型： DVTARGETDEVICE*

目標裝置的相關資訊。

[in] hdcDraw

類型： HDC

轉譯裝置內容。

[in] hicTargetDev

類型： HDC

目標資訊內容。

[in] lprcClient

類型： LPCRECT

控制項的用戶端矩形，在用戶端 (裝置) 完成點擊測試之檢視的座標。

[in] x

類型： INT

要檢查用戶端座標中執行點擊測試之檢視的 x 座標。

[in] y

類型： INT

要檢查用戶端座標中執行點擊測試之檢視的 Y 座標。

[out] pHitResult

類型： DWORD*

點擊測試的結果。它可以是下列任何 TXTHITRESULT 列舉值。

值	意義
TXTHITRESULT_CLOSE	點位於用戶端矩形中，且接近非透明區域。
TXTHITRESULT_HIT	點位於用戶端矩形中，而且文字上方或背景不是透明的。
TXTHITRESULT_NOHIT	點位於用戶端矩形外部。
TXTHITRESULT_TRANSPARENT	點位於用戶端矩形中，而不是文字或背景為透明。

傳回值

類型： HRESULT

傳回值是 HRESULT 程式碼。

備註

此方法可讓主機在文字上實作透明點擊測試。

如需詳細資訊，請參閱 ITextServices：：TxDraw 和 ITextServices：：OnTxSetCursor中的一節。

規格需求


最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	textserv.h
Dll	Msftedit.dll