Metode ITfProperty::SetValue (msctf.h)

Artikel
03/05/2024

Mengatur nilai properti untuk rentang.

Sintaks

HRESULT SetValue(
  [in] TfEditCookie  ec,
  [in] ITfRange      *pRange,
  [in] const VARIANT *pvarValue
);

Parameter

[in] ec

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

[in] pRange

Penunjuk ke antarmuka ITfRange yang berisi rentang tempat nilai properti diatur. Parameter ini tidak boleh NULL. Metode ini akan gagal jika pRange kosong.

[in] pvarValue

Penunjuk ke struktur VARIAN yang berisi nilai properti baru. Hanya nilai jenis VT_I4, VT_UNKNOWN, VT_BSTR, dan VT_EMPTY yang didukung.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai	Deskripsi
S_OK	Metode berhasil.
E_INVALIDARG	Satu atau beberapa parameter tidak valid.
E_OUTOFMEMORY	Terjadi kegagalan alokasi memori.
E_FAIL	Terjadi kesalahan yang tidak ditentukan.
TF_E_NOLOCK	Konteks edit yang diidentifikasi oleh ec tidak memiliki kunci baca/tulis.
TF_E_READONLY	Konteks edit bersifat baca-saja.
TF_E_NOTOWNEDRANGE	Manajer TSF tidak memiliki rentang.

Keterangan

Nilai properti yang diatur dengan metode ini akan dibuang ketika teks yang dicakup nilai properti dimodifikasi. Untuk mendapatkan kontrol kustom atas respons nilai terhadap pengeditan teks, gunakan ITfProperty::SetValueStore.

Nilai yang diatur dengan metode ini diserialisasikan, kecuali untuk nilai jenis VT_UNKNOWN, yang tidak diserialisasikan. Jika nilai properti jenis VT_UNKNOWN harus diserialisasikan, gunakan ITfProperty::SetValueStore sebagai gantinya.

Nilai properti yang tumpang tindih dengan jenis yang sama tidak didukung.

Persyaratan

Persyaratan	Nilai
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