Propriétés de l’objet Character

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

L’objet Character expose les propriétés suivantes :

• Actif
• AutoPopupMenu
• Description
• ExtraData
• GUID
• HasOtherClients
• Hauteur
• HelpContextID
• HelpFile
• HelpModeOn
• IdleOn
• LanguageID
• Gauche
• MoveCause
• Nom
• OriginalHeight
• OriginalWidth
• Inclinaison
• SoundEffectsOn
• Vitesse
• SRModeID
• SRStatus
• Retour au début
• TTSModeID
• Version
• VisibilityCause
• Visible
• Largeur

Notez que les propriétés Height, Left, Top et Width d’un caractère diffèrent de celles qui peuvent être prises en charge par l’environnement de programmation pour le placement du contrôle. Les propriétés Character s’appliquent à la présentation visible d’un caractère, et non à l’emplacement du contrôle Microsoft Agent.

Comme avec les méthodes d’objet Character , vous pouvez accéder aux propriétés d’un caractère à l’aide de la collection Characters ou simplifier votre syntaxe en déclarant une variable objet et en la définissant sur un caractère dans la collection. Dans l’exemple suivant, Test1 et Test2 sont définis sur la même valeur :

   Dim Genie 
   Dim MyRequest
   
   Sub window_Onload

   Agent.Characters.Load "Genie", "https://agent.microsoft.com/characters/v2/genie/genie.acf"

   Set Genie = Agent.Characters("Genie")

   Genie.MoveTo 15,15
   Set MyRequest = Genie.Show()

   End Sub

   Sub Agent_RequestComplete(ByVal Request)

   If Request = MyRequest Then 
      Test1 = Agent.Characters("Genie").Top
      Test2 = Genie.Top
      MsgBox "Test 1 is " + cstr(Test1) + "and Test 2 is " + cstr(Test2)
   End If

   End Sub

Étant donné que le serveur charge un caractère de façon asynchrone, assurez-vous que le caractère a été chargé avant d’interroger ses propriétés, par exemple, à l’aide de l’événement RequestComplete . Sinon, les propriétés peuvent retourner des valeurs incorrectes.