IAgentCommand

[Microsoft Agent è deprecato a partire da Windows 7 e potrebbe non essere disponibile nelle versioni successive di Windows.]

Un oggetto Command è un elemento di un insieme Commands . Il server fornisce all'utente l'accesso ai comandi che l'applicazione client diventa attiva. Per recuperare un comando, chiamare IAgentCommands::GetCommand.

IAgentCommand definisce un'interfaccia che consente alle applicazioni di impostare ed eseguire query sulle proprietà per gli oggetti Command che possono essere visualizzati nel menu a comparsa di un carattere e nella finestra Comandi vocali. Queste funzioni sono disponibili anche da IAgentCommandEx. Un oggetto Command è un elemento di un insieme Commands . Il server fornisce all'utente l'accesso ai comandi quando l'applicazione client diventa attiva.

Un comando può essere visualizzato sia nel menu a comparsa del carattere che nella finestra Comandi vocali. Per essere visualizzato nel menu a comparsa, è necessario che la proprietàCaption sia impostata su True. Anche la proprietà Visible per l'oggetto insieme Commands deve essere impostata su True affinché il comando venga visualizzato nel menu a comparsa quando l'applicazione client è attiva dall'input. Per essere visualizzato nella finestra Comandi vocali, è necessario che le proprietà VoiceCaption e Voice siano impostate in un comando. Per la compatibilità con le versioni precedenti, se non è presente VoiceCaption, viene usata l'impostazione Caption .

Le voci del menu a comparsa di un carattere non cambiano mentre viene visualizzato il menu. Se si aggiungono o si rimuovono comandi o si modificano le relative proprietà mentre viene visualizzato il menu popup del carattere, il menu visualizza tali modifiche durante la riproduzione. Tuttavia, la finestra Comandi vocali visualizza le modifiche apportate.

Nella tabella seguente viene riepilogato il modo in cui le proprietà di un comando influiscono sulla relativa presentazione.

Proprietà Caption	Voice-Caption, proprietà	Voice, proprietà	Visible, proprietà	Viene visualizzato nel menu a comparsa del carattere	Viene visualizzato nella finestra Comandi vocali
Sì	Sì	Sì	True	Sì, usando Didascalia	Sì, usando VoiceCaption
Sì	Sì	No¹	Vero	Sì, usando Didascalia	No
Sì	Sì	Sì	False	No	Sì, usando VoiceCaption
Sì	Sì	No¹	False	No	No
No¹	Sì	Sì	True	No	Sì, usando VoiceCaption
No¹	Sì	Sì	False	No	Sì, usando VoiceCaption
No¹	Sì	No¹	True	No	No
No¹	Sì	No¹	False	No	No
Sì	No¹	Sì	True	Sì, usando Didascalia	Sì, usando Didascalia
Sì	No¹	No¹	True	Sì	No
Sì	No¹	Sì	False	No	Sì, usando Didascalia
Sì	No¹	No¹	False	No	No
No¹	No¹	Sì	True	No	No²
No¹	No¹	Sì	False	No	No²
No¹	No¹	No¹	True	No	No
No¹	No¹	No¹	False	No	No

 

¹If l'impostazione della proprietà è Null. In alcuni linguaggi di programmazione una stringa vuota potrebbe non essere interpretata come una stringa Null.

² Il comando è ancora accessibile dalla voce.

In genere, se si definisce un comando con un'impostazione Voice , si definiscono anche le impostazioni Didascalia e Voce per la raccolta Commands associata. Se l'insieme Commands per un set di comandi non ha alcuna impostazione Voice o nessuna didascalia ed è attualmente attiva, ma i comandi dispongono di impostazioni Didascalia e Voce, i comandi vengono visualizzati nella visualizzazione albero della finestra comandi vocali in "(comando non definito)" quando l'applicazione client diventa attiva di input.

Quando il server riceve l'input corrispondente a uno degli oggetti Command definiti per l'insieme Commands , invia un evento IAgentNotifySink::Command e passa l'ID del comando come attributo dell'oggetto IAgentUserInput . È quindi possibile usare istruzioni condizionali per corrispondere e elaborare il comando.

Metodi nell'ordine Vtable

Metodi IAgentCommand	Descrizione
SetCaption	Imposta il valore per la didascalia per un oggetto Command .
GetCaption	Restituisce il valore della proprietà Caption di un oggetto Command .
SetVoice	Imposta il valore per il testo Voice per un oggetto Command .
GetVoice	Restituisce il valore della proprietà Voice di un oggetto Command .
SetEnabled	Imposta il valore della proprietà Enabled per un oggetto Command .
Getenabled	Restituisce il valore della proprietà Enabled di un oggetto Command .
SetVisible	Imposta il valore della proprietà Visible per un oggetto Command .
GetVisible	Restituisce il valore della proprietà Visible di un oggetto Command .
SetConfidenceThreshold	Imposta il valore della proprietà Confidence per un oggetto Command .
GetConfidenceThreshold	Restituisce il valore della proprietà Confidence di un oggetto Command .
SetConfidenceText	Imposta il valore della proprietà ConfidenceText per un oggetto Command .
getConfidenceText	Restituisce il valore della proprietà ConfidenceText di un oggetto Command .
getID	Restituisce l'ID di un oggetto Command .