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

Статья
11/20/2024

Создает таблицу акселератора.

Синтаксис

HACCEL CreateAcceleratorTableA(
  [in] LPACCEL paccel,
  [in] int     cAccel
);

Параметры

[in] paccel

Тип: LPACCEL

Массив структур ACCEL, описывающих таблицу акселераторов.

[in] cAccel

Тип: int

Количество структур ACCEL в массиве. Это должно находиться в диапазоне от 1 до 32767 или функция завершится ошибкой.

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

Тип: HACCEL

Если функция выполнена успешно, возвращаемое значение является дескриптором созданной таблицы акселераторов; в противном случае ЗНАЧЕНИЕ NULL. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Замечания

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

Примеры

Пример см. в статье Создание пользовательских редактируемых акселераторов.

Заметка

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

Требования

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