IShellView2::GetView-Methode (shobjidl_core.h)

Artikel
03/02/2024

Fordert die aktuelle oder standardmäßige Shellansicht zusammen mit allen anderen gültigen Ansichtsbezeichnern (VIDs) an, die von dieser Implementierung von IShellView2 unterstützt werden.

Syntax

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

Parameter

[out] pvid

Typ: SHELLVIEWID*

Ein Zeiger auf die GUID der angeforderten Ansicht. Die folgenden Ansichten sind in Shlguid.h definiert.

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

Typ: ULONG

Der Typ der angeforderten Ansicht.

SV2GV_CURRENTVIEW

Aktuelle Shell-Ansicht.

SV2GV_DEFAULTVIEW

Standard-Shellansicht.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen COM-Standardfehlercode zurück.

Hinweise

IShellView2::GetView ruft ein "Viewset" ab, das die angeforderte Ansicht (standard oder aktuell) zusammen mit allen anderen gültigen Ansichten für diese instance von IShellView2 ist. Der Aufruf von IShellView2::GetView mit dem SV2GV_CURRENTVIEW gibt eine GUID zurück, die die aktuelle Ansicht darstellt, und durchläuft auch die gültigen VIDs. Diese Informationen werden zur späteren Verwendung beim Überprüfen einer neuen Ansicht gespeichert, bevor sie angezeigt wird.

Die Ansicht kann auch durch andere Faktoren beeinflusst werden. Ein globaler Benutzer-Standard-VID- und Ansichtsmodus wird festgelegt, wenn der Benutzer im Fenster Ordneroptionen auf die Schaltfläche Auf alle Ordner anwenden drückt. Die VID wird von IShellView2::GetView mit dem SV2GV_CURRENTVIEW-Flag bestimmt, und der Ansichtsmodus wird von GetCurrentInfo bestimmt. Die Ansicht kann auch von der Standardeinstellung des persistenten Ordners beeinflusst werden. Windows Explorer speichert den VID- und Ansichtsmodus eines Ordners, wenn der Benutzer ihn zuvor besucht hat. In einigen Fällen kann der Ordner, aus dem Sie navigieren, auch den Ansichtsmodus beeinflussen, der für die neue Ansicht erstellt wurde, die Sie eingeben.

Die Priorität dieser verschiedenen Sichten kann im Allgemeinen wie folgt lauten:

Standardeinstellung für persistente Ordner
Globaler Benutzerstandard
Standardansicht (SV2GV_DEFAULTVIEW)
Vorherige Ansicht

Die Priorität der vorherigen Ansicht kann höher sein, wenn die Option Einstellungen für die Ansicht jedes Ordners speichern unter Ordneroptionen nicht ausgewählt ist. Andere Faktoren wie Richtlinien können ebenfalls ins Spiel kommen, sodass die obige Liste nur als eine sehr umfassende Richtlinie betrachtet werden sollte.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)
DLL	Shell32.dll (Version 4.71 oder höher)

Freigeben über