Bir Script yardımıyla Yardımcı uygulamalar menüsünebir veya birden çok menü öğesi ekleyebilirsiniz. Bunun için ilgili Script'de [DeclareMenu] özniteliği kullanılır ve öznitelik üzerinden MenuFunction() fonksiyonu çağrılır. Bunun ardından Script yüklendiğinde, AddMenuItem fonksiyonu üzerinden özelleştirilmiş olan menü öğesi oluşturulur.
İlgili bir C# Script'inin genel yapısı şu şekildedir:
public class <ScriptName> { [DeclareMenu] public void MenuFunction() { Eplan.EplApi.Gui.Menu oMenu = new Eplan.EplApi.Gui.Menu(); oMenu.AddMenuItem("<MenuText>","<ActionName>"); } }
Menü öğesi her zaman, menü öğesi uygulandığında çağrılan bir eylem ile bağlıdır. Yani, ya Script için ek bir eylem kaydedilmiştir ([DeclareAction] üzerinden) veya menü öğesi önceden mevcut bir eyleme atanmıştır.
Aşağıdaki örnekte, bir eylem ve bir menü öğesi kaydeden bir C# Script'i gösterilmektedir:
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"); } }
Yukarıda belirtilen örnekte AddMenuItem() fonksiyonu Eplan.EplApi.Gui.Menu sınıfında yeni MyMenuText menü öğesini oluşturmuş ve bunu MyScriptActionWithMenu eylemi ile bağlamıştır.
Aynı örnek Visual Basic.Net içerisinde şu şekilde görünmektedir:
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
Ayrıca bkz.