TranslateAccelerator

Funcţia TranslateAccelerator procese accelerator chei pentru comenzile de meniu. Funcţia se traduce un WM_KEYDOWN sau WM_SYSKEYDOWN mesaj la un mesaj WM_COMMAND sau WM_SYSCOMMAND (dacă există o intrare pentru cheie în tabelul specificat accelerator) şi apoi trimite WM_COMMAND WM_SYSCOMMAND mesaj direct la procedura fereastra corespunzătoare. TranslateAccelerator nu se întoarce până când procedura fereastra prelucrat mesajul.

 int () TranslateAccelerator HWND  hWnd, / / ocupa destinaţie fereastraHACCELhAccTable, / / ocupa accelerator tabelLPMSGlpMsg / / adresa de structura cu mesaj);
 

Parametrii

hWnd

Ocupa în fereastra ale căror mesaje sunt să fie traduse.

hAccTable

Ocupa la un tabel de accelera?ie. Tabelul de accelera?ie trebuie să au fost încărcate de un apel la funcţia de LoadAccelerators sau create de un apel la funcţia de CreateAcceleratorTable.

lpMsg

Indicator spre o structură MSG care conţine informaţii mesaj adus din coada de mesaje firul apel utilizând funcţia GetMessage sau PeekMessage.

Valorile întroarse

Dacă funcţia reuşeşte, valoarea returnată este nenul.

Dacă funcţia nu reuşeşte, valoarea returnată este zero. Pentru a obţine extins informa?ii eroare, apel GetLastError.

Observaţii

Să se diferenţieze mesajul că această funcţie trimite la mesajele trimise de meniuri sau controale, cuvântul high-ordinea de parametrul wParam WM_COMMAND sau WM_SYSCOMMAND mesaj conţine valoarea 1.

Accelerator combinaţii de taste utilizată pentru a selecta elemente din meniul fereastră sunt traduse în mesaje WM_SYSCOMMAND; toate celelalte combinaţii de taste accelerator sunt traduse în WM_COMMAND mesaje.

Atunci când TranslateAccelerator returnează o valoare nenul şi mesajul este tradus, cererea nu trebuie să utilizaţi funcţia TranslateMessage să proceseze mesajul din nou.

Un accelerator nevoie corespunde cu o comandă de meniu.

Dacă comanda de accelera?ie corespunde un element de meniu, se trimite cererea mesaje WM_INITMENU şi WM_INITMENUPOPUP , ca în cazul în care utilizatorul s-au încercat pentru a afişa meniul. Cu toate acestea, aceste mesaje sunt trimise în cazul în care există unul dintre următoarele condi?ii:

• Fereastra este dezactivat.
• Elementul de meniu este dezactivat.
• Combinaţia de taste accelerator nu corespunde unui element din meniul fereastră şi fereastra este minimizată.
• O captura mouse-ul este în vigoare. Pentru informaţii despre capturarea mouse-ului, consultaţi funcţia SetCapture.

Dacă fereastra specificat este fereastra activă şi nici o fereastră are focalizarea tastaturii (care, în general, este cazul dacă fereastra este minimizată), TranslateAccelerator traduce mesaje WM_SYSKEYUP şi WM_SYSKEYDOWN în loc de WM_KEYUP şi WM_KEYDOWN mesaje.

Dacă o acţionare de taste accelerator apare care corespunde unui element de meniu când fereastra care deţine meniul este minimizat, TranslateAccelerator nu a trimite un mesaj WM_COMMAND. Cu toate acestea, dacă o acţionare de taste accelerator apare care nu se potriveşte oricare din elementele din meniul fereastră sau în meniul fereastră , funcţia trimite un mesaj WM_COMMAND, chiar dacă fereastra este minimizată.

Windows CE: Toate mesajele de accelerator cheie sunt traduse în mesaje WM_COMMAND; Windows CE nu acceptă mesajul WM_SYSCOMMAND.

QuickInfo

nbsp; Windows &NT: necesită versiunea 3.1 sau mai târziu.
Windows:Necesită Windows 95 sau o versiune ulterioară.
Windows CE:Necesită versiunea 1.0 sau mai târziu.
Antet:A declarat în winuser.h.
Import Biblioteca:Utilizarea user32.lib.
Unicode:Pus în aplicare ca Unicode şi ANSI versiuni Windows NT.

A se vedea, de asemenea

Claviatură Accelerators prezentare generală, funcţii Accelerator tastatură, CreateAcceleratorTable, GetMessage, LoadAccelerators, MSG, PeekMessage, SetCapture, TranslateMessage, WM_COMMAND, WM_INITMENU, WM_INITMENUPOPUP, WM_KEYDOWN, WM_SYSKEYDOWN, WM_SYSCOMMAND

Index