This article was brought to you by the guys from VDF-GUIdance.
For more DataFlex targeted articles see

How to use Microsoft Agent inside VDF applications

by Franco Spinella


Here is an IDE compatible view that shows how to use the class "cAGENT" generated by FlexCOM to integrate MSAGENTS inside your VDF applications.
The view was built while testing all of the MSAgents functions, so please don't comment about the layout of the view, it's only for testing purposes. Please read more before you start using it....
Size: 7 KB Download
Date Created: 01/08/2002
Date Updated: 01/08/2002
Author: Franco Spinella


By Franco Spinella

MS Agent is a technology that enables a programmer to perform text-to-speech synthesis.
for more info see:

Below is a screenshot of the standard character "Merlin" that comes with MS Agent.

How To

  1. Before you can use this view you will have to generate the cAgent Class from within the IDE.

  1. Click Ok on the "Select methods and properties" popup to accept all.
  2. After that you can import the View by registering it as an external component.
  3. Add the view to a program and add the line Use FlexCom before the IDE GENERATED CODE line
  4. Now compile and run
  5. Open The VIEW.

Now before you begin you may need to change the animated character's name and location on the oButtonStart_... buttons. I used 3 different characters. Any one of them can be actived by clicking on one of the three "ButtonStart" buttons on the left hand side of the view.

To do this, you will have to locate and change the following lines inside the Buttonstart buttons:

  1. search for *.ACS files that have been installed on your computer
  2. Change this line: move "c:\winnt\msagent\chars\merlin.acs" to sCharacterid and make it match with the location of the character on your system.
  3. Change this line: move "MERLIN" to sCid this is the name of actor inside merlin.acs.



  • MS Agent is seen by MS as part of the operating system, hence there is no uninstall.
  • NT4 does not have all the characters used in here installed by default. You can load additional characters from the MS Agent Character Data pages below.
  • Make sure to read all the MS licenses before you add this to your applications.
  • If for some reason you are unable to select all 3 characters, then you can try to change the default character. The MS Agent engine will show the default agent when it cannot locate the specified agent.


Download VDF example ~ 7 kb zipfile
This view has been tested and works with VDF7 SP3 and VDF8 SP2

Related Links

MS Agent developer pages

Microsoft Agent Character Data

Microsoft Agent Download Button