Metode ITfReadOnlyProperty::GetValue (msctf.h)

Mendapatkan nilai properti untuk rentang teks.

Sintaks

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

Parameter

[in] ec

Berisi cookie edit yang mengidentifikasi konteks edit. Ini diperoleh dari ITfDocumentMgr::CreateContext atau ITfEditSession::D oEditSession.

[in] pRange

Arahkan ke antarmuka ITfRange yang menentukan rentang untuk mendapatkan properti.

[out] pvarValue

Penunjuk ke nilai VARIAN yang menerima nilai properti. Jenis data dan konten nilai ini ditentukan oleh pemilik properti dan harus dikenali oleh pemanggil untuk menggunakan nilai ini. Pemanggil harus merilis data ini, ketika tidak lagi diperlukan, dengan meneruskan nilai ini ke API VariantClear .

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai	Deskripsi
S_OK	Metode berhasil.
S_FALSE	Rentang tidak dicakup oleh properti atau rentang berisi lebih dari satu nilai properti. pvarValue menerima nilai VT_EMPTY.
E_INVALIDARG	Satu atau beberapa parameter tidak valid.
E_FAIL	Terjadi kesalahan yang tidak ditentukan.
TF_E_NOLOCK	Konteks edit yang diidentifikasi oleh ec tidak memiliki kunci baca-saja atau baca/tulis.

Keterangan

Jika properti tidak memiliki nilai atas pRange, pRange berisi lebih dari satu nilai untuk properti atau properti tidak sepenuhnya mencakup pRange, pvarValue menerima nilai VT_EMPTY dan metode mengembalikan S_FALSE.

COLOR:      RR      GGGGGGGG
TEXT:  this is some colored text
    range-->||<-

COLOR:      RR      GGGGGGGG
TEXT:  this is some colored text
    range-->|    |<-

COLOR:      RR      GGGGGGGG
TEXT:  this is some colored text
    range-->|             |<-

Persyaratan

Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	msctf.h
DLL	Msctf.dll
Redistribusi	TSF 1.0 di Windows 2000 Professional

Lihat juga

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfRange

ITfReadOnlyProperty