Activate, méthode

[Microsoft Agent est déconseillé à partir de Windows 7 et peut être indisponible dans les versions ultérieures de Windows.]

Description

Définit le client ou le caractère actif.

syntaxe

agent**. Caractères ( »CharacterID« ). Activate** [State]

Partie	Description
d’état	Optionnel. Vous pouvez spécifier les valeurs suivantes pour ce paramètre : 0 Pas le client actif. 1 Le client actif. 2 (Valeur par défaut) Caractère le plus haut.

Remarques

Lorsque plusieurs caractères sont visibles, un seul des caractères reçoit une entrée vocale à la fois. De même, lorsque plusieurs applications clientes partagent le même caractère, un seul des clients reçoit une entrée de souris (par exemple, le contrôle Microsoft Agent clique ou fait glisser des événements). Le jeu de caractères pour recevoir la souris et l’entrée vocale est le caractère le plus haut et le client qui reçoit l’entrée est le client actif de ce caractère. (La fenêtre du caractère le plus haut apparaît également en haut de l’ordre z de la fenêtre de caractères.) En règle générale, l’utilisateur détermine le caractère le plus haut en sélectionnant explicitement le caractère. Toutefois, l’activation la plus haute change également lorsqu’un caractère est affiché ou masqué (le caractère devient ou n’est plus le plus haut, respectivement.)

Vous pouvez également utiliser cette méthode pour gérer explicitement lorsque votre client reçoit une entrée dirigée vers le caractère, par exemple lorsque votre application devient active. Par exemple, définir 'état sur 2 rend le caractère le plus haut et votre client reçoit tous les événements d’entrée vocale et de souris générés à partir de l’interaction utilisateur avec le caractère. Par conséquent, il rend également votre client le client actif d’entrée du caractère.

Toutefois, vous pouvez également définir vous-même comme client actif pour un caractère sans rendre le caractère le plus haut, en définissant 'état sur 1. Cela permet à votre client de recevoir une entrée dirigée vers ce caractère lorsque le caractère devient le plus haut. De même, vous pouvez définir votre client pour qu’il ne soit pas le client actif (pour ne pas recevoir d’entrée) lorsque le caractère devient le plus haut, en définissant 'état sur 0.

Évitez d’appeler cette méthode directement après une méthode Show. Afficher définit automatiquement le client actif d’entrée. Lorsque le caractère est masqué, l’appel Activer peut échouer s’il est traité avant la fin de la méthode show .

Si vous appelez cette méthode à une fonction, elle retourne une valeur booléenne qui indique si la méthode a réussi. Toute tentative d’appel de cette méthode avec le paramètre State défini sur 2 lorsque le caractère spécifié est masqué échoue. De même, si vous définissez 'état sur 0 et que votre application est le seul client, cet appel échoue, car un caractère doit toujours avoir un client le plus élevé.

   Dim Genie as Object

   Sub FormLoad()

   Agent1.Characters.Load "Genie", "Genie.acs"

   Set Genie = Agent1.Characters ("Genie")

   If (Genie. Activate = True) Then
      'I'm active

   Else
      'I must be hidden or something

   End If 
   
   End Sub

Voir aussi

'événement ActivateInput, événement DeactivateInput