IDWriteTextLayout：：HitTestTextPosition 方法 (dwrite.h)

  • 發行項

應用程式會呼叫此函式，以取得相對於配置方塊左上方的圖元位置，指定文字位置和位置的邏輯側邊。 此函式通常用來作為文字插入號位置的一部分，其中插入號繪製於對應至目前文字編輯位置的位置。 它也可以用來以程序設計方式取得UI自動化中特定文字位置的幾何。

語法

HRESULT HitTestTextPosition(
        UINT32                  textPosition,
        BOOL                    isTrailingHit,
  [out] FLOAT                   *pointX,
  [out] FLOAT                   *pointY,
  [out] DWRITE_HIT_TEST_METRICS *hitTestMetrics
);

參數

textPosition

類型： UINT32

用來取得圖元位置的文字位置。

isTrailingHit

類型： BOOL

布爾值旗標，指出圖元位置是指定文字位置的前置或尾端。

[out] pointX

類型： FLOAT*

當這個方法傳回時，會包含相對於配置方塊左上方位置的輸出圖元位置 X。

[out] pointY

類型： FLOAT*

當這個方法傳回時，會包含相對於配置方塊左上方位置的輸出圖元位置 Y。

[out] hitTestMetrics

類型： DWRITE_HIT_TEST_METRICS*

當這個方法傳回時，會包含完全括住指定文字位置的輸出幾何。

傳回值

類型： 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