Metode ITfContext::SetSelection (msctf.h)

Mengatur pilihan di dalam dokumen.

Sintaks

HRESULT SetSelection(
  [in] TfEditCookie       ec,
  [in] ULONG              ulCount,
  [in] const TF_SELECTION *pSelection
);

Parameter

[in] ec

Berisi cookie edit yang mengidentifikasi sesi edit. Ini adalah nilai yang diteruskan ke ITfEditSession::D oEditSession.

[in] ulCount

Menentukan jumlah pilihan dalam array pSelection .

[in] pSelection

Array struktur TF_SELECTION yang berisi informasi untuk setiap pilihan.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai	Deskripsi
S_OK	Metode berhasil.
TF_E_NOSELECTION	Dokumen tidak memiliki pilihan.
TF_E_NOLOCK	Cookie di ec tidak valid.

Keterangan

Pilihan adalah rentang teks yang disorot, atau titik penyisipan jika rentang kosong, mengidentifikasi area fokus pengguna dalam dokumen. Beberapa dokumen mampu memiliki beberapa pilihan. Hanya boleh ada satu pilihan panjang nol dalam pSelection karena mewakili posisi tanda sisipan dokumen.

Jika aplikasi harus menyesuaikan teks yang dicakup oleh pilihan, aplikasi harus menunggu hingga penelepon melepaskan kunci. Namun, aplikasi dapat menyesuaikan salah satu anggota gaya struktur TF_SELECTION sambil tetap mengembalikan S_OK.

Pemanggil dapat mengatur bendera fInterimChar hanya jika satu pilihan diatur. Dalam hal ini, pilihan harus mencakup tepat satu karakter dan anggota ase dari struktur TF_SELECTION diatur ke TFAE_NONE.

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

Lihat juga

Antarmuka ITfContext, ITfEditSession::D oEditSession, struktur TF_SELECTION, ITfContext::GetSelection