Функция EnumPropsExA (winuser.h)

Статья
11/20/2024

Перечисляет все записи в списке свойств окна, передав их по одному в указанную функцию обратного вызова. EnumPropsEx продолжается до перечисления последней записи или функция обратного вызова возвращает FALSE.

Синтаксис

int EnumPropsExA(
  [in] HWND            hWnd,
  [in] PROPENUMPROCEXA lpEnumFunc,
  [in] LPARAM          lParam
);

Параметры

[in] hWnd

Тип: HWND

Дескриптор окна, список свойств которого необходимо перечислить.

[in] lpEnumFunc

Тип: PROPENUMPROCEX

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

[in] lParam

Тип: LPARAM

Определяемые приложением данные, передаваемые функции обратного вызова.

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

Тип: int

Возвращаемое значение указывает последнее значение, возвращаемое функцией обратного вызова. Это -1, если функция не обнаружила свойство для перечисления.

Замечания

Приложение может удалить только те свойства, которые он добавил. Он не должен удалять свойства, добавленные другими приложениями или самой системой.

Примеры

Пример см. в разделе Свойства окна перечисления для заданногоокна.

Заметка

Заголовок winuser.h определяет EnumPropsEx как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winuser.h (включая Windows.h)
библиотеки	User32.lib
DLL	User32.dll

См. также

концептуальные

PropEnumProcEx

Справочник

свойств окна

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