IShellView::CreateViewWindow-Methode (shobjidl_core.h)

Artikel
03/04/2024

Erstellt ein Ansichtsfenster. Dies kann entweder der rechte Bereich von Windows Explorer oder das Clientfenster eines Ordnerfensters sein.

Syntax

HRESULT CreateViewWindow(
  [in]  IShellView        *psvPrevious,
  [in]  LPCFOLDERSETTINGS pfs,
  [in]  IShellBrowser     *psb,
  [in]  RECT              *prcView,
  [out] HWND              *phWnd
);

Parameter

[in] psvPrevious

Typ: IShellView*

Die Adresse der IShellView-Schnittstelle des Ansichtsfensters, das beendet wird. Ansichten können diesen Parameter verwenden, um mit einer vorherigen Ansicht derselben Implementierung zu kommunizieren. Diese Schnittstelle kann verwendet werden, um das Durchsuchen zwischen ähnlichen Ansichten zu optimieren. Dieser Zeiger kann NULL sein.

[in] pfs

Typ: LPCFOLDERSETTINGS

Die Adresse einer FOLDERSETTINGS-Struktur . Die Ansicht sollte dies beim Erstellen ihrer Ansicht verwenden.

[in] psb

Typ: IShellBrowser*

Die Adresse des aktuellen instance der IShellBrowser-Schnittstelle. Die Ansicht sollte die AddRef-Methode dieser Schnittstelle aufrufen und den Schnittstellenzeiger beibehalten, um die Kommunikation mit dem Windows-Explorer-Fenster zu ermöglichen.

[in] prcView

Typ: RECT*

Die Dimensionen der neuen Ansicht in Clientkoordinaten.

[out] phWnd

Typ: HWND*

Die Adresse des Fensterhandles, das erstellt wird.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung einen Erfolgscode oder andernfalls einen COM-Fehlercode zurück. Verwenden Sie die Makros SUCCEEDED und FAILED , um zu bestimmen, ob der Vorgang erfolgreich war oder fehlgeschlagen ist.

Hinweise

Hinweise zum Aufrufen von Anwendungen

Rufen Sie diese Methode auf, wenn die Ansicht erstellt werden muss.

Hinweise für Implementierer

Erstellen Sie Ihr Ansichtsfenster, und stellen Sie einen dauerhaften Zustand wieder her, indem Sie die GetViewStateStream-Methode aufrufen. Speichern Sie den IShellBrowser-Zeiger zur weiteren Verwendung.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	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.0 oder höher)

Weitere Informationen

IShellView

Freigeben über