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

перечисление _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
} ;

Constants

 
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 . Для представления пользовательского интерфейса необходимо задать допустимый дескриптор окна.
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 [только классические приложения]
Header shobjidl_core.h (include Shobjidl.h)
  • Last updated on