EPLAN API 入门系列- 实战篇(How to Change Properties in EPlan?)
How to Change Properties in EPlan？
In general,I think there are tow ways:
1、Offline programe in Console Application
1 public void Execute() 2 { 3 Console.WriteLine("Update Article Properties Demo"); 4
5 //Start P8
6 EplApplication eplApp = new EplApplication(); 7 eplApp.Init("", true, true); 8
9 Project prj = null; 10 try
11 { 12 using (LockingStep ls = new LockingStep()) 13 { 14 // 1. Open a project
15 Console.WriteLine("Opening project..."); 16 eplApp.OpenProjectDlg(); 17
18 ProjectManager prjMngr = new ProjectManager(); 19 if (prjMngr.CurrentProject == null) 20 { 21 Console.WriteLine("No project is open. Finished."); 22 return; 23 } 24 prj = prjMngr.CurrentProject; 25 Console.WriteLine("Project '{0}' is open.", prj.ProjectFullName); 26
27 // 2. Get all terminal strips in the project
28 DMObjectsFinder fndr = new DMObjectsFinder(prj); 29 TerminalStrip[] arrTermStrips = fndr.GetTerminalStrips(null); 30
31 using (UndoStep us = (new UndoManager()).CreateUndoStep()) 32 { 33 // 3. Change a property
34 Console.WriteLine("Modifying terminal strips..."); 35 foreach (TerminalStrip ts in arrTermStrips) 36 { 37 if (ts.ManualPlacementType != DocumentTypeManager.DocumentType.Circuit 38 && ts.ManualPlacementType != DocumentTypeManager.DocumentType.CircuitSingleLine) continue; 39
40 string sNewValue = string.Format("{0} - Change at {1}", (new Random()).Next(), DateTime.Now.ToShortTimeString()); 41
42 MessageBox.Show(sNewValue.ToString()); 43
44 MultiLangString mls = new MultiLangString(); 45 mls.AddString((new Languages()).GuiLanguage.GetNumber(), sNewValue); 46 ts.Properties.FUNC_TEXT = mls; 47 } 48
49 // revert changes
50 Console.WriteLine("Reverting changes in project..."); 51 us.DoUndo(); 52 } 53
54 Console.WriteLine("Done."); 55 } 56 } 57 catch (System.Exception ex) 58 { 59 Console.WriteLine("ERROR. " + ex.Message); 60 } 61 finally
62 { 63 if (prj != null) prj.Close(); 64
65 GC.Collect(); 66 GC.WaitForPendingFinalizers(); 67
68 Console.WriteLine("Press any key."); 69 Console.ReadKey(); 70
71 eplApp.Exit(); 72 } 73 }
2、Online programe via EventListerner in Eplan.Action.Addin
EventListerner class:
1 public class SystemEventListerner 2 { 3 [DeclareEventHandler("onActionStart.String.*")] 4 public long MyEventHandlerFunction(String strActionName) 5 { 6 try
7 { 8 System.Windows.Forms.MessageBox.Show("Action " + strActionName + " was started!", 9 "MyEventHandler"); 10 } 11 catch (System.InvalidCastException exc) 12 { 13 String strExc = exc.Message; 14 System.Windows.Forms.MessageBox.Show("Parameter error: " + strExc, "MyEventHandler"); 15 } 16
17 return 0; 18
19 } 20 }
Addin Class:
1 #region IEplAddIn Members
2
3 public bool OnExit() 4 { 5 return true; 6 } 7
8 SystemEventListerner _lstnr = null; 9
10 public bool OnInit() 11 { 12 _lstnr = new SystemEventListerner(); 13 _lstnr.MyEventHandlerFunction(Action.NAME); 14
15 return true; 16 } 17
18 public bool OnInitGui() 19 { 20 Menu m = new Menu(); 21
22 uint id = m.GetPersistentMenuId("System messages"); 23
24 //menu item
25 id = m.AddMainMenu("Example", Menu.MainMenuName.eMainMenuUtilities, "Example #1", Action.NAME, Action.DESCR, 1); 26
27 return true; 28 } 29
30 public bool OnRegister(ref bool bLoadOnStart) 31 { 32 //bLoadOnStart = false; // this prevents addin intialization (OnInit, OnInitGui) when P8 starts; not usefull
33 return true; 34 } 35
36 public bool OnUnregister() 37 { 38 _lstnr = null; 39 return true; 40 } 41
42 #endregion
Action class:
1 public bool Execute(ActionCallingContext oActionCallingContext) 2 { 3 try
4 { 5 using (LockingStep ls = new LockingStep()) 6 { 7 // 1. Get all terminal strips in the project
8 SelectionSet oSelSet = new SelectionSet(); 9 Project oProj = oSelSet.GetCurrentProject(true); 10
11 DMObjectsFinder fndr = new DMObjectsFinder(oProj); 12 TerminalStrip[] arrTermStrips = fndr.GetTerminalStrips(null); 13
14 using (UndoStep us = (new UndoManager()).CreateUndoStep()) 15 { 16 // 2. Change a property
17 Console.WriteLine("Modifying terminal strips..."); 18 foreach (TerminalStrip ts in arrTermStrips) 19 { 20 if (ts.ManualPlacementType != DocumentTypeManager.DocumentType.Circuit 21 && ts.ManualPlacementType != DocumentTypeManager.DocumentType.CircuitSingleLine) continue; 22
23 string sNewValue = string.Format("{0} - Change at {1}", (new Random()).Next(), DateTime.Now.ToShortTimeString()); 24
25 MessageBox.Show(sNewValue.ToString()); 26
27 MultiLangString mls = new MultiLangString(); 28 mls.AddString((new Languages()).GuiLanguage.GetNumber(), sNewValue); 29 ts.Properties.FUNC_TEXT = mls; 30 } 31
32 // revert changes 33 //Console.WriteLine("Reverting changes in project...");
34 us.DoUndo(); 35 } 36
37 Console.WriteLine("Done."); 38 } 39 } 40 catch (System.Exception ex) 41 { 42 //Console.WriteLine("ERROR. " + ex.Message);
43 } 44 finally
45 { 46 //if (prj != null) prj.Close();
47
48 GC.Collect(); 49 GC.WaitForPendingFinalizers(); 50
51 //Console.WriteLine("Press any key."); 52 //Console.ReadKey(); 53
54 //eplApp.Exit();
55 } 56
57 return true; 58 }
if any question,welcome you to comment...