Methode hinzufügen
[Der Microsoft-Agent ist ab Windows 7 veraltet und in nachfolgenden Versionen von Windows möglicherweise nicht verfügbar.]
-
Beschreibung
-
Fügt der Commands-Auflistung ein Command-Objekt hinzu.
-
Syntax
-
Agent**. Zeichen ("CharacterID"). Commands.Add** Name, Caption, Voice, Enabled, Visible
Teil BESCHREIBUNG Name Erforderlich. Ein Zeichenfolgenwert, der der ID entspricht, die Sie für den Befehl zuweisen. 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 unter der Caption-Eigenschaft des 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 unter der Enabled-Eigenschaft des Command-Objekts. Visible Optional. Ein boolescher Wert, der angibt, ob der Befehl im Popupmenü des Zeichens für das Zeichen angezeigt wird, wenn die Clientanwendung eingabeaktiv ist. Der Standardwert ist True. Weitere Informationen finden Sie unter der Visible-Eigenschaft des Command-Objekts.
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 derselben Einstellung der 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 Add-Methode aufrufen.
Dim Cmd1 as IAgentCtlCommandEx
Set Cmd1 = Genie.Commands.Add ("my first command", "Test", "Test", True, True)
Cmd1.VoiceCaption = "this is a test"