IDWriteTextLayout：：HitTestPoint 方法 (dwrite.h)

應用程式會呼叫這個函式，此函式會傳入相對於版面配置方塊左上方位置的特定圖元位置，並取得發生點擊測試之文字字串對應點擊測試計量的相關信息。 當指定的圖元位置不在文字字串之外時，函式會將輸出值 *isInside 設定為 FALSE。

語法

HRESULT HitTestPoint(
        FLOAT                   pointX,
        FLOAT                   pointY,
  [out] BOOL                    *isTrailingHit,
  [out] BOOL                    *isInside,
  [out] DWRITE_HIT_TEST_METRICS *hitTestMetrics
);

參數

pointX

類型： FLOAT

要點擊測試的圖元位置 X，相對於版面配置方塊的左上方位置。

pointY

類型： FLOAT

要點擊測試的圖元位置 Y，相對於版面配置方塊的左上方位置。

[out] isTrailingHit

類型： BOOL*

輸出旗標，指出點擊測試位置位於字元的開頭或尾端。 當輸出 *isInside 值設定為 FALSE 時，此值會根據輸出 hitTestMetrics-textPosition> 值來設定，以代表最接近點擊測試位置的邊緣。

[out] isInside

類型： BOOL*

輸出旗標，指出點擊測試位置是否在文字字串內。 當 為 FALSE 時，會傳回最接近文字邊緣的位置。

[out] hitTestMetrics

類型： DWRITE_HIT_TEST_METRICS*

輸出幾何完全括住點擊測試位置。 當輸出 *isInside 值設定為 FALSE 時，這個結構代表以最接近點擊測試位置的邊緣括住的幾何。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

規格需求

需求	值
最低支援的用戶端	適用於 Windows Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	dwrite.h
程式庫	Dwrite.lib
Dll	Dwrite.dll

另請參閱

IDWriteTextLayout