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)

Vedi anche

Esempio di ricerca del browser Explorer

ICommDlgBrowser