Themefarben-Parameter (@param themecolor)
Mit dem Parametertyp themecolor öffnet der Parameter-Dialog einen Palette-Picker, der die in PPPTools hinterlegten Custom Colors (die Marken-/Themefarben-Palette) als Swatches anzeigt. So wählt der Nutzer schnell eine freigegebene Markenfarbe statt frei im Farbraum.
Unterschied zu @param color
@param color öffnet den vollen Windows-Farbdialog (freie RGB-Wahl). @param themecolor zeigt gezielt die Custom Colors als Kacheln — für Markentreue. Ein Klick auf „Andere…" im Picker öffnet bei Bedarf trotzdem den freien Dialog.
Die Custom Colors werden unter Einstellungen → Custom Colors gepflegt (siehe Custom Colors).
Syntax
// @param themecolor <name> "<Label>" [default="#RRGGBB"] [tooltip="…"]
- default — Startfarbe als
#RRGGBB. - Im Script liefert
Params.GetColor("<name>")die gewählte Farbe (System.Drawing.Color) — identisch zu@param color. Es gibt also keine eigeneGetThemeColor-Methode; die Farbe kommt ganz normal überGetColor.
Beispiel
// @param themecolor Marke "Markenfarbe" default="#0070C0" tooltip="Aus der Custom-Colors-Palette wählen"
// @button Anwenden
var c = Params.GetColor("Marke");
var sel = ppptools.GetSelectedRange();
for (int i = 1; i <= sel.Count; i++)
ppptools.SetFill(sel[i], c);
Beim Ausführen zeigt der Dialog einen Farb-Button. Ein Klick öffnet die Custom-Colors-Palette; die gewählte Farbe erscheint als Hex-Wert auf dem Button.
Leere Palette
Sind (noch) keine Custom Colors definiert, zeigt der Picker einen Hinweis und den Button „Andere…" — so kann trotzdem frei gewählt werden.
Wann welcher Farb-Parameter?
| Parameter | Auswahl | Einsatz |
|---|---|---|
@param color |
freier Windows-Dialog (jede RGB-Farbe) | wenn beliebige Farben nötig sind |
@param themecolor |
Custom-Colors-Palette (+ „Andere…") | wenn Markenfarben schnell & konsistent gewählt werden sollen |