Metode IOleInPlaceSite::GetWindowContext (oleidl.h)

Artikel
08/25/2023

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
E_INVALIDARG	Satu atau beberapa pointer yang disediakan tidak valid.
E_UNEXPECTED	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

Lihat juga

IOleInPlaceSite

Share via