IShellView ::CreateViewWindow, méthode (shobjidl_core.h)

Article
03/02/2024

Crée une fenêtre d’affichage. Il peut s’agir du volet droit de Windows Explorer ou de la fenêtre cliente d’une fenêtre de dossier.

Syntaxe

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

Paramètres

[in] psvPrevious

Type : IShellView*

Adresse de l’interface IShellView de la fenêtre d’affichage en cours de fermeture. Les vues peuvent utiliser ce paramètre pour communiquer avec une vue précédente de la même implémentation. Cette interface peut être utilisée pour optimiser la navigation entre des vues similaires. Ce pointeur peut être NULL.

[in] pfs

Type : LPCFOLDERSETTINGS

Adresse d’une structure FOLDERSETTINGS . La vue doit l’utiliser lors de la création de son affichage.

[in] psb

Type : IShellBrowser*

Adresse du instance actuel de l’interface IShellBrowser. La vue doit appeler la méthode AddRef de cette interface et conserver le pointeur d’interface pour permettre la communication avec la fenêtre Windows Explorer.

[in] prcView

Type : RECT*

Dimensions de la nouvelle vue, en coordonnées client.

[out] phWnd

Type : HWND*

Adresse du handle de fenêtre en cours de création.

Valeur retournée

Type : HRESULT

Retourne un code de réussite en cas de réussite, ou un code d’erreur COM dans le cas contraire. Utilisez les macros SUCCEEDED et FAILED pour déterminer si l’opération a réussi ou échoué.

Remarques

Remarques relatives à l’appel d’applications

Appelez cette méthode lorsque la vue doit être créée.

Remarques aux implémenteurs

Créez votre fenêtre d’affichage et restaurez tout état persistant en appelant la méthode GetViewStateStream . Stockez le pointeur IShellBrowser pour une utilisation ultérieure.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (incluez Shobjidl.h)
DLL	Shell32.dll (version 4.0 ou ultérieure)

Voir aussi

IShellView

Partager via