Metodo IShellBrowser::BrowseObject (shobjidl_core.h)
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) |