Méthode IShellBrowser::BrowseObject (shobjidl_core.h)

  • Article

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)

Voir aussi

IShellBrowser