Metode IOleInPlaceSiteWindowless::SetFocus (ocidl.h)
Mengatur fokus keyboard untuk objek UI aktif tanpa jendela.
Sintaks
HRESULT SetFocus(
[in] BOOL fFocus
);
Parameter
[in] fFocus
Jika TRUE, mengatur fokus keyboard ke objek panggilan. Jika FALSE, menghapus fokus keyboard dari objek panggilan, asalkan objek memiliki fokus.
Mengembalikan nilai
Metode ini mengembalikan S_OK jika fokus keyboard berhasil diberikan ke objek. Jika metode ini dipanggil untuk merilis fokus, itu seharusnya tidak pernah gagal. Nilai pengembalian lain yang mungkin termasuk yang berikut ini.
| Menampilkan kode | Deskripsi |
|---|---|
|
Fokus keyboard ditolak ke objek. |
Keterangan
Objek tanpa jendela memanggil metode ini setiap kali objek berjendela akan memanggil fungsi SetFocus . Melalui panggilan ini, objek tanpa jendela mendapatkan fokus keyboard dan dapat merespons pesan jendela. Biasanya, panggilan ini dilakukan selama proses aktivasi UI dan dalam metode pemberitahuan IOleInPlaceActiveObject::OnDocWindowActivate dengan TRUE dan IOleInPlaceActiveObject::OnFrameWindowActivate dengan TRUE.
Menanggapi panggilan ini, kontainer mengatur fokus Windows ke jendela yang digunakan untuk mendapatkan pesan keyboard (biasanya jendela kontainer) dan mengalihkan pesan keyboard berikutnya ke objek tanpa jendela yang meminta fokus.
Objek tanpa jendela juga memanggil metode IOleInPlaceSiteWindowless::SetFocus dengan parameter fFocus diatur ke FALSE untuk melepaskan fokus keyboard tanpa menetapkannya ke objek lain. Dalam hal ini, kontainer harus memanggil fungsi SetFocus dengan parameter NULL sehingga tidak ada jendela yang memiliki fokus.
Persyaratan
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | ocidl.h |