Com o auxílio de um script, você pode acrescentar um ou mais itens ao menu Utilitários . Para isto é empregado o atributo [DeclareMenu] no script correspondente, e solicitada a função MenuFunction() através deste atributo. Sendo carregado, então, o script, é gerado o item do menu, que é especificado através da função AddMenuItem.
A estrutura geral de um script C# correspondente aparece conforme segue:
public class <ScriptName> { [DeclareMenu] public void MenuFunction() { Eplan.EplApi.Gui.Menu oMenu = new Eplan.EplApi.Gui.Menu(); oMenu.AddMenuItem("<MenuText>","<ActionName>"); } }
Um item do menu está sempre vinculado com uma ação, que é solicitada se o item do menu for executado. Isto significa que o script registrou adicionalmente uma ação (através de [DeclareAction]) ou que o item do menu é atribuído a uma ação já existente.
O seguinte exemplo mostra um script em C#, que registra uma ação e um item do menu:
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"); } }
No exemplo citado acima, a função AddMenuItem() gera, a partir da classe Eplan.EplApi.Gui.Menu, o novo item do menu MyMenuText e o conecta com a ação MyScriptActionWithMenu.
O mesmo exemplo aparece no Visual Basic.Net conforme segue:
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
Veja também