IDWriteTextAnalysisSource：：GetTextAtPosition 方法 (dwrite.h)

  • 發行項

取得從指定文字位置開始的文字區塊。

語法

HRESULT GetTextAtPosition(
        UINT32      textPosition,
  [out] WCHAR const **textString,
  [out] UINT32      *textLength
);

參數

textPosition

類型： UINT32

要取得之片段的第一個位置。 所有位置都是 UTF16 字碼單位，而不是整個字元，這在使用增補字元時很重要。

[out] textString

類型： const WCHAR**

當這個方法傳回時，會包含文字區塊的位址，做為要從文字分析中擷取的字元陣列。

[out] textLength

類型： UINT32*

當這個方法傳回時，會包含所擷取區塊的 UTF16 單位數目。 傳回的長度不是區塊的長度，而是區塊中剩餘的長度，從指定的位置到其結尾為止。 例如，查詢 75 個位置到 100 個位置區塊的位置會傳回 25。

傳回值

類型： HRESULT

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

備註

傳回 Null 表示文字結尾，這是最後一個字元之後的位置。 此函式會反復呼叫每個連續區塊，將備份存放區中的數個片段區塊系結成虛擬連續字串。

雖然應用程式可以實作僅對應部份備份存儲區的疏鬆文字內容，但應用程式必須對應傳遞至任何分析函式範圍中的任何文字。

需求

   
最低支援的用戶端 適用于 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

另請參閱

IDWriteTextAnalysisSource