Méthode IShellBrowser::BrowseObject (shobjidl_core.h)
Informe Windows Explorer d’accéder à un autre dossier.
Syntaxe
HRESULT BrowseObject(
PCUIDLIST_RELATIVE pidl,
UINT wFlags
);
Paramètres
pidl
Type : PCUIDLIST_RELATIVE
Adresse d’une structure ITEMIDLIST (item identifier list) qui spécifie l’emplacement d’un objet. Cette valeur dépend du ou des indicateurs définis dans le paramètre wFlags .
wFlags
Type : UINT
Indicateurs spécifiant le dossier à parcourir. Il peut s’agir de zéro ou d’une ou plusieurs des valeurs suivantes.
Ces indicateurs spécifient si une autre fenêtre doit être créée.
SBSP_DEFBROWSER (0x0000)
Utilisez le comportement par défaut, qui respecte l’option d’affichage (le paramètre utilisateur pour créer de nouvelles fenêtres ou pour parcourir sur place). Dans la plupart des cas, les applications appelantes doivent utiliser cet indicateur.
SBSP_SAMEBROWSER
Accédez à un autre dossier avec la même fenêtre windows Explorer.
SBSP_NEWBROWSER
Crée une autre fenêtre pour le dossier spécifié.
Les indicateurs suivants spécifient le mode. Ces valeurs sont ignorées si SBSP_SAMEBROWSER est spécifié ou si SBSP_DEFBROWSER est spécifié et que l’utilisateur a sélectionné Parcourir sur place.
SBSP_DEFMODE
Utilisez la fenêtre active.
SBSP_OPENMODE
Spécifie aucune arborescence de dossiers pour la nouvelle fenêtre de navigation. Si le navigateur actuel ne correspond pas à la SBSP_OPENMODE de l’appel d’objet de navigation, une nouvelle fenêtre s’ouvre.
SBSP_EXPLOREMODE
Spécifie une arborescence de dossiers pour la nouvelle fenêtre de navigation. Si le navigateur actuel ne correspond pas à la SBSP_EXPLOREMODE de l’appel d’objet de navigation, une nouvelle fenêtre s’ouvre.
SBSP_HELPMODE
Non pris en charge. Ne pas utiliser.
SBSP_NOTRANSFERHIST
Ne transférez pas l’historique de navigation vers la nouvelle fenêtre.
Les indicateurs suivants spécifient la catégorie du paramètre pidl .
SBSP_ABSOLUTE
PiDL absolu, relatif au bureau.
SBSP_RELATIVE
PiDL relatif, relatif au dossier actif.
SBSP_PARENT
Parcourez le dossier parent, ignorez le PIDL.
SBSP_NAVIGATEBACK
Revenez en arrière et ignorez le CODE PIDL.
SBSP_NAVIGATEFORWARD
Naviguez vers l’avant, ignorez le PIDL.
SBSP_ALLOW_AUTONAVIGATE (0x00010000)
Activez la navigation automatique.
Les indicateurs suivants spécifient le mode.
SBSP_KEEPSAMETEMPLATE (0x00020000)
Windows Vista et versions ultérieures. Non pris en charge. Ne pas utiliser.
SBSP_KEEPWORDWHEELTEXT (0x00040000)
Windows Vista et versions ultérieures. Naviguez sans effacer le champ d’entrée de recherche.
SBSP_ACTIVATE_NOFOCUS (0x00080000)
Windows Vista et versions ultérieures. Naviguez sans le comportement par défaut de définition du focus dans la nouvelle vue.
Les indicateurs suivants contrôlent la façon dont l’historique est manipulé à la suite de la navigation.
SBSP_CALLERUNTRUSTED (0x00800000)
Microsoft Internet Explorer 6 Service Pack 2 (SP2) et versions ultérieures. La navigation a peut-être été lancée par une page web avec du code de script déjà présent sur le système local.
SBSP_TRUSTFIRSTDOWNLOAD (0x01000000)
Microsoft Internet Explorer 6 Service Pack 2 (SP2) et versions ultérieures. La nouvelle fenêtre est le résultat d’une action lancée par l’utilisateur. Faites confiance à la nouvelle fenêtre si elle tente immédiatement de télécharger du contenu.
SBSP_UNTRUSTEDFORDOWNLOAD (0x02000000)
Microsoft Internet Explorer 6 Service Pack 2 (SP2) et versions ultérieures. La fenêtre navigue vers un fichier non approuvé, non HTML. Si l’utilisateur tente de télécharger le fichier, n’autorisez pas le téléchargement.
SBSP_NOAUTOSELECT
Supprimez la sélection dans le volet d’historique.
SBSP_WRITENOHISTORY
N’écrivez aucun historique de cette navigation dans le dossier Historique Shell.
SBSP_CREATENOHISTORY (0x00100000)
0x00100000. Windows 7 et versions ultérieures. N’ajoutez pas de nouvelle entrée au journal de voyage. Lorsque l’utilisateur entre un terme de recherche dans la zone de recherche et affine ensuite la requête, le navigateur navigue vers l’avant, mais n’ajoute pas d’entrée de journal de voyage supplémentaire.
SBSP_TRUSTEDFORACTIVEX (0x10000000)
Microsoft Internet Explorer 6 Service Pack 2 (SP2) et versions ultérieures. La navigation doit autoriser les invites ActiveX.
SBSP_FEEDNAVIGATION (0x20000000)
Windows Internet Explorer 7 et versions ultérieures. Si les paramètres de Registre actuels l’autorisent, donnez au navigateur une destination vers laquelle accéder.
SBSP_REDIRECT (0x40000000)
Active la redirection vers une autre URL.
SBSP_INITIATEDBYHLINKFRAME (0x80000000)
SBSP_PLAYNOSOUND (0x00200000)
Windows 7 et versions ultérieures. Ne faites pas en sorte que la navigation complète sonne pour chaque frappe dans la zone de recherche.
Valeur retournée
Type : HRESULT
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
Les vues peuvent utiliser cette méthode pour forcer les Explorer Windows à accéder à un emplacement spécifique dans l’espace de noms. En règle générale, il s’agit de dossiers contenus dans la vue.
Exemples
IShellBrowser* psb;
hr = IUnknown_QueryService(punkSite, SID_STopLevelBrowser, IID_PPV_ARGS(&psb));
if (SUCCEEDED(hr))
{
hr = psb->BrowseObject(pidlSearch, SBSP_DEFBROWSER | SBSP_ABSOLUTE);
psb->Release();
}
Configuration requise
| 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 (inclure Shobjidl.h) |
| DLL | Shell32.dll (version 4.0 ou ultérieure) |