Compartir a través de

IAgentCommand

[Microsoft Agent está en desuso a partir de Windows 7 y puede no estar disponible en versiones posteriores de Windows].

Un objeto Command es un elemento de una colección Commands. El servidor proporciona al usuario acceso a los comandos que la aplicación cliente activa. Para recuperar un comando , llame a IAgentCommands::GetCommand.

IAgentCommand define una interfaz que permite a las aplicaciones establecer y consultar propiedades para objetos Command que pueden aparecer en el menú emergente de un carácter y en la ventana Comandos de voz. Estas funciones también están disponibles en IAgentCommandEx. Un objeto command es un elemento de una colecciónCommands de. El servidor proporciona al usuario acceso a los comandos cuando la aplicación cliente se activa.

Un comando puede aparecer en el menú emergente del carácter o en la ventana Comandos de voz. Para que aparezca en el menú emergente, debe tener uncaption dey tener la propiedad Visible establecida en True. La propiedad Visible para su Command objeto de colección también debe establecerse en True para que el comando aparezca en el menú emergente cuando la aplicación cliente esté activa. Para que aparezca en la ventana Comandos de voz, un comando debe tener sus propiedades VoiceCaption y Voice establecidas. (Para la compatibilidad con versiones anteriores, si no hay VoiceCaption, se usa la configuración caption de).

Las entradas del menú emergente de un carácter no cambian mientras se muestra el menú. Si agrega o quita Comandos o cambia sus propiedades mientras se muestra el menú emergente del carácter, el menú muestra esos cambios cuando se vuelven a reproducir. Sin embargo, la ventana Comandos de voz muestra los cambios a medida que los realiza.

En la tabla siguiente se resume cómo afectan las propiedades de un comando a su presentación.

Caption (propiedad) Voice-Caption (propiedad) Voice (propiedad) Visible (propiedad) Aparece en el menú emergente del carácter Aparece en la ventana Comandos de voz
Sí Sí Sí Verdadero Sí, concaption de Sí, convoiceCaption de
Sí Sí No¹ Verdadero Sí, concaption de No
Sí Sí Sí Falso No Sí, convoiceCaption de
Sí Sí No¹ Falso No No
No¹ Sí Sí Verdadero No Sí, convoiceCaption de
No¹ Sí Sí Falso No Sí, convoiceCaption de
No¹ Sí No¹ Verdadero No No
No¹ Sí No¹ Falso No No
Sí No¹ Sí Verdadero Sí, concaption de Sí, concaption de
Sí No¹ No¹ Verdadero Sí No
Sí No¹ Sí Falso No Sí, concaption de
Sí No¹ No¹ Falso No No
No¹ No¹ Sí Verdadero No No²
No¹ No¹ Sí Falso No No²
No¹ No¹ No¹ Verdadero No No
No¹ No¹ No¹ Falso No No

 

¹Si el valor de la propiedad es null. En algunos lenguajes de programación, es posible que una cadena vacía no se interprete como la misma que una cadena nula.

²El comando sigue siendo accesible por voz.

Por lo general, si define uncomando decon una configuración dede voz de, también define caption y configuración de Voice para su colección Commands asociada. Si la colección de comandos de para un conjunto de comandos no tiene de voz o ninguna configuración caption y actualmente está activa de entrada, pero los comandos de tienen de título y configuración de voz, los comandos de aparecen en la vista de árbol ventana comandos de voz en "(comando indefinido)" cuando la aplicación cliente se vuelve activa de entrada.

Cuando el servidor recibe la entrada que coincide con uno de los objetosCommand dedefinidos para la colecciónCommand de, envía un evento IAgentNotifySink::Command y devuelve el identificador del comando como atributo del objeto IAgentUserInput. Después, puede usar instrucciones condicionales para buscar coincidencias y procesar el comando.

Métodos de de orden de Vtable

Métodos IAgentCommand Descripción
SetCaption Establece el valor delcaption depara un objeto Command.
GetCaption Devuelve el valor de la propiedadCaption dede un objetoCommand de.
SetVoice Establece el valor del textode voz depara un objetoCommand de.
GetVoice Devuelve el valor de la propiedadVoice de un objetoCommand de.
SetEnabled Establece el valor de la propiedadEnabledpara un objetoCommand de.
GetEnabled Devuelve el valor de la propiedadEnabledde un objetoCommand de.
SetVisible Establece el valor de la propiedadVisiblepara un objeto Command.
GetVisible Devuelve el valor de la propiedadVisiblede un objetoCommand de.
SetConfidenceThreshold Establece el valor de la propiedadDe confianza depara un objeto commandde.
GetConfidenceThreshold Devuelve el valor de la propiedadConfidencede un objeto commandde.
SetConfidenceText Establece el valor de la propiedadConfidenceText depara un objetoCommand de.
getConfidenceText Devuelve el valor de la propiedad ConfidenceText de un objeto Command.
getID Devuelve el identificador de un objeto commandde.

 

 

 

  • Last updated on