Freigeben über

IAgentCommand

[Der 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 Befehle, die ihre Clientanwendung eingabeaktiv wird. Rufen Sie zum Abrufen eines CommandIAgentCommands::GetCommandauf.

IAgentCommand definiert eine Schnittstelle, mit der Anwendungen Eigenschaften für Command Objekte festlegen und abfragen können, die im Popupmenü eines Zeichens und im Sprachbefehlsfenster angezeigt werden können. Diese Funktionen sind auch über IAgentCommandExverfügbar. Ein Command-Objekt ist ein Element in einer Commands-Auflistung. Der Server bietet dem Benutzer Zugriff auf Ihre Befehle, wenn die Clientanwendung aktiv wird.

Ein Befehl kann entweder im Popupmenü des Zeichens und im Sprachbefehlsfenster angezeigt werden. Damit sie im Popupmenü angezeigt werden kann, muss sie über ein Caption- verfügen und die eigenschaft Visible auf Truefestgelegt haben. Die eigenschaft Visible für das Commands collection object muss auch auf True festgelegt werden, damit der Befehl im Popupmenü angezeigt wird, wenn die Clientanwendung eingabeaktiv ist. Um im Sprachbefehlsfenster angezeigt zu werden, muss ein Befehls- seine VoiceCaption- und Voice- Eigenschaften festgelegt haben. (Wenn keine VoiceCaption-vorhanden ist, wird die einstellung Caption verwendet.)

Die Popupmenüeinträge eines Zeichens ändern sich nicht, während das Menü angezeigt wird. Wenn Sie Befehle hinzufügen oder entfernen oder deren Eigenschaften ändern, während das Popupmenü des Zeichens angezeigt wird, zeigt das Menü diese Änderungen an, wenn sie erneut angezeigt werden. Das Sprachbefehlsfenster zeigt jedoch Änderungen an, während Sie sie vornehmen.

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

Caption-Eigenschaft Voice-Caption-Eigenschaft Voice-Eigenschaft Visible-Eigenschaft Im Popupmenü des Zeichens angezeigt Wird im Sprachbefehlsfenster angezeigt
Ja Ja Ja STIMMT Ja, mit Beschriftungs- Ja, verwenden Sie VoiceCaption-
Ja Ja No¹ STIMMT Ja, mit Beschriftungs- Nein
Ja Ja Ja FALSCH Nein Ja, verwenden Sie VoiceCaption-
Ja Ja No¹ FALSCH Nein Nein
No¹ Ja Ja STIMMT Nein Ja, verwenden Sie VoiceCaption-
No¹ Ja Ja FALSCH Nein Ja, verwenden Sie VoiceCaption-
No¹ Ja No¹ STIMMT Nein Nein
No¹ Ja No¹ FALSCH Nein Nein
Ja No¹ Ja STIMMT Ja, mit Beschriftungs- Ja, mit Beschriftungs-
Ja No¹ No¹ STIMMT Ja Nein
Ja No¹ Ja FALSCH Nein Ja, mit Beschriftungs-
Ja No¹ No¹ FALSCH Nein Nein
No¹ No¹ Ja STIMMT Nein No²
No¹ No¹ Ja FALSCH Nein No²
No¹ No¹ No¹ STIMMT Nein Nein
No¹ No¹ No¹ FALSCH Nein Nein

 

¹ Wenn die Eigenschaftseinstellung null ist. In einigen Programmiersprachen wird eine leere Zeichenfolge möglicherweise nicht wie eine NULL-Zeichenfolge interpretiert.

² Der Befehl ist immer noch sprachgeschützt.

Wenn Sie in der Regel eine Command- mit einer einstellung für Voice definieren, definieren Sie auch Caption und Voice Einstellungen für die zugeordneten Commands Collection. Wenn die Commands--Auflistung für eine Reihe von Befehlen keine Voice- oder keine Einstellung Beschriftung aufweist und derzeit eingabeaktiv ist, aber die BefehleBeschriftung und Einstellungen für Voice, werden die Befehle in der Strukturansicht "Sprachbefehle" unter "(undefiniert Befehl)" angezeigt, wenn die Clientanwendung eingabeaktiv wird.

Wenn der Server Eingaben empfängt, die einem der Command- Objekte entsprechen, die Sie für Ihre Commands-Auflistung definiert haben, sendet er ein IAgentNotifySink::Command-Ereignis und übergibt die ID des Befehls als Attribut des IAgentUserInput-Objekts. Anschließend können Sie bedingte Anweisungen verwenden, um den Befehl abzugleichen und zu verarbeiten.

Methoden in Vtable Order

IAgentCommand-Methoden Beschreibung
SetCaption- Legt den Wert für das Caption- für ein Command -Objekt fest.
GetCaption- Gibt den Wert der Caption -Eigenschaft eines Command -Objekts zurück.
SetVoice- Legt den Wert für den Voice- Text für ein Command -Objekt fest.
GetVoice- Gibt den Wert der Voice -Eigenschaft eines Command -Objekts zurück.
SetEnabled- Legt den Wert der Eigenschaft Enabled für ein Command -Objekt fest.
GetEnabled- Gibt den Wert der eigenschaft Enabled eines Command -Objekts zurück.
SetVisible- Legt den Wert der Visible -Eigenschaft für ein Command -Objekt fest.
GetVisible- Gibt den Wert der Visible -Eigenschaft eines Command -Objekts zurück.
SetConfidenceThreshold Legt den Wert der Confidence -Eigenschaft für ein Command -Objekt fest.
GetConfidenceThreshold Gibt den Wert der Confidence -Eigenschaft eines Command -Objekts zurück.
SetConfidenceText- Legt den Wert der ConfidenceText -Eigenschaft für ein Command -Objekt fest.
getConfidenceText- Gibt den Wert der ConfidenceText -Eigenschaft eines Command -Objekts zurück.
getID- Gibt die ID eines Command -Objekts zurück.

 

 

 

  • Last updated on