Événement clic
[Microsoft Agent est déconseillé à partir de Windows 7 et peut être indisponible dans les versions ultérieures de Windows.]
-
Description
-
Se produit lorsque l'utilisateur clique sur un personnage ou sur son icône.
-
Syntaxe
-
Sub agent**_Click** (ByVal CharacterID, ByVal Button, ByVal Shift, ByVal X, ByVal Y**)**
Élément Description CharacterID Renvoie l'ID du personnage cliqué sous forme de chaîne de caractères. Button Renvoie un entier qui identifie le bouton qui a été pressé et relâché pour provoquer l'événement. L'argument "bouton" est un champ de bits dont les bits correspondent au bouton gauche (bit 0), au bouton droit (bit 1) et au bouton du milieu (bit 2). Ces bits correspondent respectivement aux valeurs 1, 2 et 4. Un seul de ces bits est activé, ce qui indique le bouton à l'origine de l'événement. Si le personnage comprend une icône de la barre des tâches et que le bit 13 est également défini, le clic s'est produit sur l'icône de la barre des tâches. Maj Renvoie un nombre entier correspondant à l'état des touches Maj, CTRL et ALT lorsque le bouton spécifié dans l'argument button est enfoncé ou relâché. Un bit est défini si la touche est enfoncée. L'argument shift est un champ de bits dont les bits de poids faible correspondent aux touches Maj (bit 0), CTRL (bit 1) et ALT (bit 2). Ces bits correspondent respectivement aux valeurs 1, 2 et 4. L'argument Maj indique l'état de ces touches. Certains, tous ou aucun des bits peuvent être activés, ce qui indique que certaines, toutes ou aucune des touches sont enfoncées. Par exemple, si les touches CTRL et ALT sont toutes deux enfoncées, la valeur de Maj sera 6. X,Y Renvoie un nombre entier indiquant l'emplacement actuel du pointeur de la souris. Les valeurs X et Y sont toujours exprimées en pixels, par rapport au coin supérieur gauche de l'écran.
Notes
Cet événement n'est envoyé qu'au client de saisie active d'un personnage. Lorsque l'utilisateur clique sur un personnage ou sur son icône dans la barre des tâches sans qu'il y ait de client actif, le serveur envoie l'événement à son client actif. Si le personnage est visible (Visible = True), l'action de l'utilisateur définit également le dernier client actif de saisie du personnage comme le client actif de saisie actuel, en envoyant l'événement ActivateInput à ce client, puis en envoyant l'événement Click. Si le personnage est caché (Visible = False) et que l'utilisateur clique sur l'icône du personnage dans la barre des tâches à l'aide du bouton 1, le personnage est également affiché automatiquement.
Remarque
Le fait de cliquer sur un personnage ne désactive pas toutes les autres sorties de caractères (tous les caractères). Cependant, le fait d'appuyer sur la touche Écouter vide la sortie du personnage actif et déclenche l'événement RequestComplete, en transmettant un Request.Status qui indique que la file d'attente du client a été interrompue.