In meinem Beitrag zum Erstellen eines Ribbons in EPLAN, gab es mehrfach den Wunsch eigene Untermenüs zu definieren.
Das ist leider so nicht direkt möglich.

Ich habe ein Script gebaut, dass man per Befehl im Menüband aufrufen kann.

Befehlszeile:

PopUpMenu /Items:"Item 1;TestAction;Tooltip 1|Item 2;TestAction;Tooltip 2|Item 3;TestAction;Tooltip 3"

Es werden alle Menü-Einträge übergeben, mit Text;Action;Tooltip. In meinem Beispiel drei.

using System.Windows.Forms;
using Eplan.EplApi.ApplicationFramework;
using Eplan.EplApi.Base;
using Eplan.EplApi.Scripting;

internal class PopUpMenu
{
  [DeclareAction("PopUpMenu")]
  public bool ActionPopUpMenu(ActionCallingContext acc)
  {
    // Get items
    string itemsString = null;
    acc.GetParameter("Items", ref itemsString);

    if (string.IsNullOrEmpty(itemsString))
    {
      return false;
    }

    ContextMenuStrip menu = new ContextMenuStrip();
    var itemsSplit = itemsString.Split('|');
    foreach (var itemSplit in itemsSplit)
    {
      var split = itemSplit.Split(';');
      if (split.Length < 2)
      {
        new Decider().Decide(EnumDecisionType.eOkDecision, "Wrong parameter value.", "PopUpMenu",
                             EnumDecisionReturn.eOK, EnumDecisionReturn.eOK, "PopUpMenu", false,
                             EnumDecisionIcon.eFATALERROR);
        return false;
      }

      // Create item
      ToolStripMenuItem menuItem = new ToolStripMenuItem();
      string text = split[0];
      menuItem.Text = text;

      // Action
      string action = split[1];
      menuItem.Click += (sender, args) => { new CommandLineInterpreter().Execute(action); };

      // Tooltip
      if (split.Length > 2)
      {
        string tooltipText = split[2];
        menuItem.ToolTipText = tooltipText;
      }

      menu.Items.Add(menuItem);
    }

    menu.Show(Cursor.Position);

    return true;
  }

  [DeclareAction("TestAction")]
  public void ActionTest()
  {
    MessageBox.Show("Hello!");
  }
}

Spiele nun seit ca. 4 Jahren mit dem Gedanken einen Video-Learning-Kurs für das EPLAN Scripting zu erstellen. Ich lerne selbst sehr gut mit Videos. Es ist entspannter als das Lesen, zumindest für mich. Es ist auch super die Leute zu sehen, wie Sie die Software benutzen oder in meinem Fall Code schreiben.
Hilfreich ist auch zu sehen, wie man mit Problemen und Fehlern umgeht. In Text ist das schwer zu beschreiben oder zu zeigen.

Ich habe den Kurs in zwei Teile aufgeteilt. Im Beginner-Kurs erlangt Ihr einen schnellen Einstieg in das Scripting. Im Expert-Kurs wird dann auf verschiedene Bereiche im Scripting eingegangen.

Alles Beispiele sind wie immer kostenlos für alle verfügbar.

Ich hoffe Euch gefallen die Kurse und bin schon gespannt auf Euer Feedback ♥️

Kurse

• Beginner
• Expert

Sander Zuur hatte auf Discord einige Fragen wie man denn PDFs pro Strukturkennzeichen exportieren kann. Freundlicherweise hat er das Script für alle bereitgestellt.
Vielen Dank 🍪

Aufrufparameter:

• sProjectName: The project being processed, If empty it’s expected that its in user GUI mode, at which point it will take the currently selected project and additionally ask for a filter for the structure.
• sOptionFull: if true/1 then a full PDF of the project is exported
• sOptionByMountingLocation: if true/1 then a PDF per cabinet of the project, including all pages in an other structure which contain an object of that cabinet is exported.
• sOptionBySystem: Optional, if true/1 then a PDF per system of the project, including all pages in an other structure which contain an object of that system is exported.
• sOptionOnlyLastNodes: if true/1 then only the lowest level of a structure node is exported.
• sDocumentFilterSet: select a datafilter set possible values: ‘ASBUILT’.

Download: PdfsByLocation

Seit EPLAN 2022 gibt es den ListSelectDecisionContext welcher einen Auswahldialog mit unterschiedlichen Werten anzeigt. Gefällt mir super (wusste aber nichts davon).

StringCollection entries = new StringCollection();
entries.Add("Foo");
entries.Add("Bar");
ListSelectDecisionContext listSelectDecision = new ListSelectDecisionContext(entries, "Foo", "List");
listSelectDecision.AllowMultiSelect = false;
    
var result = new Decider().Decide(listSelectDecision);
if (result == EnumDecisionReturn.eOK)
{
  MessageBox.Show(listSelectDecision.SelectedEntry);
}

Ich hatte ja hier vorgestellt wie man eigene Tabs zum Ribbon hinzufügen kann. Nicolas hat in den Kommentaren ein tolles Beispiel gepostet wie man ein Icon umschalten kann. Habe das mal in ein Script gepackt und noch eine Farbumschaltung eingebaut.

Vielen Dank Nicolas für das Beispiel und die Idee 💡!
Um das Script nutzen zu können muss unter EPLAN/Data/Bilder ein Bild mit dem Dateinamen Icon_template.svg liegen. In der SVG kann anstatt einer Farbe der Platzhalter icon_color eingetragen werden und die Farbe wechselt dann von rot auf grün. Das Beispiel findet Ihr hier Icon_template.svg.

using System.Drawing;
using System.IO;
using System.Text;
using Eplan.EplApi.Base;
using Eplan.EplApi.Gui;
using Eplan.EplApi.Scripting;

public class ChangeRibbonState
{
  private const string TAB_NAME = "ToogleTab";
  private const string GROUP_NAME = "Group";
  private const string ACTION_NAME = "ToogleAction";
  private static bool _state;

  [DeclareAction(ACTION_NAME)]
  public void Action()
  {
    // Here you can get the state from somewhere else (like settings etc.)
    Set(!_state);
  }

  private static void Set(bool state)
  {
    _state = state;
    Set();
  }
    
  [DeclareUnregister]
  public void Unregister()
  {
    RemoveRibbonTab();
  }

  [DeclareEventHandler("Eplan.EplApi.OnMainEnd")]
  public void OnMainEnd()
  {
    RemoveRibbonTab();
  }
    
  private void RemoveRibbonTab()
  {
    RibbonBar ribbonBar = new RibbonBar();
    RibbonTab ribbonTab = ribbonBar.GetTab(TAB_NAME);
    if (ribbonTab != null)
    {
      ribbonTab.Remove();
    } 
  }

  [DeclareRegister]
  public void Register()
  {
    Set();
  }
    
  [DeclareEventHandler("Eplan.EplApi.OnMainStart")]
  public void OnMainStart()
  {
    Set();
  }

  private static void Set()
  {
    var ribbonBar = SetupRibbonBar();

    // Icon
    string imagePath = Path.Combine(PathMap.SubstitutePath("$(MD_IMG)"), "Icon.svg");
    string imageTemplatePath = Path.Combine(PathMap.SubstitutePath("$(MD_IMG)"), "Icon_template.svg");

    string color = Color.Red.Name;
    if (_state)
    {
      color = Color.DarkGreen.Name;
    }

    string content = File.ReadAllText(imageTemplatePath, Encoding.UTF8);
    content = content.Replace("icon_color", color);
    if (File.Exists(imagePath))
    {
      File.Delete(imagePath);
    }
    File.WriteAllText(imagePath, content, Encoding.UTF8);
    RibbonIcon ribbonIcon = ribbonBar.AddIcon(imagePath);

    // Command
    string commandName = ACTION_NAME;
    var ribbonCommandInfo = new RibbonCommandInfo(commandName, ACTION_NAME);
    ribbonBar.UnregisterCommand(ACTION_NAME, TAB_NAME, GROUP_NAME);
    ribbonBar.RegisterCommand(ribbonCommandInfo, ribbonIcon, TAB_NAME, GROUP_NAME);
  }

  private static RibbonBar SetupRibbonBar()
  {
    var ribbonBar = new RibbonBar();

    // Tab
    var ribbonTab = ribbonBar.GetTab(TAB_NAME);
    if (ribbonTab == null)
    {
      ribbonTab = ribbonBar.AddTab(TAB_NAME);
    }

    // Group
    var ribbonCommandGroup = ribbonTab.GetCommandGroup(GROUP_NAME);
    if (ribbonCommandGroup == null)
    {
      ribbonTab.AddCommandGroup(GROUP_NAME);
    }
    return ribbonBar;
  }
}