Funzione IsAccelerator (ole2.h)

Articolo
02/29/2024

Determina se la sequenza di tasti specificata esegue il mapping a un acceleratore nella tabella di tasti di scelta rapida specificata.

Sintassi

BOOL IsAccelerator(
  [in]  HACCEL hAccel,
  [in]  int    cAccelEntries,
  [in]  LPMSG  lpMsg,
  [out] WORD   *lpwCmd
);

Parametri

[in] hAccel

Handle per la tabella dell'acceleratore.

[in] cAccelEntries

Numero di voci nella tabella degli acceleratori.

[in] lpMsg

Puntatore al messaggio di sequenza di tasti da tradurre.

[out] lpwCmd

Puntatore a una variabile per ricevere l'identificatore di comando corrispondente se è presente un acceleratore per la sequenza di tasti. Questo parametro può essere NULL.

Valore restituito

Se il messaggio è relativo all'applicazione oggetto, il valore restituito è TRUE. Se il messaggio non è per l'oggetto e deve essere inoltrato al contenitore, il valore restituito è FALSE.

Commenti

Mentre un oggetto è attivo sul posto, l'oggetto ha sempre la possibilità di convertire le sequenze di tasti in acceleratori. Se la sequenza di tasti corrisponde a uno dei relativi acceleratori, l'oggetto non deve chiamare la funzione OleTranslateAccelerator , anche se la chiamata alla funzione TranslateAccelerator ha esito negativo. L'impossibilità di elaborare le sequenze di tasti in questo modo può causare un comportamento incoerente.

Se la sequenza di tasti non è uno degli acceleratori dell'oggetto, l'oggetto deve chiamare OleTranslateAccelerator per consentire al contenitore di provare la conversione dell'acceleratore.

Il server dell'oggetto può chiamare IsAccelerator per determinare se appartiene al messaggio dell'acceleratore. Alcuni server eseguono la conversione dell'acceleratore autonomamente e non chiamano TranslateAccelerator. Tali applicazioni non chiameranno IsAccelerator, perché contengono già le informazioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ole2.h
Libreria	Ole32.lib
DLL	Ole32.dll

Vedi anche

OleTranslateAccelerator

TranslateAccelerator

Condividi tramite