ITfUIElementSink::BeginUIElement method (msctf.h)

Metode ITfUIElementSink::BeginUIElement dipanggil ketika UIElement dimulai. Sink ini dapat memungkinkan layanan teks menggambar atau tidak menggambar elemen UI.

Sintaks

HRESULT BeginUIElement(
  [in] DWORD dwUIElementId,
       BOOL  *pbShow
);

Parameter

[in] dwUIElementId

[in] Id UIElement yang dimulai.

pbShow

[in, out] Mengembalikan true jika aplikasi tidak menggambar konten UIElement dan layanan teks menggambar konten UI aslinya. Mengembalikan false jika aplikasi menggambar konten UIElement dan menghentikan layanan teks menggambarnya. Aplikasi bisa mendapatkan antarmuka ITfUIElement dengan menggunakan ITfUIElementMgr::GetUIElement dan dapat mengevaluasi apakah dapat menangani UIElement oleh QI dengan IID_ITfCandidateListUIElement atau dengan antarmuka UIElement lainnya. Aplikasi selalu dapat mengembalikan FALSE jika tidak diketahui atau tidak dapat ditangani. Dalam hal ini, layanan teks tidak akan menampilkan UI tambahan di layar. Ini adalah cara yang baik untuk beberapa aplikasi layar penuh. Atau, aplikasi dapat mengembalikan TRUE untuk menggunakan UI TextService pada beberapa UI tertentu atau tidak dikenal.

Nilai kembali

Manajer TSF mengabaikan nilai pengembalian metode ini.

Nilai	Deskripsi
S_OK	Metode berhasil.
E_FAIL	Terjadi kesalahan yang tidak ditentukan.

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