Função CreateAcceleratorTableA (winuser.h)

Artigo
08/27/2023

Cria uma tabela de aceleradores.

Sintaxe

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

Parâmetros

[in] paccel

Tipo: LPACCEL

Uma matriz de estruturas ACCEL que descreve a tabela de aceleradores.

[in] cAccel

Tipo: int

O número de estruturas ACCEL na matriz. Isso deve estar dentro do intervalo de 1 a 32767 ou a função falhará.

Valor retornado

Tipo: HACCEL

Se a função for bem-sucedida, o valor retornado será o identificador para a tabela de aceleradores criada; caso contrário, será NULL. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Antes de um aplicativo ser fechado, ele pode usar a função DestroyAcceleratorTable para destruir todas as tabelas de aceleradores criadas usando a função CreateAcceleratorTable .

Exemplos

Para obter um exemplo, consulte Criando aceleradores editáveis pelo usuário.

Observação

O cabeçalho winuser.h define CreateAcceleratorTable como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll