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

Button-Beschriftung (@button)

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

Mit der Direktive // @button legst du fest, wie der Bestätigungs-Button im Parameter-Dialog beschriftet ist. Standard ist „Einfügen" — für Actions oder Skripte, die etwas tun statt einzufügen, passt oft „Ausführen", „Anwenden" o. ä. besser.

Syntax

// @button <Beschriftung>
  • Eine Kommentarzeile im Script-Header, wie @param und @help.
  • Die Beschriftung darf Leerzeichen enthalten (der Rest der Zeile wird verwendet).
  • Ohne @button bleibt der Button auf dem Standard „Einfügen".

Wo der Text erscheint

Der Text erscheint auf dem OK-Button des Parameter-Dialogs, der beim Einfügen/Ausführen eines parametrisierten Snippets oder einer Action angezeigt wird. Beim Speichern einer Action wird derselbe Wert zusätzlich als deren Button-Beschriftung übernommen.

Beispiel

Eine Action, die einen Text in alle Textfelder der aktiven Folie schreibt — mit einem Parameter und passender Button-Beschriftung:

// @button Anwenden
// @param string NeuerText "Text" default="Hallo Welt" tooltip="Wird in alle Textfelder geschrieben"

foreach (Shape sh in oSlide.Shapes)
{
    if (sh.HasTextFrame == MsoTriState.msoTrue &&
        sh.TextFrame.HasText == MsoTriState.msoTrue)
    {
        sh.TextFrame.TextRange.Text = Params.GetString("NeuerText");
    }
}

Beim Ausführen erscheint der Parameter-Dialog mit dem Feld „Text" — der Bestätigungs-Button heißt „Anwenden" statt „Einfügen".

Sinnvolle Werte

Wert Wann
Einfügen Standard (Snippet erzeugt ein Objekt)
Ausführen Action / Skript, das eine Funktion ausführt
Anwenden Änderung an bestehenden Objekten
Erstellen Mehrere Objekte / eine Struktur erzeugen
Exportieren Daten/Datei ausgeben

Verwandte Seiten