ITfRange：：GetText 方法 (msctf.h)

  • 發行項

ITfRange：：GetText方法會取得此文字範圍涵蓋的內容。

語法

HRESULT GetText(
  [in]  TfEditCookie ec,
  [in]  DWORD        dwFlags,
  [out] WCHAR        *pchText,
  [in]  ULONG        cchMax,
  [out] ULONG        *pcch
);

參數

[in] ec

編輯 Cookie，識別從 ITfDocumentMgr：：CreateCoNtext 或 ITfEditSession：:D oEditSession取得的編輯內容。

[in] dwFlags

指定選擇性行為的位欄位。

值 意義
TF_TF_MOVESTART
 範圍的開始錨點會進階到最後一個字元傳回之後的位置。
TF_TF_IGNOREEND
 方法會嘗試以最大字元數填滿 pchText ，而不是停止範圍結尾錨點所佔用位置的複本。

[out] pchText

緩衝區的指標，以接收範圍中的文字。

[in] cchMax

文字緩衝區的大小上限。

[out] pcch

ULONG 的指標，代表寫入 pchText 文字緩衝區的字元數。

傳回值

這個方法可以傳回其中一個值。

值 描述
S_OK
 此方法成功。
E_FAIL
 發生未指定的錯誤。
E_INVALIDARG
 一或多個參數無效。
TF_E_NOLOCK
 ec參數的值是不正確 Cookie，或者呼叫端沒有唯讀鎖定。

需求

   
最低支援的用戶端 Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 msctf.h
Dll Msctf.dll
可轉散發套件 Windows 2000 專業版上的 TSF 1.0

另請參閱

ITfDocumentMgr：：CreateCoNtext

ITfEditSession：:D oEditSession

ITfRange

TF_TF_* 常數

文字存放區