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"