共用方式為


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