A mellékelt Form1.cs 115 sorában lévő elérési útvonalat szükséges esetén módosítsa a program futtatása előtt.
Az MSAgent használatának legfőbb feltétele, hogy az legyen telepítve az adott számítógépre. Ha használjuk az MS Office-t, akkor ez máris megtörtént, de a telepítést mi magunk is elvégezhetjük. Ráadásul az MSAgent egy ingyenes szoftvercsomag, így ha nem lenne még kéznél, akkor a http://www.microsoft.com/msagent oldalról ezt rögtön le is tölthetjük.
Ha nem vagyunk biztosak abban, hogy gépünkön megtalálható-e már az MSAgent vagy sem, akkor a C:\Windows\MSAgent, illetve NT esetén C:\WinNT\MSAgent könyvtár meglétét ellenőrizzük.
Minden egyes animált figura képe és minden tudása egy-egy ACS kiterjesztésű állományban kap helyet. Ezekből jó néhányat találhatunk az MS Office CD-jén is, de a fenti web helyről is letölthetünk néhányat.
A Microsoft az alábbi hardver követelményt tünteti fel az MSAgent használatához:
Minimális követelmény
- Microsoft Windows® 95, Windows 98, Windows NT® 4.0 (x86)
- Internet Explorer version 3.02
- Pentium 100 MHz
- 16 MB RAM
Ahhoz, hogy az MSAgent-et a C#-ban is használni tudjuk, importálnunk kell a COM objektumát. Fontos, hogy ezt még a mellékelt példaprogram megnyitása előtt tegyük meg, különben az nem fog működni!
Az importálást a következőképpen tehetjük meg: a ToolBox-on kattintsunk jobb gombbal, majd a Customize ToolBox menüt válasszuk. A megjelenő ablakban a COM Controls lapon keressük ki a Microsoft Agent Control-t és jelöljük be az előtte lévő CheckBox-ot. Az OK gomb után megjelenik a ToolBox-ban egy Control nevű komponens, mely az MS Agent vezérlőjét takarja.
Egy animált figura megjelenítéséhez a következő lépésekre van szükségünk: először is tegyünk fel a Form-ra egy Control komponenst. A Connected property-t állítsuk igazra, így programunk indulásakor rögtön kapcsolódunk is az MS Agent vezérlőhöz. Majd be kell töltenünk azt az ACS állományt, amelyik figurát használni akarjuk. Ehhez a komponens Characters objektumának Load metódusát használhatjuk. Itt első paraméterként meg kell adnunk egy egyedi sztringet, mellyel később azonosítjuk majd a betöltött figurát. Második paraméter az ACS állomány neve, elérési útvonala. Az elérési útvonalat lehet, hogy módosítania kell, ha az MSAgent könyvtár nem a mellékelt példában megadott helyen van.
protected void button1_Click (object sender, System.EventArgs e)
{
axAgent1.Characters.Load("AgentChar1", "C:\\WINNT\\msagent\\chars\\merlin.acs");
axAgent1.Characters["AgentChar1"].Show(false);
axAgent1.Characters["AgentChar1"].MoveTo(500, 500, 10);
axAgent1.Characters["AgentChar1"].Play("Processing");
}