TextRange_GetText函式 (uiautomationcoreapi.h)

注意此函式已被取代。用戶端應用程式應該改用 Microsoft 使用者介面自動化元件物件模型 (COM) 介面。

傳回文字範圍中的文字，最多指定字元數。

語法

HRESULT TextRange_GetText(
  [in]  HUIATEXTRANGE hobj,
  [in]  int           maxLength,
  [out] BSTR          *pRetVal
);

[in] hobj

類型： HUIATEXTRANGE

文字範圍物件。

[in] maxLength

類型： int

要傳回的字元數，從文字範圍的起始端點字元開始。

[out] pRetVal

類型： BSTR*

當此函式傳回時，此參數會包含傳回之文字的指標。這個參數會以未初始化的狀態傳遞。

類型： HRESULT

如果成功或錯誤值，則傳回S_OK。

如果 maxLength 是 -1，則會傳回文字範圍內的所有文字。如果 MaxLength 大於文字範圍的長度，則傳回的字串會包含文字範圍中的所有文字。