IShellView3::CreateViewWindow3-Methode (shobjidl.h)

Artikel
08/26/2023

Fordert die Erstellung eines neuen Shell-Ansichtsfensters an. Die Ansicht kann entweder der rechte Bereich von Windows Explorer oder das Clientfenster eines Ordnerfensters sein. Diese Methode ersetzt CreateViewWindow2.

Syntax

HRESULT CreateViewWindow3(
  [in]  IShellBrowser     *psbOwner,
  [in]  IShellView        *psvPrev,
  [in]  SV3CVW3_FLAGS     dwViewFlags,
  [in]  FOLDERFLAGS       dwMask,
  [in]  FOLDERFLAGS       dwFlags,
  [in]  FOLDERVIEWMODE    fvMode,
  [in]  const SHELLVIEWID *pvid,
  [in]  const RECT        *prcView,
  [out] HWND              *phwndView
);

Parameter

[in] psbOwner

Typ: IShellBrowser*

Ein Zeiger auf eine IShellBrowser-Schnittstelle zum Bereitstellen von Namespaceerweiterungsdiensten.

[in] psvPrev

Typ: IShellView*

Ein Zeiger auf eine IShellView-Schnittstelle, die die vorherige Ansicht im Windows-Explorer- oder Ordnerfenster darstellt.

[in] dwViewFlags

Typ: SV3CVW3_FLAGS

Flags, die Details der zu erstellenden Ansicht angeben.

SV3CVW3_DEFAULT

Die Standardansicht.

SV3CVW3_NONINTERACTIVE

Im Falle eines Fehlers sollte die Ansicht im Hintergrund fehlschlagen, anstatt eine Benutzeroberfläche anzuzeigen.

SV3CVW3_FORCEVIEWMODE

Der von IShellView3::CreateViewWindow3 festgelegte Ansichtsmodus setzt den gespeicherten Ansichtszustand außer Kraft.

SV3CVW3_FORCEFOLDERFLAGS

Ordnerflags, die von IShellView3::CreateViewWindow3 festgelegt wurden, überschreiben den Zustand der gespeicherten Ansicht.

[in] dwMask

Typ: FOLDERFLAGS

Eine bitweise Maske, die angibt, welche in dwFlags angegebenen Ordneroptionen verwendet werden sollen.

[in] dwFlags

Typ: FOLDERFLAGS

Ein bitweiser Wert, der die Ordneroptionen als FOLDERFLAGS enthält, die in der neuen Ansicht verwendet werden sollen.

[in] fvMode

Typ: FOLDERVIEWMODE

Ein bitweiser Wert, der die Optionen für den Ordneransichtsmodus enthält, wie FOLDERVIEWMODE, die in der neuen Ansicht verwendet werden sollen.

[in] pvid

Typ: const SHELLVIEWID*

Ein Zeiger auf die Shell-Ansichts-ID als GUID.

[in] prcView

Typ: const RECT*

Ein Zeiger auf eine RECT-Struktur , die die Dimensionen des Ansichtsfensters bereitstellt.

[out] phwndView

Typ: HWND*

Ein Wert, der einen Zeiger auf das Handle des neuen Shell-Ansichtsfensters empfängt.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl.h

Freigeben über