Insert-Methode

[Der Microsoft-Agent ist ab Windows 7 veraltet und in nachfolgenden Versionen von Windows möglicherweise nicht mehr 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 Befehlzuweisen.
Refname Erforderlich. Ein Zeichenfolgenwert, der dem Namen (ID) des Befehls direkt oberhalb oder unterhalb des Befehls entspricht, in den Sie den neuen Befehl einfügen möchten.
Vorher Optional. Ein boolescher Wert, der angibt, ob der neue Befehl vor dem von 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 zum Formatieren von Alternativen 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 sichtbar ist, wenn die Clientanwendung eingabeaktiv ist. Der Standardwert ist True. Weitere Informationen finden Sie in der Visible-Eigenschaft des Command-Objekts.

Hinweise

Der Wert der Name-Eigenschaft eines Command-Objekts muss innerhalb seiner Commands-Auflistung eindeutig sein. Sie müssen einen Befehl entfernen, bevor Sie einen neuen Befehl mit der gleichen Einstellung für die Name-Eigenschaft erstellen können. Der Versuch, einen Befehl 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

Methode hinzufügen, Methode entfernen, RemoveAll-Methode