Metodo IShellBrowser::BrowseObject (shobjidl_core.h)

  • Articolo

Informa Esplora risorse di Windows per passare a un'altra cartella.

Sintassi

HRESULT BrowseObject(
  PCUIDLIST_RELATIVE pidl,
  UINT               wFlags
);

Parametri

pidl

Tipo: PCUIDLIST_RELATIVE

Indirizzo di una struttura ITEMIDLIST (elenco identificatore elemento) che specifica la posizione di un oggetto. Questo valore dipende dal flag o dai flag impostati nel parametro wFlags .

wFlags

Tipo: UINT

Flag che specificano la cartella da esplorare. Può essere zero o uno o più dei valori seguenti.

Questi flag specificano se deve essere creata un'altra finestra.

SBSP_DEFBROWSER (0x0000)

Usare il comportamento predefinito, che rispetta l'opzione di visualizzazione (l'impostazione utente per creare nuove finestre o per spostarsi sul posto). Nella maggior parte dei casi, la chiamata di applicazioni deve usare questo flag.

SBSP_SAMEBROWSER

Passare a un'altra cartella con la stessa finestra di Esplora risorse di Windows.

SBSP_NEWBROWSER

Crea un'altra finestra per la cartella specificata.

I flag seguenti specificano la modalità. Questi valori vengono ignorati se viene specificato SBSP_SAMEBROWSER o se viene specificato SBSP_DEFBROWSER e l'utente ha selezionato Sfoglia sul posto.

SBSP_DEFMODE

Usare la finestra corrente.

SBSP_OPENMODE

Specifica nessun albero di cartelle per la nuova finestra di esplorazione. Se il browser corrente non corrisponde alla SBSP_OPENMODE della chiamata all'oggetto sfoglia, viene aperta una nuova finestra.

SBSP_EXPLOREMODE

Specifica un albero delle cartelle per la nuova finestra di esplorazione. Se il browser corrente non corrisponde alla SBSP_EXPLOREMODE della chiamata all'oggetto sfoglia, viene aperta una nuova finestra.

SBSP_HELPMODE

Non supportato. Non usare.

SBSP_NOTRANSFERHIST

Non trasferire la cronologia di esplorazione alla nuova finestra.

I flag seguenti specificano la categoria del parametro pidl .

SBSP_ABSOLUTE

PiDL assoluto, rispetto al desktop.

SBSP_RELATIVE

PiDL relativo alla cartella corrente.

SBSP_PARENT

Esplorare la cartella padre, ignorare il PIDL.

SBSP_NAVIGATEBACK

Tornare indietro, ignorare il PIDL.

SBSP_NAVIGATEFORWARD

Passare avanti, ignorare il PIDL.

SBSP_ALLOW_AUTONAVIGATE (0x00010000)

Abilitare lo spostamento automatico.

I flag seguenti specificano la modalità.

SBSP_KEEPSAMETEMPLATE (0x00020000)

Windows Vista e versioni successive. Non supportato. Non usare.

SBSP_KEEPWORDWHEELTEXT (0x00040000)

Windows Vista e versioni successive. Spostarsi senza cancellare il campo della voce di ricerca.

SBSP_ACTIVATE_NOFOCUS (0x00080000)

Windows Vista e versioni successive. Spostarsi senza il comportamento predefinito dell'impostazione dello stato attivo nella nuova visualizzazione.

I flag seguenti controllano la modalità di modifica della cronologia in seguito alla navigazione.

SBSP_CALLERUNTRUSTED (0x00800000)

Microsoft Internet Explorer 6 Service Pack 2 (SP2) e versioni successive. La navigazione è stata probabilmente avviata da una pagina Web con codice di scripting già presente nel sistema locale.

SBSP_TRUSTFIRSTDOWNLOAD (0x01000000)

Microsoft Internet Explorer 6 Service Pack 2 (SP2) e versioni successive. La nuova finestra è il risultato di un'azione avviata dall'utente. Considera attendibile la nuova finestra se tenta immediatamente di scaricare il contenuto.

SBSP_UNTRUSTEDFORDOWNLOAD (0x02000000)

Microsoft Internet Explorer 6 Service Pack 2 (SP2) e versioni successive. La finestra passa a un file non attendibile e non HTML. Se l'utente tenta di scaricare il file, non consentire il download.

SBSP_NOAUTOSELECT

Eliminare la selezione nel riquadro cronologia.

SBSP_WRITENOHISTORY

Scrivere nessuna cronologia di questo spostamento nella cartella Shell della cronologia.

SBSP_CREATENOHISTORY (0x00100000)

0x00100000. Windows 7 e versioni successive. Non aggiungere una nuova voce al log di viaggio. Quando l'utente immette un termine di ricerca nella casella di ricerca e successivamente affina la query, il browser passa avanti ma non aggiunge una voce aggiuntiva del log di viaggio.

SBSP_TRUSTEDFORACTIVEX (0x10000000)

Microsoft Internet Explorer 6 Service Pack 2 (SP2) e versioni successive. La navigazione deve consentire le richieste ActiveX.

SBSP_FEEDNAVIGATION (0x20000000)

Windows Internet Explorer 7 e versioni successive. Se consentito dalle impostazioni correnti del Registro di sistema, assegnare al browser una destinazione da passare.

SBSP_REDIRECT (0x40000000)

Abilita il reindirizzamento a un altro URL.

SBSP_INITIATEDBYHLINKFRAME (0x80000000)

SBSP_PLAYNOSOUND (0x00200000)

Windows 7 e versioni successive. Non rendere il suono completo dello spostamento per ogni sequenza di tasti nella casella di ricerca.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Le visualizzazioni possono usare questo metodo per forzare l'esplorazione di Esplora risorse a una posizione specifica nello spazio dei nomi. In genere, queste sono cartelle contenute nella visualizzazione.

Esempio

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();
}

Requisiti

   
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shobjidl_core.h (include Shobjidl.h)
DLL Shell32.dll (versione 4.0 o successiva)

Vedi anche

IShellBrowser