Méthode IShellView2 ::CreateViewWindow2 (shobjidl_core.h)

  • Article

Permet de demander la création d’une fenêtre d’affichage Shell. Il peut s’agir du volet droit de Windows Explorer ou de la fenêtre cliente d’une fenêtre de dossier.

Syntaxe

HRESULT CreateViewWindow2(
  LPSV2CVW2_PARAMS lpParams
);

Paramètres

lpParams

Type : LPSV2CVW2_PARAMS

Pointeur vers une structure SV2CVW2_PARAMS qui définit la nouvelle fenêtre d’affichage.

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

Cette méthode remplace CreateViewWindow. Avec CreateViewWindow2, les développeurs ne sont pas limités aux modes d’affichage standard fournis par CreateViewWindow, mais peuvent également créer leurs propres modes. Tous les modes d’affichage sont désormais identifiés par leur GUID.

La taille de la structure, la fenêtre d’affichage précédente, les paramètres de dossier, le navigateur Shell parent et le rectangle d’affichage sont passés à IShellView2 ::CreateViewWindow2 dans les cinq premiers membres de lpParams. La méthode est chargée de créer la nouvelle fenêtre et de renvoyer son handle de fenêtre et le GUID du mode d’affichage dans les deux derniers paramètres. IShellView2 ::CreateViewWindow2 doit appeler la méthode IShellBrowser ::AddRef du navigateur parent et stocker le pointeur d’interface. Il peut être utilisé pour la communication avec la fenêtre Windows Explorer.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel, 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.71 ou ultérieure)

Voir aussi

IShellView2

IShellView2 ::GetView