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

Статья
11/20/2024

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

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

Синтаксис

int EnumPropsA(
  [in] HWND          hWnd,
  [in] PROPENUMPROCA lpEnumFunc
);

Параметры

[in] hWnd

Тип: HWND

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

[in] lpEnumFunc

Тип: PROPENUMPROC

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

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

Тип: int

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

Замечания

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

Заметка

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

Требования

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

См. также

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

EnumPropsEx

PropEnumProc

Справочник

свойств окна

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