Accelerator operations
[Windowing functions]

Functions

• MG_EXPORT HACCEL GUIAPI CopyAcceleratorTable (HACCEL hacc)

  Copies the specified accelerator table.
  

• MG_EXPORT int GUIAPI DeleteAccelerators (HACCEL hacc, int key, DWORD keymask)

  Deletes an accelerator from the accelerator table.
  

• MG_EXPORT int GUIAPI AddAccelerators (HACCEL hacc, int key, DWORD keymask, WPARAM wParam, LPARAM lParam)

  Adds an accelerator to the accelerator table.
  

• MG_EXPORT int GUIAPI DestroyAcceleratorTable (HACCEL hacc)

  Destroys an accelerator table.
  

• MG_EXPORT HACCEL GUIAPI CreateAcceleratorTable (HWND hWnd)

  Creates an empty accelerator table.
  

• MG_EXPORT int GUIAPI TranslateAccelerator (HACCEL hAccel, PMSG pMsg)

  Translates an accelerator key message to MSG_COMMAND messge and sends it to the window procedure.
  

---

Function Documentation

int GUIAPI AddAccelerators (  HACCEL  hacc, int  key, DWORD  keymask, WPARAM  wParam, LPARAM  lParam )

Adds an accelerator to the accelerator table. This function adds an accelerator to the accelerator table. It's called after you call CreateAcceleratorTable function. Parameters: hacc  The handle to the accelerator table. key  The key value of the accelerator. Note that you can define the key value by either scancode or ASCII code. If you define the key with scancode, the key value should be equal to (scancode + 256). keymask  The shift key state, can be OR'ed value of the following values: KS_SHIFT Shift key should be pressed. KS_ALT Alt key should be pressed. KS_CTRL Ctrl key should be pressed. wParam  The first parameter of the MSG_COMMAND when receiving such a accelerator key. lParam  The second parameter of the MSG_COMMAND when receiving such a accelerator key. Returns: The function returns 0 for success, non-zero for failure. See also: CreateAcceleratorTable, DeleteAccelerators

HACCEL GUIAPI CopyAcceleratorTable (  HACCEL  hacc  )

Copies the specified accelerator table. This function copies the specified accelerator table. The function is used to obtain the accelerator table data that corresponds to an accelerator table handle. Parameters: hacc  The handle to the accelerator table. Returns: The handle to the copied new accelerator table.

HACCEL GUIAPI CreateAcceleratorTable (  HWND  hWnd  )

Creates an empty accelerator table. This function creates an empty accelerator table. Parameters: hWnd  The handle to the main window. Returns: The handle to the new accelerator table, zero when error. See also: AddAccelerators, DestroyAcceleratorTable

int GUIAPI DeleteAccelerators (  HACCEL  hacc, int  key, DWORD  keymask )

Deletes an accelerator from the accelerator table. This function deletes an accelerator from the accelerator table. Parameters: hacc  The handle to the accelerator table. key  The key value of the accelerator. keymask  The shift key state. Returns: The function returns 0 for success, non-zero for failure. See also: AddAccelerators, DestroyAcceleratorTable

int GUIAPI DestroyAcceleratorTable (  HACCEL  hacc  )

Destroys an accelerator table. This function destroys the specified accelerator table hacc. Before closing a window, you must call this function to destroy each accelerator table that is created by using CreateAcceleratorTable function. Parameters: hacc  The handle to the accelerator table. Returns: The function returns 0 for success, non-zero for failure. See also: CreateAcceleratorTable

int GUIAPI TranslateAccelerator (  HACCEL  hAccel, PMSG  pMsg )

Translates an accelerator key message to MSG_COMMAND messge and sends it to the window procedure. Parameters: hAccel  The handle to the accelerator table. pMsg  The pointer to the MSG structure to be translated. Returns: The function returns 0 for success, non-zero for failure. See also: TranslateMessage

---