Adding the MSAgent Control to Your Program

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.

© 1998 SYBEX Inc. All rights reserved.