Metode IOleInPlaceSite::GetWindowContext (oleidl.h)
Memungkinkan objek di tempat untuk mengambil antarmuka jendela yang membentuk hierarki objek jendela, dan posisi di jendela induk tempat jendela aktivasi objek di tempat harus berada.
Sintaks
HRESULT GetWindowContext(
[out] IOleInPlaceFrame **ppFrame,
[out] IOleInPlaceUIWindow **ppDoc,
[out] LPRECT lprcPosRect,
[out] LPRECT lprcClipRect,
[in, out] LPOLEINPLACEFRAMEINFO lpFrameInfo
);
Parameter
[out] ppFrame
Penunjuk ke variabel pointer IOleInPlaceFrame yang menerima penunjuk antarmuka ke bingkai. Jika terjadi kesalahan, implementasi harus mengatur ppFrame ke NULL.
[out] ppDoc
Penunjuk ke variabel pointer IOleInPlaceUIWindow yang menerima penunjuk antarmuka ke jendela dokumen. Jika jendela dokumen sama dengan jendela bingkai, ppDoc diatur ke NULL. Dalam hal ini, objek hanya dapat menggunakan ppFrame atau negosiasi perbatasan. Jika kesalahan dikembalikan, implementasi harus mengatur ppDoc ke NULL.
[out] lprcPosRect
Penunjuk ke struktur RECT untuk persegi panjang yang berisi posisi objek di tempat dalam koordinat klien dari jendela induknya. Jika kesalahan dikembalikan, parameter ini harus diatur ke NULL.
[out] lprcClipRect
Penunjuk ke struktur RECT untuk persegi panjang luar yang berisi persegi panjang posisi objek di tempat (lprcPosRect). Persegi panjang ini relatif terhadap area klien jendela induk objek. Jika kesalahan dikembalikan, parameter ini harus diatur ke NULL.
[in, out] lpFrameInfo
Penunjuk ke struktur OLEINPLACEFRAMEINFO kontainer adalah mengisi dengan data yang sesuai. Jika kesalahan dikembalikan, parameter ini harus diatur ke NULL.
Menampilkan nilai
Metode ini mengembalikan S_OK pada keberhasilan. Nilai pengembalian lain yang mungkin termasuk yang berikut ini.
Menampilkan kode | Deskripsi |
---|---|
|
Satu atau beberapa pointer yang disediakan tidak valid. |
|
Terjadi kesalahan tidak terduga. |
Keterangan
Struktur OLEINPLACEFRAMEINFO menyediakan data yang diperlukan oleh OLE untuk mengirimkan keystroke accelerator ke bingkai kontainer saat objek aktif di tempat.
Ketika objek diaktifkan, objek memanggil GetWindowContext dari kontainernya. Kontainer mengembalikan handel ke tabel akselerator di tempatnya melalui struktur OLEINPLACEFRAMEINFO . Sebelum memanggil GetWindowContext, objek harus menyediakan ukuran struktur OLEINPLACEFRAMEINFO dengan mengisi anggota cb, yang diarahkan oleh lpFrameInfo.
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 | oleidl.h |