Metode ITfProperty::SetValue (msctf.h)
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 |
|---|---|
|
Metode berhasil. |
|
Satu atau beberapa parameter tidak valid. |
|
Terjadi kegagalan alokasi memori. |
|
Terjadi kesalahan yang tidak ditentukan. |
|
Konteks edit yang diidentifikasi oleh ec tidak memiliki kunci baca/tulis. |
|
Konteks edit bersifat baca-saja. |
|
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 |