Compartilhar via


Função CreateAcceleratorTableA (winuser.h)

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 de retorno

Tipo: HACCEL

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

Observações

Antes que um aplicativo seja fechado, ele pode usar a função DestroyAcceleratorTable para destruir as tabelas aceleradoras criadas usando a função CreateAcceleratorTable.

Exemplos

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

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho winuser.h (inclua Windows.h)
biblioteca User32.lib
de DLL User32.dll

Consulte também

ACCEL

Conceitual

CopyAcceleratorTable

DestroyAcceleratorTable

de Aceleradores de Teclado

LoadAccelerators

de referência de

TranslateAccelerator