IOleWindow::Metode GetWindow (oleidl.h)

Mengambil handel ke salah satu jendela yang berpartisipasi dalam aktivasi di tempat (bingkai, dokumen, induk, atau jendela objek di tempat).

Sintaks

HRESULT GetWindow(
  [out] HWND *phwnd
);

Parameter

[out] phwnd

Penunjuk ke variabel yang menerima handel jendela.

Nilai kembali

Metode ini mengembalikan S_OK pada keberhasilan. Kemungkinan nilai pengembalian lainnya termasuk yang berikut ini.

Menampilkan kode	Deskripsi
E_FAIL	Objek tidak berjendela.
E_INVALIDARG	Nilai fEnterMode yang ditentukan tidak valid.
E_OUTOFMEMORY	Tidak tersedia cukup memori untuk operasi ini.
E_UNEXPECTED	Terjadi kesalahan tidak terduga.

Keterangan

Lima jenis jendela terdiri dari hierarki jendela. Ketika objek aktif di tempat, objek memiliki akses ke beberapa atau semua jendela ini.

Jendela	Deskripsi
Bingkai	Jendela utama terluar tempat menu utama aplikasi kontainer berada.
Dokumen	Jendela yang menampilkan dokumen majemuk yang berisi objek yang disematkan kepada pengguna.
Panel	Subwindow jendela dokumen yang berisi tampilan objek. Hanya berlaku untuk aplikasi dengan jendela panel terpisah.
Parent	Jendela kontainer yang berisi tampilan objek tersebut. Aplikasi objek menginstal jendelanya sebagai anak dari jendela ini.
Lokal	Jendela yang berisi objek aktif di tempat. Aplikasi objek membuat jendela ini dan menginstalnya sebagai anak dari jendela menetasnya, yang merupakan anak dari jendela induk kontainer.

 

Setiap jenis jendela memiliki peran yang berbeda dalam arsitektur aktivasi di tempat. Namun, tidak perlu menggunakan jendela fisik terpisah untuk setiap jenis. Banyak aplikasi kontainer menggunakan jendela yang sama untuk bingkai, dokumen, panel, dan jendela induknya.

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

IOleWindow