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

Article
03/02/2024

Demande la vue Shell actuelle ou par défaut, ainsi que tous les autres identificateurs d’affichage valides (VID) pris en charge par cette implémentation d’IShellView2.

Syntaxe

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

Paramètres

[out] pvid

Type : SHELLVIEWID*

Pointeur vers le GUID de la vue demandée. Les vues suivantes sont définies dans Shlguid.h.

VID_LargeIcons

{0057D0E0-3573-11CF-AE69-08002B2E1262}

VID_SmallIcons

{089000C0-3573-11CF-AE69-08002B2E1262}

VID_List

{0E1FA5E0-3573-11CF-AE69-08002B2E1262}

VID_Details

{137E700-3573-11CF-AE69-08002B2E1262}

VID_Tile

{65F125E5-7BE1-4810-BA9D-D271C8432CE3}

[in] uView

Type : ULONG

Type de vue demandé.

SV2GV_CURRENTVIEW

Vue actuelle de l’interpréteur de commandes.

SV2GV_DEFAULTVIEW

Vue Shell par défaut.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite, ou un code d’erreur COM standard dans le cas contraire.

Remarques

IShellView2 ::GetView récupère un « ensemble de vues », qui est la vue demandée (par défaut ou actuelle) ainsi que toutes les autres vues valides pour cette instance d’IShellView2. L’appel de IShellView2 ::GetView avec le SV2GV_CURRENTVIEW retourne un GUID représentant l’affichage actuel et effectue également une itération via les VID valides. Ces informations sont stockées pour une utilisation ultérieure dans la validation d’une nouvelle vue avant d’être affichées.

La vue peut également être affectée par d’autres facteurs. Un mode de VID et d’affichage par défaut de l’utilisateur global est défini lorsque l’utilisateur appuie sur le bouton Appliquer à tous les dossiers dans la fenêtre Options des dossiers . Le VID est déterminé à partir de IShellView2 ::GetView avec l’indicateur SV2GV_CURRENTVIEW et le mode d’affichage est déterminé à partir de GetCurrentInfo. La vue peut également être affectée par la valeur par défaut du dossier persistant. Windows Explorer enregistre le mode VID et d’affichage d’un dossier si l’utilisateur l’a déjà visité. Dans certains cas, le dossier à partir duquel vous naviguez peut également influencer le mode d’affichage créé pour la nouvelle vue que vous entrez.

La priorité de ces vues assorties peut être généralement définie comme suit :

Dossier persistant par défaut
Utilisateur global par défaut
Affichage par défaut (SV2GV_DEFAULTVIEW)
Vue précédente

La priorité de l’affichage précédent peut être plus élevée si l’option Mémoriser les paramètres d’affichage de chaque dossier n’est pas sélectionnée dans Options de dossier. D’autres facteurs tels que les stratégies peuvent également entrer en jeu, de sorte que la liste ci-dessus ne doit être vue que comme une ligne directrice très large.

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 (inclure Shobjidl.h)
DLL	Shell32.dll (version 4.71 ou ultérieure)