Az AxisVM támogatja a Microsoft COM technológiáját, ezzel lehetővé téve más programok számára, hogy külsőleg meghajtsák az AxisVM-et. Bármilyen program elindíthatja az AxisVM-et, modelleket építhet, számításokat futtathat és kinyerheti a számítási eredményeket a COM-szerveren keresztül. Számos programozási nyelv használható az AxisVM vezérlésére a COM szerveren keresztül, például C#, Python, Delphi vagy akár Excel is az Excel VBA alkalmazásával. Ez a cikk bemutatja az AxisVM COM-szerver konfigurálásához és az AxisVM szoftverrel való interakcióhoz szükséges lépéseket. Ebben a cikkben Visual Studio környezet és C# programozási nyelvet fogunk alkalmazni, de ugyan ezek a lépések érvényesek más környezet és nyelv használata során is.
Regisztráció #
A COM-szervert regisztrálni kell az operációs rendszer beállításjegyzékében (registry), hogy az IDE-k (pl. Visual Studio, Delphi IDE, Visual Basic Editor in Excel és others) láthassák az AxisVM típusú könyvtárat. A COM-szerver regisztrálása automatikusan megtörténik az AxisVM telepítése során. Az IDE megjeleníti a COM-szerver összes regisztrált verzióját.
Az AxisVM indítása a COM-szervern keresztül #
Jelen cikkben a Visual Studio 2022 és a C# programming nyelv használatával hozunk létre egy új projektet, és kapcsolódunk az AxisVM-hez a COM-szerveren keresztül. A projekt egy Windows Form App lesz, egyetlen gombbal az AxisVM futtatásához.
A COM server library (konkrétan az AxisVM Type Library) regisztrálása a felhasználói projektbe #
- Hozzon létre egy új C# projektet a Visual Studio -ban, ahogy az alábbi képeken látható:
- Kattintson jobb gombbal a projekt nevére (itt: AxisVMTutorial) a Solution Explorer ablak tetején és válassza az Add menüt, majd a COM Reference -t. A Reference Manager ablak jön majd fel, a keresőmezőbe kezdje el gépelni az AxisVM -t. A felajánlott lehetőségek közül az AxisVM Library –t kell választani. Ha több van, azt, amelyik AxisVM –et szeretné használni (valószínűleg a legmagasabb verziójút). Az AxisVM Library meg kell jelenjen a Dependencies listában.
C#-ban az AxisVM COM szerver elérése #
Az alábbi OpenAxisVM eljárást használjuk az AxisVM-hez való kapcsolódáshoz. Ennek konkrét belső működése:
- Egy globális változót definiálunk: IAxisVMApplication típussal, ebbe kerül majd a konkrét AxisVMApplication objektum.
- New AxisVMApplication() hívással létrehozunk egy új AxisVM objektumot, majd megvárjuk amíg ez betöltődik (a Loaded tulajdonság vizsgálatával).
- Az elindított AxisVM –et a Visible tulajdonság állításával láthatóvá tesszük.
IAxisVMApplication axisVMApplication; // Define a global variable for AxisVM.
public int OpenAxisVM(int _MaxWaitTime) // _MaxWaitTime in seconds.
{ const int cSleepTime = 100; // In milliseconds
int axisVMStatus=0; // Variable to track the status of AxisVM.
uint openTrialTimes = 0; // Number of times the program is trying to launch AxisVM.
if (this.axisVMApplication == null) // check if axisVMApplication is not defined.
{
this.axisVMApplication = new AxisVMApplication(); //Create an object of AxisVMApplication.
// Check the status of AxisVM (loaded or not) and the openTrialTimes is less than the maximum trial times.
while (((IAxisVMApplication)this.axisVMApplication).Loaded == ELongBoolean.lbFalse && (openTrialTimes < _MaxWaitTime * 1000 / cSleepTime))
{
System.Threading.Thread.Sleep(cSleepTime); // Put the thread to sleep.
openTrialTimes++; // Increase the number of trial times after each trial.
}
// check if the AxisVM is loaded and assign.
if (((IAxisVMApplication)this.axisVMApplication).Loaded == ELongBoolean.lbTrue)
{
axisVMStatus = 1; // Assign a value of 1 if loaded.
}
else
{
axisVMStatus = -1; // Assign -1 if not loaded.
}
// Check if the status is larger than 1 (i.e. loaded).
if (axisVMStatus > 0)
{
this.axisVMApplication.Visible = ELongBoolean.lbTrue; // Make AxisVM Visible.
}
else
{
this.axisVMApplication = null; // Assign null for the object.
}
return axisVMStatus; // Return the status of AxisVM.
}
return -1; // Return -1 if there is an defined object.
}
- Az OpenAxisVM eljárás hívása után az axisVMApplication fel lesz töltve a tényleges hivatkozással; jelen példában ezt a hívást a button1_Click eljárásban végezzük el.
private void button1_Click(object sender, EventArgs e)
{
OpenAxisVM(100); // Execute the OpenAxisVM method.
}
- Futtasa a projektet a Debug menu –ből a Start debugging opcióval, vagy direktbe az F5 billentyű lenyomásával. A Form amire egy gombot tett meg fog jelenni. Kattintson a gombra, majd pár másodperces várakozás után az AxisVM meg fog jelenni.
- Az AxisVM használatának befejezéséhez a programból az AxisVMApplication Quit() eljárását kell hívni.
Tipikus Problémák #
- Több AxisVM COM szerver is regisztrálva van, és emiatt nem találja meg az operációs rendszer az AxisVM-t.
Megoldás: Zárja be a Visual Studio-t és minden futó AxisM példányt. Futtassa a használni kívánt AxisVM könyvtárából az !UnregAxisVMComServer.bat-ot adminisztrátori jogosultsággal. Ez minden AxisVM COM szervert törölni fog (fogadja el a registry módosítást). Ezután regisztrálja a COM szervert adminisztrátor ként futtatva a !REGISTER_AXISVM_X64.bat –ot és/vagy a !REGISTER_AXISVM.bat-ot (az első a 64 bites a második a 32 bites verziót regisztrálja. Alapértelmezésben csak a 64 bites verzió telepítődig, de ez csak 64 bites kliensekkel tud együttműködni. Ha 32 bites klienssel akarja használni, az AxisVM telepítését elindítva válassza annak a 32 bites verzióját telepítésre). Ha még mindig nem elérhető az AxisVM COM szerver, telepítse újra az AxisVM-et.
További információ: AxisVM COM Server Interface.