Füllung-Parameter (@param fill)

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

Mit dem Parametertyp fill öffnet der Parameter-Dialog einen Füllungs-Editor: Vollton, Verlauf (zwei Farben + Winkel) oder keine Füllung — mit Live-Vorschau. Das Script bekommt eine fertige FillSpec und wendet sie auf ein Shape an.

Syntax

// @param fill <name> "<Label>" [default="<füllung>"] [tooltip="…"]

Die drei Default-Formate:

Im Script liefert Params.GetFill("<name>") eine FillSpec mit Kind (FillKind.Solid / Gradient / None), Color1, Color2, Angle, Transparency.

Anwenden

Der Helfer ppptools.ApplyFill(shape, spec) verzweigt intern je nach Füllart:

// @param fill Fuellung "Füllung" default="gradient:#0070C0,#00B0F0,90" tooltip="Füllung der markierten Shapes"
// @button Anwenden

var f   = Params.GetFill("Fuellung");
var sel = ppptools.GetSelectedRange();
for (int i = 1; i <= sel.Count; i++)
    ppptools.ApplyFill(sel[i], f);

Im Dialog steht neben dem „Bearbeiten…"-Button eine Füll-Vorschau. Der Editor schaltet zwischen Vollton (Farbe + Transparenz), Verlauf (zwei Farben + Winkel) und Keine um.

Kombiniert mit Rahmen

@param fill und @param line ergänzen sich zu einem kompletten Shape-Style-Snippet:

// @param fill Fuellung "Füllung" default="solid:#0070C0"
// @param line Rahmen   "Rahmen"  default="#003A66,1.5,solid"
// @button Stil anwenden

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

Verwandte Seiten

• Linien-Parameter (@param line)
• Parametrisierte Snippets
• ppptools-Referenz