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
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 7 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 R2 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | shobjidl.h |
| Bibliothèque | Comdlg32.lib |
| DLL | Comdlg32.dll (version 6.1 ou ultérieure) |