перечисление _SHCONTF (shobjidl_core.h)

  • Статья

Определяет типы элементов, включенных в перечисление. Эти значения используются с методом IShellFolder::EnumObjects .

Синтаксис

typedef enum _SHCONTF {
  SHCONTF_CHECKING_FOR_CHILDREN = 0x10,
  SHCONTF_FOLDERS = 0x20,
  SHCONTF_NONFOLDERS = 0x40,
  SHCONTF_INCLUDEHIDDEN = 0x80,
  SHCONTF_INIT_ON_FIRST_NEXT = 0x100,
  SHCONTF_NETPRINTERSRCH = 0x200,
  SHCONTF_SHAREABLE = 0x400,
  SHCONTF_STORAGE = 0x800,
  SHCONTF_NAVIGATION_ENUM = 0x1000,
  SHCONTF_FASTITEMS = 0x2000,
  SHCONTF_FLATLIST = 0x4000,
  SHCONTF_ENABLE_ASYNC = 0x8000,
  SHCONTF_INCLUDESUPERHIDDEN = 0x10000
} ;

Константы

 
SHCONTF_CHECKING_FOR_CHILDREN
Значение: 0x10
0x00010. Windows 7 и более поздних версий. Вызывающее приложение проверяет наличие дочерних элементов в папке.
SHCONTF_FOLDERS
Значение: 0x20
0x00020. Включите в перечисление элементы, которые являются папками.
SHCONTF_NONFOLDERS
Значение: 0x40
0x00040. Включите элементы, которые не являются папками в перечислении.
SHCONTF_INCLUDEHIDDEN
Значение: 0x80
0x00080. Включение скрытых элементов в перечисление. Сюда не входят скрытые системные элементы. (Чтобы включить скрытые системные элементы, используйте SHCONTF_INCLUDESUPERHIDDEN.)
SHCONTF_INIT_ON_FIRST_NEXT
Значение: 0x100
0x00100. Больше не используется; всегда предполагается. IShellFolder::EnumObjects может возвращать без проверки объекта перечисления. Проверку можно отложить до первого вызова IEnumIDList::Next. Используйте этот флаг, когда пользовательский интерфейс может отображаться перед первым вызовом IEnumIDList::Next . Для представления пользовательского интерфейса необходимо задать для hwnd допустимый дескриптор окна.
SHCONTF_NETPRINTERSRCH
Значение: 0x200
0x00200. Вызывающее приложение ищет объекты принтера.
SHCONTF_SHAREABLE
Значение: 0x400
0x00400. Вызывающее приложение ищет ресурсы, к которым можно предоставлять общий доступ.
SHCONTF_STORAGE
Значение: 0x800
0x00800. Включите элементы со специальными возможностями хранения и их предков, включая скрытые элементы.
SHCONTF_NAVIGATION_ENUM
Значение: 0x1000
0x01000. Windows 7 и более поздних версий. Дочерние папки должны предоставлять перечисление навигации.
SHCONTF_FASTITEMS
Значение: 0x2000
0x02000. Windows Vista и более поздних версий. Вызывающее приложение ищет ресурсы, которые можно быстро перечислить.
SHCONTF_FLATLIST
Значение: 0x4000
0x04000. Windows Vista и более поздних версий. Является устаревшей. Не используйте.
SHCONTF_ENABLE_ASYNC
Значение: 0x8000
0x08000. Windows Vista и более поздних версий. Вызывающее приложение отслеживает уведомления об изменениях. Это означает, что перечислитель не должен возвращать все результаты. Элементы можно сообщать с помощью уведомлений об изменениях.
SHCONTF_INCLUDESUPERHIDDEN
Значение: 0x10000
0x10000. Windows 7 и более поздних версий. Включите скрытые системные элементы в перечисление. Это значение не включает скрытые несистемные элементы. (Чтобы включить скрытые несистемные элементы, используйте SHCONTF_INCLUDEHIDDEN.)

Комментарии

Установив флаг SHCONTF_INIT_ON_FIRST_NEXT , вызывающее приложение предполагает, что метод IShellFolder::EnumObjects может ускорить процесс перечисления, возвращая неинициализированный объект перечисления. Инициализацию можно отложить до запуска процесса перечисления. Если инициализация объекта перечисления является длительным процессом, реализация метода должна немедленно вернуть неинициализированный объект. Отложите инициализацию до первого вызова метода IEnumIDList::Next . Если инициализация требует ввода данных пользователем, реализация метода должна использовать hwnd в качестве родительского окна для пользовательского интерфейса. Описание действий, когда для hwnd задано значение NULL, см. в справочнике по IShellFolder::EnumObjects .

Примечание Имя этого перечисления было изменено на _SHCONTF в Windows Vista. Ранее он назывался tagSHCONTF. Для совместимости с устаревшим кодом имя SHCONTF определяется с помощью оператора typedef, который является синонимом DWORD.
 

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхняя часть shobjidl_core.h (включая Shobjidl.h)