Funzione CreateAcceleratorTableA (winuser.h)

Articolo
11/20/2024

Crea una tabella dell'acceleratore.

Sintassi

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

Parametri

[in] paccel

Tipo: LPACCEL

Matrice di strutture di ACCEL che descrive la tabella degli acceleratori.

[in] cAccel

Tipo: int

Numero di strutture ACCEL nella matrice. Deve essere compreso nell'intervallo compreso tra 1 e 32767 oppure la funzione avrà esito negativo.

Valore restituito

Tipo: HACCEL

Se la funzione ha esito positivo, il valore restituito è l'handle per la tabella dell'acceleratore creata; in caso contrario, è NULL. Per ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

Prima della chiusura di un'applicazione, può usare la funzione DestroyAcceleratorTable per eliminare tutte le tabelle di acceleratore create usando la funzione CreateAcceleratorTable.

Esempi

Per un esempio, vedere Creazione di acceleratori modificabili utente.

Nota

L'intestazione winuser.h definisce CreateAcceleratorTable come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winuser.h (include Windows.h)
libreria	User32.lib
dll	User32.dll