Metodo ICommDlgBrowser::IncludeObject (shobjidl_core.h)
Consente alla finestra di dialogo comune di filtrare gli oggetti visualizzati dalla visualizzazione.
Sintassi
HRESULT IncludeObject(
IShellView *ppshv,
PCUITEMID_CHILD pidl
);
Parametri
ppshv
Tipo: IShellView*
Puntatore all'interfaccia IShellView della vista.
pidl
Tipo: LPCITEMIDLIST
PiDL, relativo alla cartella, che identifica l'oggetto.
Valore restituito
Tipo: HRESULT
Il browser deve restituire S_OK per includere l'oggetto nella visualizzazione o S_FALSE per nasconderlo.
Commenti
Questo metodo viene chiamato dall'implementazione IEnumIDList quando ospitata nelle finestre di dialogo file. L'enumeratore chiama questo metodo per consentire alla finestra di dialogo comune di filtrare gli oggetti che non devono essere visualizzati. In genere, le finestre di dialogo file otterranno il testo visualizzato dell'elemento e filtrano in base all'estensione.
Nota per la chiamata di applicazioni
Chiamare questo metodo prima di restituire un oggetto nell'enumeratore IDLIST della cartella Shell.Quando si tratta di origini dati con molti elementi, ad esempio librerie e ricerche, il callback a questo metodo comporta prestazioni scarse. Per evitare tale situazione, implementare GetViewFlags e restituire CDB2GVF_NOINCLUDEITEM. In questo modo la visualizzazione consente di ignorare la chiamata a ICommDlgBrowser::IncludeObject, migliorando così le prestazioni.
Requisiti
| Requisito | Valore |
|---|---|
| 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) |