Metode ITfProperty::SetValueStore (msctf.h)

Artikel
08/24/2023

Mengatur nilai properti untuk rentang teks menggunakan objek penyimpanan properti.

Sintaks

HRESULT SetValueStore(
  [in] TfEditCookie     ec,
  [in] ITfRange         *pRange,
  [in] ITfPropertyStore *pPropStore
);

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 gagal jika pRange kosong.

[in] pPropStore

Pointer ke antarmuka ITfPropertyStore yang mendapatkan data properti.

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_FAIL	Terjadi kesalahan yang tidak ditentukan.
TF_E_NOLOCK	Konteks edit yang diidentifikasi oleh ec tidak memiliki kunci baca/tulis.

Keterangan

Nilai properti yang diatur dengan ITfProperty::SetValue akan dibuang saat teks yang dicakup nilai properti diubah. Untuk mendapatkan kontrol atas apa yang terjadi pada nilai properti saat teks dimodifikasi, gunakan ITfProperty::SetValueStore .

Nilai yang diatur dengan ITfProperty::SetValue akan 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


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