Antarmuka IShellWindows (exdisp.h)

Artikel
08/23/2023

Menyediakan akses ke koleksi jendela Shell yang terbuka.

Warisan

Antarmuka IShellWindows mewarisi dari antarmuka IDispatch . IShellWindows juga memiliki jenis anggota ini:

Metode

Antarmuka IShellWindows memiliki metode ini.


IShellWindows::_NewEnum Mengambil enumerator untuk koleksi jendela Shell.
IShellWindows::FindWindowSW Menemukan jendela di koleksi jendela Shell dan mengembalikan handel jendela dan antarmuka IDispatch.
IShellWindows::get_Count Mendapatkan jumlah jendela dalam koleksi jendela Shell.
IShellWindows::Item Mengembalikan jendela Shell terdaftar untuk indeks tertentu.
IShellWindows::OnActivated Terjadi ketika status aktivasi jendela Shell berubah.
IShellWindows::OnCreated Terjadi ketika jendela Shell baru dibuat untuk bingkai.
IShellWindows::OnNavigate Terjadi ketika jendela Shell dinavigasi ke lokasi baru.
IShellWindows::P rocessAttachDetach Dihentikan. Selalu mengembalikan S_OK.
IShellWindows::Register Mendaftarkan jendela terbuka sebagai jendela Shell; jendela ditentukan oleh handel.
IShellWindows::RegisterPending Mendaftarkan jendela tertunda sebagai jendela Shell; jendela ditentukan oleh PIDL absolut.
IShellWindows::Cabut Mencabut pendaftaran jendela Shell dan menghapus jendela dari koleksi jendela Shell.

Keterangan

Jendela Shell adalah jendela yang telah didaftarkan dengan memanggil IShellWindows::Register atau IShellWindows::RegisterPending. Setelah pendaftaran, jendela yang ditentukan ditambahkan ke koleksi jendela Shell, dan diberikan cookie yang secara unik mengidentifikasi jendela dalam koleksi. Jendela dapat tidak terdaftar dengan memanggil IShellWindows::Revoke.

Koleksi jendela Shell mencakup jendela penjelajah file dan browser web windows Internet Explorer dan browser web pihak ketiga). Biasanya setiap jendela Shell mengimplementasikan IDispatch; IShellWindows::Item dan IShellWindows::FindWindowSW menyediakan cara untuk mengakses antarmuka IDispatch jendela Shell. Untuk informasi selengkapnya, lihat Antarmuka Pengiriman dan Fungsi Otomatisasi.

IID	IID_IShellWindows (85CB6900-4D95-11CF-960C-0080C7F4EE85)
CLSID	CLSID_ShellWindows (9BA05972-F6A8-11CF-A442-00A0C90A8F39)

Contoh berikut menunjukkan cara mengambil instans IShellWindows .

#include "exdisp.h"
                
...

IShellWindows *psw;
HRESULT hr;

hr = CoInitialize(NULL);
if (SUCCEEDED(hr))
{
    hr = CoCreateInstance(
        CLSID_ShellWindows,
        NULL,
        CLSCTX_ALL,
        IID_IShellWindows,
        (void**)&psw
    );
    
    if (SUCCEEDED(hr))
    {
        // Use the IShellWindows instance...
        
        psw->Release();
    }
}