Kommandoobjektet

[Microsoft Agent är inaktuell från och med Windows 7 och kan vara otillgänglig i efterföljande versioner av Windows.]

Ett kommando objekt är ett objekt i en Kommandon-samling. Servern ger användaren åtkomst till dina Kommando--objekt när klientprogrammet blir indataaktivt.

• egenskaper för kommandobjektet

Om du vill komma åt egenskapen för ett Command-objekt refererar du till det i dess samling med hjälp av egenskapen Name. I VBScript och Visual Basic kan du använda egenskapen Name direkt:

   <i>agent</i>.Characters("<i>CharacterID</i>").Commands("<i>Name</i>").<i>property</i> [= <i>value</i>]

För programmeringsspråk som inte stöder samlingar använder du metoden Kommando:

   <i>agent</i>.Characters("<i>CharacterID</i>").Commands.Command("<i>Name</i>").<i>property</i> [= <i>value</i>]

Du kan också referera till ett kommandoobjekt genom att skapa en referens till det. I Visual Basic deklarerar du en objektvariabel och använder set-instruktionen för att skapa referensen:

   Dim Cmd1 as Object
   ...
   Set Cmd1 = Agent.Characters("MyCharacterID").Commands("SampleCommand")
   ...
   Cmd1.Enabled = True

I Visual Basic 5.0 kan du även deklarera objektet som typ IAgentCtlCommandEx och skapa referensen. Den här konventionen möjliggör tidig bindning, vilket ger bättre prestanda:

   Dim Cmd1 as IAgentCtlCommandEx
   ...
   Set Cmd1 = Agent.Characters("MyCharacterID").Commands("SampleCommand")
   ...
   Cmd1.Enabled = True

I VBScript kan du deklarera en referens som en viss typ, men du kan fortfarande deklarera variabeln och ange den till Kommando i samlingen:

   Dim Cmd1
   ...
   Set Cmd1 = Agent.Characters("MyCharacterID").Commands("SampleCommand")
   ...
   Cmd1.Enabled = True

Ett kommando kan visas i antingen tecknets popup-meny och kommandofönstret eller i båda. Om du vill visa den i popup-menyn måste den ha en undertext och egenskapen Visible är inställd på True. Dessutom måste egenskapen Visible i dess kommandosamlingsobjekt också ställas in på True. För att visas i kommandofönstret måste ett -kommando ha sina egenskaper Caption och Voice. Observera att ett teckens popup-menyposter inte ändras medan menyn visas. Om du lägger till eller tar bort kommandon eller ändrar deras egenskaper medan tecknets popup-meny visas, visar menyn dessa ändringar när användaren nästa gång visar den. Kommandofönstret återspeglar dock dynamiskt alla ändringar du gör.

I följande tabell sammanfattas hur egenskaperna för ett kommando påverka presentationen:

Bildtextegenskap

Voice-Caption Egenskap

Röstegenskap

Synlig egenskap

Aktiverad egenskap

Visas i popup-menyn för figuren

Visas i kommandofönstret

Ja

Ja

Ja

Sann

Sann

Normal, med hjälp av Caption

Ja, med VoiceCaption

Ja

Ja

Ja

Sann

Falsk

Inaktiverad med hjälp av Caption

Nej

Ja

Ja

Ja

Falsk

Sann

Visas inte

Ja, med VoiceCaption

Ja

Ja

Ja

Falsk

Falsk

Visas inte

Nej

Ja

Ja

Nej

Sann

Sann

Normal, med användning av Caption

Nej

Ja

Ja

Nej

Sann

Falsk

Inaktiverad med hjälp av Caption

Nej

Ja

Ja

Nej

Falsk

Sann

Visas inte

Nej

Ja

Ja

Nej

Falsk

Falsk

Visas inte

Nej

Nej

Ja

Ja

Sann

Sann

Förekommer inte

Ja, med VoiceCaption

Nej

Ja

Ja

Sann

Falsk

Visas inte

Nej

Nej

Ja

Ja

Falsk

Sann

Visas inte

Ja, med VoiceCaption

Nej

Ja

Ja

Falsk

Falsk

Visas inte

Nej

Nej

Ja

Nej

Sann

Sann

Visas inte

Nej

Nej

Ja

Nej

Sann

Falsk

Visas inte

Nej

Nej

Ja

Nej

Falsk

Sann

Visas inte

Nej

Nej

Ja

Nej

Falsk

Falsk

Syns inte

Nej

Ja

Nej

Ja

Sann

Sann

Normal, med hjälp av Caption

Ja, med bildtext

Ja

Nej

Ja

Sann

Falsk

Avaktiverad med hjälp av Caption

Nej

Ja

Nej

Ja

Falsk

Sann

Visas inte

Ja, använda bildtext

Ja

Nej

Ja

Falsk

Falsk

Visas inte

Nej

Ja

Nej

Nej

Sann

Sann

Normal, med hjälp av Bildtext

Nej

Ja

Nej

Nej

Sann

Falsk

Inaktiverad med hjälp av bildtext

Nej

Ja

Nej

Nej

Falsk

Sann

Syns inte

Nej

Ja

Nej

Nej

Falsk

Falsk

Visas inte

Nej

Nej

Nej

Ja

Sann

Sann

Visas inte

Nej

Nej

Nej

Ja

Sann

Falsk

Visas inte

Nej

Nej

Nej

Ja

Falsk

Sann

Visas inte

Nej

Nej

Nej

Ja

Falsk

Falsk

Visas inte

Nej

Nej

Nej

Nej

Sann

Sann

Visas inte

Nej

Nej

Nej

Nej

Sann

Falsk

Visas inte

Nej

Nej

Nej

Nej

Falsk

Sann

Visar inte

Nej

Nej

Nej

Nej

Falsk

Falsk

Visas inte

Nej

Om egenskapsinställningen är null. På vissa programmeringsspråk kan det hända att en tom sträng inte tolkas på samma sätt som en nullsträng. Kommandot är fortfarande rösttillgängligt.

När servern tar emot indata för ett av dina kommandon skickar den en Command-händelse och skickar tillbaka namnet på -kommandot som ett attribut för objektet UserInput. Du kan sedan använda villkorsstyrda instruktioner för att matcha och bearbeta -kommandot.