ITfReadOnlyProperty：：GetValue 方法 (msctf.h)

取得文字範圍的屬性值。

語法

HRESULT GetValue(
  [in]  TfEditCookie ec,
  [in]  ITfRange     *pRange,
  [out] VARIANT      *pvarValue
);

[in] ec

包含可識別編輯內容的編輯 Cookie。這是從 ITfDocumentMgr：：CreateCoNtext 或 ITfEditSession：:D oEditSession取得。

[in] pRange

ITfRange介面的指標，指定要取得屬性的範圍。

[out] pvarValue

接收屬性值的 VARIANT 值指標。這個值的資料類型和內容是由屬性擁有者所定義，而且必須由呼叫端辨識，才能使用此值。呼叫端必須將此值傳遞至 VariantClear API，以釋放不再需要此資料。

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

值	描述
S_OK	此方法成功。
S_FALSE	屬性未涵蓋範圍，或範圍包含多個屬性值。 pvarValue 會收到VT_EMPTY值。
E_INVALIDARG	一或多個參數無效。
E_FAIL	發生未指定的錯誤。
TF_E_NOLOCK	ec所識別的編輯內容沒有唯讀或讀取/寫入鎖定。

如果屬性在 pRange上沒有值， pRange 會包含一個以上的屬性值，或屬性未完全涵蓋 pRange， pvarValue 會收到VT_EMPTY值，而且方法會傳回S_FALSE。


COLOR:      RR      GGGGGGGG
TEXT:  this is some colored text
    range--&gt;||&lt;-


COLOR:      RR      GGGGGGGG
TEXT:  this is some colored text
    range--&gt;|    |&lt;-


COLOR:      RR      GGGGGGGG
TEXT:  this is some colored text
    range--&gt;|             |&lt;-


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