Szkriptek segítségével a Segédprogramok menühöz egy vagy több menüpont adható hozzá. Ehhez a megfelelő szkriptben a [DeclareMenu] attribútumot kell alkalmazni, és ezen attribútumon keresztül kell meghívni a MenuFunction() funkciót. Ha ezután a szkriptet betöltik, akkor az AddMenuItem funkcióval megadott menüpont a menüben létrejön.
A megfelelő C#-szkript általános felépítése a következők szerinti:
public class <ScriptName>
{
[DeclareMenu]
public void MenuFunction()
{
Eplan.EplApi.Gui.Menu oMenu = new Eplan.EplApi.Gui.Menu();
oMenu.AddMenuItem("<MenuText>","<ActionName>");
}
}
A menüpontok minden esetben egy-egy művelethez kapcsolódnak, mely az adott menüpont végrehajtásakor meghívásra kerül. Eszerint vagy a szkript újabb műveletet deklarál (a [DeclareAction] attribútummal), vagy a menüpont egy már meglevő művelethez rendelődik hozzá.
Példa: A következő példa olyan C#-szkriptet mutat be, amely egy műveletet és egy menüpontot deklarál:
public class RegisterScriptMenu
{
[DeclareAction("MyScriptActionWithMenu")]
public void MyFunctionAsAction()
{
MessageBox.Show("MyFunctionAsAction was called!", "RegisterScriptMenu");
return;
}
[DeclareMenu]
public void MenuFunction()
{
Eplan.EplApi.Gui.Menu oMenu = new Eplan.EplApi.Gui.Menu();
oMenu.AddMenuItem("MyMenuText", "MyScriptActionWithMenu");
}
}
A fent feltüntetett példában az AddMenuItem() funkció az Eplan.EplApi.Gui.Menu osztályból generálja a MyMenuText menüpontot, és a MyScriptActionWithMenu művelethez kapcsolja azt.
Ugyanez a példa Visual Basic.Net nyelven az alábbiak szerint alakul:
Public Class RegisterScriptMenu
<DeclareAction("MyScriptActionWithMenu")> _
Public Sub MyFunctionAsAction()
MessageBox.Show("MyFunctionAsAction was called!", "RegisterScriptMenu")
Return
End Sub 'MyFunctionAsAction
<DeclareMenu()> _
Public Sub MenuFunction()
Dim oMenu As New Eplan.EplApi.Gui.Menu()
oMenu.AddMenuItem("MyMenuText", "MyScriptActionWithMenu")
End Sub 'MenuFunction
End Class 'RegisterScriptMenu
Lásd még: