Insert-Methode

[Microsoft Agent ist ab Windows 7 veraltet und in nachfolgenden Versionen von Windows möglicherweise nicht verfügbar.]

Beschreibung

Fügt ein Command-Objekt in die Commands-Auflistung ein.

Syntax

agent**. Zeichen ("CharacterID"). Commands.Insert** Name, RefName, Before_

Caption, Voice, Enabled, Visible

Teil	Beschreibung
Name	Erforderlich. Ein Zeichenfolgenwert, der der ID entspricht, die Sie dem Befehl zuweisen.
Refname	Erforderlich. Ein Zeichenfolgenwert, der dem Namen (ID) des Befehls entspricht, der direkt oberhalb oder darunter liegt, wo Sie den neuen Befehl einfügen möchten.
Vorher	Optional. Ein boolescher Wert, der angibt, ob der neue Befehl vor dem durch RefName angegebenen Befehl eingefügt werden soll. True (Standard). Der neue Befehl wird vor dem Befehl eingefügt, auf den verwiesen wird. FALSE Der neue Befehl wird nach dem Befehl eingefügt, auf den verwiesen wird.
Caption	Optional. Ein Zeichenfolgenwert, der dem Namen entspricht, der im Popupmenü des Zeichens und im Befehlsfenster angezeigt wird, wenn die Clientanwendung eingabeaktiv ist. Weitere Informationen finden Sie in der Caption-Eigenschaftdes Command-Objekts.
Voice	Optional. Ein Zeichenfolgenwert, der den Wörtern oder Ausdrücken entspricht, die von der Sprach-Engine zum Erkennen dieses Befehls verwendet werden sollen. Weitere Informationen zu Formatierungsalternativen für die Zeichenfolge finden Sie in der Voice-Eigenschaft des Command-Objekts.
Aktiviert	Optional. Ein boolescher Wert, der angibt, ob der Befehl aktiviert ist. Der Standardwert ist True. Weitere Informationen finden Sie in der Enabled-Eigenschaft des Command-Objekts.
Visible	Optional. Ein boolescher Wert, der angibt, ob der Befehl im Befehlsfenster angezeigt wird, wenn die Clientanwendung eingabeaktiv ist. Der Standardwert ist True. Weitere Informationen finden Sie in der Visible-Eigenschaft des Command-Objekts.

Bemerkungen

Der Wert der Name-Eigenschaft eines Command-Objekts muss innerhalb der Commands-Auflistung eindeutig sein. Sie müssen einen Befehl entfernen, bevor Sie einen neuen Befehl mit der gleichen Name-Eigenschaftseinstellung erstellen können. Der Versuch, einen Command mit einer bereits vorhandenen Name-Eigenschaft zu erstellen, löst einen Fehler aus.

Diese Methode gibt auch ein Command-Objekt zurück. Dadurch können Sie ein Objekt deklarieren und ihm einen Befehl zuweisen, wenn Sie die Insert-Methode aufrufen.

   Dim Cmd2 as IAgentCtlCommandEx
   Set Cmd2 = Genie.Commands.Insert ("my second command", "my first command",_ True, "Test", "Test", True, True)
   Cmd2.VoiceCaption = "this is a test"

Weitere Informationen

Add-Methode, Remove-Methode, RemoveAll-Methode