▶ PPPTools Dokumentation
📚 Bibliothek
DE EN
Inhalt
Aktualisiert 2026-07-11

Linien-Parameter (@param line)

Erstellt: 2026-07-11 · Aktualisiert: 2026-07-11

Mit dem Parametertyp line öffnet der Parameter-Dialog einen Rahmen-/Linien-Editor: Farbe, Stärke (pt), Strichart und Sichtbarkeit in einem Control — mit Live-Vorschau. Das Script bekommt eine fertige LineSpec und wendet sie auf die Kontur eines Shapes an.

Syntax

// @param line <name> "<Label>" [default="<farbe>,<stärke>,<strichart>"] [tooltip="…"]
  • default — Startwert im Format Farbe,Stärke,Strichart.
  • Farbe: #RRGGBB — oder none für keinen Rahmen.
  • Stärke: Punkte (z. B. 1.5, 2.25).
  • Strichart: solid · dash · dot/rounddot · squaredot · dashdot · longdash.
  • Beispiele: default="#000000,1.5,solid" · default="#0070C0,2.25,dash" · default="none"
  • Im Script liefert Params.GetLine("<name>") eine LineSpec mit Color, Weight (pt), Dash (MsoLineDashStyle), Visible.

Anwenden

Der Helfer ppptools.SetLine(shape, spec) setzt Farbe, Stärke, Strichart und Sichtbarkeit in einem Aufruf:

// @param line Rahmen "Rahmen" default="#0070C0,2.25,dash" tooltip="Rahmen der markierten Shapes"
// @button Anwenden

var b   = Params.GetLine("Rahmen");
var sel = ppptools.GetSelectedRange();
for (int i = 1; i <= sel.Count; i++)
    ppptools.SetLine(sel[i], b);

Beim Ausführen zeigt der Dialog eine kleine Linien-Vorschau neben dem „Bearbeiten…"-Button. Ein Klick öffnet den Editor mit Farbe · Stärke · Strichart · Sichtbar.

Rahmen entfernen

Setzt du im Editor Sichtbar aus (oder default="none"), wird die Kontur ausgeblendet — praktisch für ein „Rahmen weg"-Snippet.

Einzelne Eigenschaften

Du kannst die LineSpec auch teilweise nutzen — z. B. nur die Stärke übernehmen und Farbe/Strichart unangetastet lassen:

var b = Params.GetLine("Rahmen");
sel[i].Line.Weight = b.Weight;   // nur die Stärke
Eigenschaft Zugriff
Farbe b.Color (System.Drawing.Color)
Stärke (pt) b.Weight
Strichart b.Dash (MsoLineDashStyle)
Sichtbar b.Visible

Verwandte Seiten