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 |