IShellView2::Metode GetView (shobjidl_core.h)

Artikel
03/02/2024

Meminta tampilan Shell saat ini atau default, bersama dengan semua pengidentifikasi tampilan (VID) valid lainnya yang didukung oleh implementasi IShellView2 ini.

Sintaks

HRESULT GetView(
  [out] SHELLVIEWID *pvid,
  [in]  ULONG       uView
);

Parameter

[out] pvid

Jenis: SHELLVIEWID*

Penunjuk ke GUID tampilan yang diminta. Tampilan berikut didefinisikan dalam Shlguid.h.

VID_LargeIcons

{0057d0e0-3573-11CF-Ae69-08002B2E1262}

VID_SmallIcons

{089000C0-3573-11CF-AE69-08002B2E1262}

VID_List

{0E1FA5E0-3573-11CF-AE69-08002B2E1262}

VID_Details

{137E7700-3573-11CF-AE69-08002B2E1262}

VID_Tile

{65F125E5-7BE1-4810-BA9D-D271C8432CE3}

[in] uView

Jenis: ULONG

Jenis tampilan yang diminta.

SV2GV_CURRENTVIEW

Tampilan Shell saat ini.

SV2GV_DEFAULTVIEW

Tampilan Shell default.

Nilai kembali

Jenis: HRESULT

Mengembalikan S_OK jika berhasil, atau kode kesalahan COM standar sebaliknya.

Keterangan

IShellView2::GetView mengambil "viewset", yang merupakan tampilan yang diminta (default atau saat ini) bersama dengan semua tampilan valid lainnya untuk instans IShellView2 ini. Memanggil IShellView2::GetView dengan SV2GV_CURRENTVIEW mengembalikan GUID yang mewakili tampilan saat ini dan juga melakukan iterasi melalui VID yang valid. Informasi ini disimpan untuk digunakan nanti dalam memvalidasi tampilan baru sebelum ditampilkan.

Tampilan juga dapat dipengaruhi oleh faktor lain. VID default pengguna global dan mode tampilan diatur saat pengguna menekan tombol Terapkan ke Semua Folder di jendela Opsi Folder . VID ditentukan dari IShellView2::GetView dengan bendera SV2GV_CURRENTVIEW dan mode tampilan ditentukan dari GetCurrentInfo. Tampilan juga dapat dipengaruhi oleh default folder yang dipertahankan. Windows Explorer menyimpan VID dan melihat mode folder jika pengguna sebelumnya telah mengunjunginya. Dalam beberapa kasus, folder tempat Anda menavigasi juga dapat memengaruhi mode tampilan yang dibuat untuk tampilan baru yang Anda masukkan.

Prioritas dari berbagai tampilan ini umumnya dapat dikatakan sebagai berikut:

Default folder yang dipertahankan
Default pengguna global
Tampilan default (SV2GV_DEFAULTVIEW)
Tampilan sebelumnya

Prioritas tampilan sebelumnya bisa lebih tinggi jika opsi Ingat pengaturan tampilan setiap folder tidak dipilih di Opsi Folder. Faktor lain seperti kebijakan juga dapat dimainkan, sehingga daftar di atas harus dilihat hanya sebagai pedoman yang sangat luas.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)
DLL	Shell32.dll (versi 4.71 atau yang lebih baru)

Bagikan melalui