_Message WM VKEYTOITEM

Envoyé par une zone de liste avec le style _ WANTKEYBOARDINPUT lbs à son propriétaire en réponse à un message « WM _ KeyOut ».

WM_VKEYTOITEM

    WPARAM wParam;
    LPARAM lParam; 

Paramètres

wParam

LOWORD spécifie le code de la touche virtuelle de la touche sur laquelle l’utilisateur a appuyé. HIWORD spécifie la position actuelle du signe insertion.

lParam

Handle vers la zone de liste.

Valeur de retour

La valeur de retour spécifie l’action exécutée par l’application en réponse au message. Une valeur de retour de-2 indique que l’application a géré tous les aspects de la sélection de l’élément et ne nécessite aucune action supplémentaire de la zone de liste. (Consultez la section Notes.) Une valeur de retour de-1 indique que la zone de liste doit exécuter l’action par défaut en réponse à la séquence de touches. Une valeur de retour supérieure ou égale à 0 spécifie l’index d’un élément dans la zone de liste et indique que la zone de liste doit exécuter l’action par défaut pour la séquence d’entrée sur l’élément spécifié.

Notes

Une valeur de retour de-2 est valide uniquement pour les clés qui ne sont pas converties en caractères par le contrôle de zone de liste. Si le message WM _ keyverse se traduit par un message WM _ char et que l’application traite le message WM _ VKEYTOITEM généré à la suite de la pression sur la touche, la zone de liste ignore la valeur de retour et effectue le traitement par défaut pour ce caractère. WM _ Les messages KeyOut générés par des clés telles que VK _ up, VK _ , VK _ Next et VK _ Previous ne sont pas traduits en messages WM _ char . Dans ce cas, le fait de piéger le message WM _ VKEYTOITEM et de retourner-2 empêche la zone de liste d’exécuter le traitement par défaut pour cette clé.

Pour intercepter les clés qui génèrent un message de type char et effectuer un traitement spécial, l’application doit sous-classer la zone de liste, intercepter les messages WM _ keyverse et WM _ char et traiter les messages de manière appropriée dans la procédure de sous-classe.

Les remarques précédentes s’appliquent aux zones de liste régulières créées avec le style _ WANTKEYBOARDINPUT . Si la zone de liste est owner-drawn, l’application doit traiter le message WM _ CHARTOITEM .

La fonction DefWindowProc retourne-1.

Si une procédure de boîte de dialogue gère ce message, elle doit effectuer un cast de la valeur de retour souhaitée en valeur booléenne et retourner la valeur directement. La _ valeur DWL MSGRESULT définie par la fonction SetWindowLong est ignorée.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows [Applications de bureau Vista uniquement]
Serveur minimal pris en charge
Windows Serveur 2003 [ applications de bureau uniquement]
En-tête
Winuser. h (inclure Windows. h)

Voir aussi

Référence

_CHARTOITEM WM

Autres ressources

HIWORD

LOWORD

WM- _ touche