Most of the properties of the MSAgent control are references to other objects that exist within the scope of the control. The most important of these objects is the Characters collection, which contains references for all of the currently loaded characters. Other objects contained in the control are AudioOutput, CommandsWindow, PropertySheet, and SpeechInput. Table 14.1 lists some important properties of the MSAgent control.
Table 14.1: Selected MSAgent Control Properties
Property | Description |
AudioOutput | Contains an object reference to the AudioOutput object |
Characters | Contains an object reference to the Characters collection |
CommandsWindow | Contains an object reference to the CommandsWindow object |
Connected | Contains True if the control is connected to the Agent server |
PropertySheet | Contains an object reference to the PropertySheet object |
SpeechInput | Contains an object reference to the SpeechInput object |
Suspended | Contains True if the Agent server is suspended |
The Connected property is True if the control is connected to the Agent server. Normally, the Connected property is set to True when your program starts or when the control is loaded in your web page, but if you create a new instance of the control at runtime, you may need to set the Connected property to True to force a connection. The Suspended property indicates the state of the Agent server. You can’t change this value directly, but you can ask the user to restart the server by choosing Restart from the Taskbar pop-up menu.