IFileDialog2 ::SetNavigationRoot, méthode (shobjidl.h)

Spécifie un emplacement de niveau supérieur à partir duquel commencer à parcourir un espace de noms, pour instance dans l’option Parcourir le dossier de la boîte de dialogue Enregistrer. Les utilisateurs ne peuvent pas naviguer au-dessus de cet emplacement.

Syntaxe

HRESULT SetNavigationRoot(
  [in] IShellItem *psi
);

Paramètres

[in] psi

Type : IShellItem

Pointeur vers un objet IShellItem qui représente la racine de navigation.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

SetNavigationRoot peut être utilisé par les applications qui souhaitent restreindre la navigation vers une certaine zone de l’espace de noms Shell. Les éléments du volet de navigation sont remplacés par l’élément fourni pour aider l’utilisateur à naviguer en dehors de cette partie de l’espace de noms.

Cette méthode ne peut pas être appelée pendant l’affichage de la boîte de dialogue.

Configuration requise

Voir aussi

IFileDialog2