LoadAccelerators function

Loads the specified accelerator table.

Syntax


HACCEL WINAPI LoadAccelerators(
  _In_opt_  HINSTANCE hInstance,
  _In_      LPCTSTR lpTableName
);

Parameters

hInstance [in, optional]

Type: HINSTANCE

A handle to the module whose executable file contains the accelerator table to be loaded.

lpTableName [in]

Type: LPCTSTR

The name of the accelerator table to be loaded. Alternatively, this parameter can specify the resource identifier of an accelerator-table resource in the low-order word and zero in the high-order word. To create this value, use the MAKEINTRESOURCE macro.

Return value

Type: HACCEL

If the function succeeds, the return value is a handle to the loaded accelerator table.

If the function fails, the return value is NULL. To get extended error information, call GetLastError.

Remarks

If the accelerator table has not yet been loaded, the function loads it from the specified executable file.

Accelerator tables loaded from resources are freed automatically when the application terminates.

Examples

For an example, see Creating Accelerators for Font Attributes.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Winuser.h (include Windows.h)

Library

User32.lib

DLL

User32.dll

Unicode and ANSI names

LoadAcceleratorsW (Unicode) and LoadAcceleratorsA (ANSI)

See also

Reference
CopyAcceleratorTable
CreateAcceleratorTable
DestroyAcceleratorTable
MAKEINTRESOURCE
Conceptual
Keyboard Accelerators

 

 

Community Additions

ADD
Show:
© 2014 Microsoft