Função LoadAcceleratorsA (winuser.h)

Artigo
11/20/2024

Carrega a tabela de acelerador especificada.

Sintaxe

HACCEL LoadAcceleratorsA(
  [in, optional] HINSTANCE hInstance,
  [in]           LPCSTR    lpTableName
);

Parâmetros

[in, optional] hInstance

Tipo: HINSTANCE

Um identificador para o módulo cujo arquivo executável contém a tabela de acelerador a ser carregada.

[in] lpTableName

Tipo: LPCTSTR

O nome da tabela de acelerador a ser carregada. Como alternativa, esse parâmetro pode especificar o identificador de recurso de um recurso de tabela de acelerador na palavra de baixa ordem e zero na palavra de alta ordem. Para criar esse valor, use a macro MAKEINTRESOURCE.

Valor de retorno

Tipo: HACCEL

Se a função for bem-sucedida, o valor retornado será um identificador para a tabela de acelerador carregada.

Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.

Observações

Se a tabela de aceleradores ainda não tiver sido carregada, a função a carregará do arquivo executável especificado.

As tabelas de acelerador carregadas dos recursos são liberadas automaticamente quando o aplicativo é encerrado.

Exemplos

Para obter um exemplo, consulte Criando aceleradores para atributos de fonte.

Nota

O cabeçalho winuser.h define LoadAccelerators 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

Conceitual

CopyAcceleratorTable

CreateAcceleratorTable

DestroyAcceleratorTable

de Aceleradores de Teclado

MAKEINTRESOURCE

de referência de

Compartilhar via