Функция EnumObjects (wingdi.h)

Статья
08/27/2023

Функция EnumObjects перечисляет ручки или кисти, доступные для указанного контекста устройства (DC). Эта функция вызывает определяемую приложением функцию обратного вызова один раз для каждого доступного объекта, предоставляя данные, описывающие этот объект. EnumObjects продолжает вызывать функцию обратного вызова до тех пор, пока функция обратного вызова не вернет ноль или пока не будут перечислены все объекты.

Синтаксис

int EnumObjects(
  [in] HDC          hdc,
  [in] int          nType,
  [in] GOBJENUMPROC lpFunc,
  [in] LPARAM       lParam
);

Параметры

[in] hdc

Дескриптор контроллера домена.

[in] nType

Тип объекта. Этот параметр может быть OBJ_BRUSH или OBJ_PEN.

[in] lpFunc

Указатель на функцию обратного вызова, определяемую приложением. Дополнительные сведения о функции обратного вызова см. в разделе Функция EnumObjectsProc .

[in] lParam

Указатель на данные, определяемые приложением. Данные передаются в функцию обратного вызова вместе со сведениями об объекте.

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

Если функция выполнена успешно, возвращаемое значение является последним значением, возвращаемым функцией обратного вызова. Его значение определяется пользователем.

Если перечисление объектов невозможно (например, слишком много объектов), функция возвращает ноль без вызова функции обратного вызова.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	wingdi.h (включая Windows.h)
Библиотека	Gdi32.lib
DLL	Gdi32.dll

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

Функции контекста устройства

Общие сведения о контекстах устройств

EnumObjectsProc

GetObject

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