Метод ICommDlgBrowser::IncludeObject (shobjidl_core.h)

Статья
08/26/2023

Позволяет в общем диалоговом окне фильтровать объекты, отображаемые в представлении.

Синтаксис

HRESULT IncludeObject(
  IShellView      *ppshv,
  PCUITEMID_CHILD pidl
);

Параметры

ppshv

Тип: IShellView*

Указатель на интерфейс IShellView представления.

pidl

Тип: LPCITEMIDLIST

Идентификатор PIDL относительно папки, идентифицирующий объект .

Возвращаемое значение

Тип: HRESULT

Браузер должен вернуть S_OK, чтобы включить объект в представление, или S_FALSE, чтобы скрыть его.

Этот метод вызывается реализацией IEnumIDList при размещении в диалоговых окнах файлов. Перечислитель вызывает этот метод, чтобы позволить общему диалоговому окку отфильтровать объекты, которые не должны отображаться. Как правило, диалоговые окна файлов получают отображаемый текст элемента и фильтруют по расширению.

Примечание к вызывающим приложениям

Вызовите этот метод перед возвратом объекта в перечислитель IDLIST папки оболочки.

При работе с источниками данных, которые содержат много элементов, таких как библиотеки и поисковые запросы, обратный вызов этого метода приводит к снижению производительности. Чтобы избежать этой ситуации, реализуйте GetViewFlags и верните CDB2GVF_NOINCLUDEITEM. Это позволяет представлению пропустить вызов ICommDlgBrowser::IncludeObject, тем самым повышая производительность.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	shobjidl_core.h (включая Shobjidl.h)
DLL	Shell32.dll (версия 4.0 или более поздняя)

См. также раздел

Пример: поиск в обозревателе проводника

ICommDlgBrowser

Поделиться через