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

Загружает указанную таблицу ускорителей.

Синтаксис

HACCEL LoadAcceleratorsW(
  [in, optional] HINSTANCE hInstance,
  [in]           LPCWSTR   lpTableName
);

Параметры

[in, optional] hInstance

Тип: HINSTANCE

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

[in] lpTableName

Тип: LPCTSTR

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

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

Тип: HACCEL

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

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

Комментарии

Если таблица ускорителей еще не загружена, функция загружает ее из указанного исполняемого файла.

Таблицы ускорителей, загруженные из ресурсов, освобождаются автоматически при завершении работы приложения.

Примеры

Пример см. в разделе Создание ускорителей для атрибутов шрифта.

Примечание

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

Требования

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

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

Основные понятия

CopyAcceleratorTable

CreateAcceleratorTable

DestroyAcceleratorTable

Сочетания клавиш

MAKEINTRESOURCE

Справочные материалы