IDWriteTextAnalysisSource::GetTextBeforePosition 方法 (dwrite.h)

取得緊接在指定位置前面的文字區塊。

語法

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

參數

textPosition

類型: UINT32

緊接在要取得之文字區塊最後一個位置之後的位置。

[out] textString

類型: const WCHAR**

當這個方法傳回時,會包含文字區塊指標的位址,做為指定範圍的字元數位。 文字範圍會從 textPosition 到區塊的前面。

[out] textLength

類型: UINT32*

擷取區塊的UTF16單位數目。 傳回的長度是從指定的位置到區塊的前端。

傳回值

類型: HRESULT

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

備註

NULL 表示指定位置沒有可用的區塊,可能是 因為 textPosition 等於 0、 textPosition 大於整個文字內容長度,或查詢的位置未對應到應用程式的支援存放區。

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

規格需求

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