Das Command-Objekt

[Microsoft Agent ist ab Windows 7 veraltet und kann in nachfolgenden Versionen von Windows nicht verfügbar sein.]

Ein Command-Objekt ist ein Element in einer Commands-Auflistung . Der Server bietet dem Benutzer Zugriff auf Ihre Command-Objekte , wenn Ihre Clientanwendung eingabeaktiv wird.

Um auf die Eigenschaft eines Command-Objekts zuzugreifen, verweisen Sie darauf in seiner Auflistung mithilfe der Name-Eigenschaft . In VBScript und Visual Basic können Sie die Name-Eigenschaft direkt verwenden:

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

Verwenden Sie für Programmiersprachen, die keine Auflistungen unterstützen, die Command-Methode :

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

Sie können auch auf ein Command-Objekt verweisen, indem Sie einen Verweis darauf erstellen. Deklarieren Sie in Visual Basic eine Objektvariable und verwenden Sie die Set-Anweisung, um den Verweis zu erstellen:

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

In Visual Basic 5.0 können Sie das Objekt auch als Typ IAgentCtlCommandEx deklarieren und den Verweis erstellen. Diese Konvention ermöglicht eine frühe Bindung, die zu einer besseren Leistung führt:

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

In VBScript können Sie einen Verweis als bestimmten Typ deklarieren, aber Sie können die Variable weiterhin deklarieren und auf den Befehl in der Auflistung festlegen:

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

Ein Befehl kann entweder im Popupmenü des Zeichens und im Fenster "Befehle" oder in beidem angezeigt werden. Wenn sie im Popupmenü angezeigt werden soll, muss es über eine Beschriftung verfügen und die "Visible "-Eigenschaft auf "True" festgelegt sein. Darüber hinaus muss seine Commands-Auflistungsobjekt Visible-Eigenschaft auch auf True festgelegt werden. Um im Fenster "Befehle" anzuzeigen, muss ein Befehl seine Beschriftungs - und VoIP-Eigenschaften festlegen. Beachten Sie, dass sich die Popupmenüeinträge eines Zeichens nicht ändern, während das Menü angezeigt wird. Wenn Sie Befehle hinzufügen oder entfernen oder ihre Eigenschaften ändern, während das Popupmenü des Zeichens angezeigt wird, zeigt das Menü diese Änderungen an, wenn der Benutzer ihn weiter anzeigt. Das Befehlsfenster spiegelt jedoch alle änderungen, die Sie vornehmen, dynamisch wider.

In der folgenden Tabelle wird zusammengefasst, wie sich die Eigenschaften eines Befehls auf ihre Präsentation auswirken:

Caption-Eigenschaft

Voice-Caption-Eigenschaft

Voice-Eigenschaft

Visible-Eigenschaft

Enabled-Eigenschaft

Wird im Popupmenü des Zeichens angezeigt

Wird im Fenster "Befehle" angezeigt

Ja

Ja

Ja

True

True

Normal, Verwenden von Beschriftung

Ja, verwenden Sie VoiceCaption

Ja

Ja

Ja

True

False

Deaktiviert, verwenden der Beschriftung

Nein

Ja

Ja

Ja

False

True

Wird nicht angezeigt

Ja, verwenden Sie VoiceCaption

Ja

Ja

Ja

False

False

Wird nicht angezeigt

Nein

Ja

Ja

Nein

True

True

Normal, Verwenden von Beschriftung

Nein

Ja

Ja

Nein

True

False

Deaktiviert, verwenden der Beschriftung

Nein

Ja

Ja

Nein

False

True

Wird nicht angezeigt

Nein

Ja

Ja

Nein

False

False

Wird nicht angezeigt

Nein

Nein

Ja

Ja

True

True

Wird nicht angezeigt

Ja, verwenden Sie VoiceCaption

Nein

Ja

Ja

True

False

Wird nicht angezeigt

Nein

Nein

Ja

Ja

False

True

Wird nicht angezeigt

Ja, verwenden Sie VoiceCaption

Nein

Ja

Ja

False

False

Wird nicht angezeigt

Nein

Nein

Ja

Nein

True

True

Wird nicht angezeigt

Nein

Nein

Ja

Nein

True

False

Wird nicht angezeigt

Nein

Nein

Ja

Nein

False

True

Wird nicht angezeigt

Nein

Nein

Ja

Nein

False

False

Wird nicht angezeigt

Nein

Ja

Nein

Ja

True

True

Normal, mit Beschriftung

Ja, verwenden Sie "Beschriftung"

Ja

Nein

Ja

True

False

Deaktiviert, Verwenden von Beschriftung

Nein

Ja

Nein

Ja

False

True

Wird nicht angezeigt

Ja, verwenden Sie "Beschriftung"

Ja

Nein

Ja

False

False

Wird nicht angezeigt

Nein

Ja

Nein

Nein

True

True

Normal, mit Beschriftung

Nein

Ja

Nein

Nein

True

False

Deaktiviert, Verwenden von Beschriftung

Nein

Ja

Nein

Nein

False

True

Wird nicht angezeigt

Nein

Ja

Nein

Nein

False

False

Wird nicht angezeigt

Nein

Nein

Nein

Ja

True

True

Wird nicht angezeigt

Nein

Nein

Nein

Ja

True

False

Wird nicht angezeigt

Nein

Nein

Nein

Ja

False

True

Wird nicht angezeigt

Nein

Nein

Nein

Ja

False

False

Wird nicht angezeigt

Nein

Nein

Nein

Nein

True

True

Wird nicht angezeigt

Nein

Nein

Nein

Nein

True

False

Wird nicht angezeigt

Nein

Nein

Nein

Nein

False

True

Wird nicht angezeigt

Nein

Nein

Nein

Nein

False

False

Wird nicht angezeigt

Nein

Wenn die Eigenschaftseinstellung null ist. In einigen Programmiersprachen wird möglicherweise keine leere Zeichenfolge wie eine NULL-Zeichenfolge interpretiert. Der Befehl ist weiterhin sprachgeschützt.

Wenn der Server Eingaben für einen Ihrer Befehle empfängt, sendet er ein Command-Ereignis und übergibt den Namen des Command als Attribut des UserInput-Objekts zurück. Anschließend können Sie bedingte Anweisungen verwenden, um den Befehl zu übereinstimmen und zu verarbeiten.