Método ICommDlgBrowser::IncludeObject (shobjidl_core.h)
Permite que el cuadro de diálogo común filtre los objetos que muestra la vista.
Sintaxis
HRESULT IncludeObject(
IShellView *ppshv,
PCUITEMID_CHILD pidl
);
Parámetros
ppshv
Tipo: IShellView*
Puntero a la interfaz IShellView de la vista.
pidl
Tipo: LPCITEMIDLIST
PIDL, con respecto a la carpeta , que identifica el objeto .
Valor devuelto
Tipo: HRESULT
El explorador debe devolver S_OK para incluir el objeto en la vista o S_FALSE ocultarlo.
Comentarios
La implementación de IEnumIDList llama a este método cuando se hospeda en cuadros de diálogo de archivo. El enumerador llama a este método para permitir que el cuadro de diálogo común filtre los objetos que no se deben mostrar. Normalmente, los cuadros de diálogo de archivo obtendrán el texto para mostrar del elemento y filtrarán por la extensión.
Nota para llamar a aplicaciones
Llame a este método antes de devolver un objeto en el enumerador IDLIST de la carpeta Shell.Cuando se trabaja con orígenes de datos que tienen muchos elementos, como bibliotecas y búsquedas, la devolución de llamada a este método produce un rendimiento deficiente. Para evitar esa situación, implemente GetViewFlags y devuelva CDB2GVF_NOINCLUDEITEM. Esto permite que la vista omita llamar a ICommDlgBrowser::IncludeObject, lo que mejora el rendimiento.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | shobjidl_core.h (include Shobjidl.h) |
| Archivo DLL | Shell32.dll (versión 4.0 o posterior) |