Propriétés de l’objet Character

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

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

• actif
• AutoPopupMenu
• Description
• ExtraData
• GUID
• HasOtherClients
• Height
• HelpContextID
• HelpFile
• HelpModeOn
• IdleOn
• LanguageID
• gauche
• MoveCause
• Nom
• OriginalHeight
• OriginalWidth
• pitch
• SoundEffectsOn
• Vitesse
• SRModeID
• SRStatus
• top
• TTSModeID
• version
• VisibilityCause
• visible
• largeur

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

Comme avec 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 d’objet et en la définissant sur un caractère de 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, vérifiez 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.