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
S_FALSE	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

Lihat juga

IOleInPlaceActiveObject

IOleInPlaceSiteWindowless