IAgentCommand

[Microsoft Agent är inaktuell från och med Windows 7 och kan vara otillgänglig i efterföljande versioner av Windows.]

Ett Kommando--objekt är ett objekt i en kommandon samling. Servern ger användaren åtkomst till dina kommandon som klientprogrammet blir indataaktivt. Om du vill hämta ett -kommandoanropar du IAgentCommands::GetCommand.

IAgentCommand definierar ett gränssnitt som gör att program kan ange och fråga efter egenskaper för Kommando objekt som kan visas i ett teckens popup-meny och i fönstret Röstkommandon. Dessa funktioner är också tillgängliga från IAgentCommandEx. Ett Kommando--objekt är ett objekt i en -kommandosamling samling. Servern ger användaren åtkomst till dina kommandon när klientprogrammet blir aktivt.

Ett kommando kan visas i antingen eller både tecknets popup-meny och fönstret Röstkommandon. Om du vill visas i popup-menyn måste den ha en Caption och egenskapen Visible är inställd på True. Egenskapen Visible för dess -kommandon samlingsobjekt måste också anges till True för att kommandot ska visas i popup-menyn när klientprogrammet är indataaktivt. Om du vill visas i fönstret Röstkommandon måste ett -kommando ha sina egenskaper VoiceCaption och Voice. (Om det inte finns någon VoiceCaption-används inställningen Caption för bakåtkompatibilitet.)

Ett teckens popup-menyposter ändras inte medan menyn visas. Om du lägger till eller tar bort kommandon eller ändrar deras egenskaper medan tecknets popup-meny visas, visar menyn dessa ändringar när de spelas upp på nytt. Fönstret Röstkommandon visar dock ändringar när du gör dem.

I följande tabell sammanfattas hur egenskaperna för ett kommando påverkar presentationen.

Rubrikegenskap	Voice-Caption egenskap	Röstegenskap	Synlig egenskap	Visas i popup-menyn för tecken	Visas i fönstret Röstkommandon
Ja	Ja	Ja	Sann	Ja, med bildtext	Ja, med VoiceCaption
Ja	Ja	No¹	Sann	Ja, med bildtext	Nej
Ja	Ja	Ja	Falsk	Nej	Ja, med VoiceCaption
Ja	Ja	No¹	Falsk	Nej	Nej
No¹	Ja	Ja	Sann	Nej	Ja, med VoiceCaption
No¹	Ja	Ja	Falsk	Nej	Ja, med VoiceCaption
No¹	Ja	No¹	Sann	Nej	Nej
No¹	Ja	No¹	Falsk	Nej	Nej
Ja	No¹	Ja	Sann	Ja, med bildtext	Ja, med bildtext
Ja	No¹	No¹	Sann	Ja	Nej
Ja	No¹	Ja	Falsk	Nej	Ja, med bildtext
Ja	No¹	No¹	Falsk	Nej	Nej
No¹	No¹	Ja	Sann	Nej	No²
No¹	No¹	Ja	Falsk	Nej	No²
No¹	No¹	No¹	Sann	Nej	Nej
No¹	No¹	No¹	Falsk	Nej	Nej

 

¹Om egenskapsinställningen är null. På vissa programmeringsspråk kan det hända att en tom sträng inte tolkas som samma som en nullsträng.

²Kommandot är fortfarande rösttillgängligt.

Om du definierar en -kommando med en inställning för Röst definierar du även Caption och Voice-inställningar för dess associerade Kommandon samling. Om kommandon samling för en uppsättning kommandon inte har någon röst eller ingen caption inställning och är för närvarande indataaktiv, men kommandona har inställningar för bildtext och Röst visas kommandon i trädvyn Röstkommandon under "(odefinierat kommando)" när klientprogrammet blir indataaktivt.

När servern tar emot indata som matchar ett av de Kommando objekt som du har definierat för din Commands- samling, skickar den en IAgentNotifySink::Command-händelse och skickar tillbaka ID:t för kommandot som ett attribut för IAgentUserInput--objektet. Du kan sedan använda villkorsstyrda instruktioner för att matcha och bearbeta kommandot.

metoder i Vtable Order

IAgentCommand-metoder	Beskrivning
SetCaption	Anger värdet för Caption för ett Kommando-objekt.
GetCaption	Returnerar värdet för egenskapen Caption för ett Command-objekt.
SetVoice	Anger värdet för texten Voice för ett Command-objekt.
GetVoice	Returnerar värdet för egenskapen Voice för ett Command-objekt.
SetEnabled	Anger värdet för egenskapen Aktiverad för ett Kommando-objekt.
GetEnabled	Returnerar värdet för egenskapen Enabled för ett Command-objekt.
SetVisible	Anger värdet för egenskapen Visible för ett Command-objekt.
GetVisible	Returnerar värdet för egenskapen Visible för ett Command-objekt.
SetConfidenceThreshold	Anger värdet för egenskapen Confidence för ett Command-objekt.
GetConfidenceThreshold	Returnerar värdet för egenskapen Confidence för ett Kommando-objekt.
SetConfidenceText	Anger värdet för egenskapen ConfidenceText för ett Command-objekt.
getConfidenceText	Returnerar värdet för egenskapen ConfidenceText för ett Command-objekt.
getID	Returnerar ID:t för ett Kommando-objekt.