Propriedades do objeto Character

[O Microsoft Agent foi preterido a partir do Windows 7 e pode não estar disponível em versões subsequentes do Windows.]

O objeto Character expõe as seguintes propriedades:

• Ativo
• AutoPopupMenu
• Descrição
• ExtraData
• GUID
• HasOtherClients
• Altura
• HelpContextID
• HelpFile
• HelpModeOn
• IdleOn
• LanguageID
• Esquerda
• MoveCause
• Nome
• OriginalHeight
• OriginalWidth
• Pitch
• SoundEffectsOn
• Velocidade
• SRModeID
• SRStatus
• Top
• TTSModeID
• Versão
• VisibilidadeCausar
• visível
• Largura

Observe que as propriedades Height, Left, Tope Width de um caractere diferem daquelas que podem ser suportadas pelo ambiente de programação para o posicionamento do controle. As propriedades Character aplicam-se à apresentação visível de um caractere, não ao local do controle Microsoft Agent.

Assim como acontece com métodos de objeto Character, você pode acessar as propriedades de um caractere usando a coleção Characters ou simplificar sua sintaxe declarando uma variável de objeto e definindo-a como um caractere na coleção. No exemplo a seguir, Test1 e Test2 serão definidos com o mesmo valor:

   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

Como o servidor carrega um caractere de forma assíncrona, verifique se o caractere foi carregado antes de consultar suas propriedades, por exemplo, usando o evento RequestComplete. Caso contrário, as propriedades podem retornar valores incorretos.