Gestaltungsregeln sind Aktionen, die mit Rahmen und Textplatzhaltern verbunden werden können und automatisch in festgelegten Situationen wie nach dem Laden eines Platzhalters ausgeführt werden. Mit Bedingungen kann die Ausführung zusätzlich gesteuert werden. Rahmen können beliebig viele Gestaltungsregeln haben und jede Regel und Bedingung kann mit bis zu vier zusätzlichen Parametern versehen werden.

Ein fest Rahmen eingebauter Satz an Regeln und Bedingungen unterstützt die gebräuchlichsten Anforderungen. Mit eigenen Aktionen kann der Funktionsumfang der Regeln und Bedingungen beliebig erweitert werden.

Gestaltungsregeln können in unterschiedlichen Situationen ausgeführt werden.

Textgestaltungsregeln werden nur beim Laden der Platzhalter (Situation ) ausgeführt. Aktivierungen in anderen Situationen werden ignoriert.

Typ		Beschreibung
Nach Neuanlage		Die Regeln wird immer dann ausgeführt, wenn ein Rahmen aus einem Template neu angelegt wurde und geladen ist. Wurde der Rahmen über ein Skript z.B. mit ducument::place_items eingefügt, wird die Regel auch dann ausgeführt, wenn der Parameter autoload 0 ist und also noch nicht geladen ist. Sollen die Regeln nach dem Laden noch einmal ausgeführt werden, muss das im Skript mit itemlist::apply_layout_rules gemacht werden. Achtung : Die Regeln werden nach den <--Regeln ausgeführt. Bei Copy/Paste, Drag/Alt-Drop von Rahmen werden die Regeln nicht ausgeführt! Beim normalen Erzeugen neuer Rahmen könne die Regeln natürlich nicht ausgeführt werden - in diesen Rahmen ist ja noch gar keine Regel hinterlegt.
Nach Laden		Nach dem Laden der Platzhalter eines Rahmens. Der Rahmen selbst muss keinen Platzhalter haben. InDesign®-Gruppen, Statusobjekte und Pushbuttons führen die Regeln nicht aus. Es wird aber in die Unterrahmen dieser Objekte "eingetaucht".
Bei Reorganisationen		Die Regel wird immer dann aufgerufen, wenn ein Rahmen bei Seitenreorganisationen bearbeitet wurde.
Geometrieänderungen		Die Regel wird jedesmal, wenn der Rahmen seine Gösse oder Position im Dokument ändert, ausgeführt. Sie sollten diesen Regeltyp sparsam verwenden. Interaktive Skriptbefehle wie showmessage, file::select_file usw. dürfen in diesen Regeln nicht verwendet werden! Beim Einfügen von Templates und beim Laden und Aufbau von Rahmen wird die Bearbeitung abgeschaltet.
Nach Aufbau		Die Regel wird ausgeführt nachdem ein Produkt fertig geladen und aufgebaut wurde. Die Liste gFrames enthält alle Rahmen des Produktes zu dem gFrame gehört. Geometrieänderungen des Rahmens werden vom vom Produktaufbau nicht mehr registiert und können zum Überlauf der Seitenelmente führen! Achtung: Die Regeln werden nur vom Produktaufbau ausgeführt. Beim Einfügen einzelner Produkte z.B. mit Drag And Drop werden sie nicht ausgeführt.

Beim Anlegen und Ändern von Templates werden alle Regeln abgeschaltet.

Fügen Sie ein Template direkt aus der Template-Palette ins Dokument ein, werden die Regeln ebenfalls vorübergehend abgeschaltet. Mit gehaltener Command-Taste können Sie die definierten Regeln trotzdem ausführen lassen.

[ab Comet 3.2.3] Die Reihenfolge, in der die Rahmen bearbeitet werden, wird durch die Rahmen-Kennung festgelegt. Beim Vergleich der Kennungen werden die UTF-8-Darstellungen der Zeichen zum Vergleich verwendet.

Rahmenkennungen werden in der Palette Template-Verhalten gesetzt.

Versionen vor 3.2.3 verwenden als Rahmenreihenfolge die UIDs der Rahmens.

[Ab v3.2.3 R2410] Die Ausführung von Gestaltungsregeln kann von Bedingungen abhängig gemacht werden. Neben einer Reihe von Standardbedingungen können Sie auch hier eigene Bedingungen erstellen. Die Tests verwenden jeweils genau eine Bedingung. Bedingungen können einen ELSE-Zweig haben und beliebig tief geschachtelt werden. Bedingungen können nicht negiert oder mit 'Und' oder 'Oder' verknüpft werden. Die entsprechenden Konstruktionen können aber einfach umformuliert werden:

Eine Regel R soll ausgeführt werden, wenn die Bedingung A nicht erfüllt ist.

Führen Sie in diesem Fall die Regel im else-Zweig aus:

if A
else
    R
end

Die Regel R soll ausgeführt werden, wenn die Bedingungen A und B erfüllt sind.

Setzen Sie die zweite Bedingung als Unterbedingung in die erste:

if A
    if B
        R
    end
end

Die Regel R soll ausgeführt werden, wenn entweder die Bedingung A oder die Bedingung B (oder beide) erfüllt sind.

Die naheliegende Lösung, zwei if-Anweisungen hintereinander zu machen, einmal für A und einmal für B, hat einen kleinen Schönheitsfehler : Wenn A und B beide erfüllt sind, wird R zweimal ausgeführt. Verwenden Sie in diesem Fall besser folgende Konstruktion:

if A
    R
else
    if B
        R
    end
end

Der Ausführungsstatus von Bedingungen wird automatisch aus den Statusfeldern der darunterliegenden Regeln berechnet. Könnte mindestens eine der Regeln ausgeführt werden, wird der entsprechende Status aktiviert. Der Ausführstatus von Bedingungen kann nicht manuell gesetzt werden.

Einige Regeln sind fest eingebaut verfügbar. Hier eine Aufstellung aller Standard-Regeln für Rahmen:

Weitere Standardregeln können hinzukommen.

Die Tabelle beschreibt alle verfügbaren Standardbedingungen.

Weitere Standardbedingungen können hinzukommen.

Genau wie Rahmen können auch Textplatzhalter mit Gestaltungsregeln versehen werden. Ein Satz Standardregeln ist in Ihren Plugins bereits implementiert. Die folgende Tabelle gibt eine Übersicht über die verfügbaren Standardregeln für Textplatzhalter.

Textgestaltungsregeln werden nur beim Laden der Platzhalter (Situation <-) ausgeführt. Aktivierungen in anderen Situationen werden ignoriert. Beachten Sie bitte, dass die Textgestaltungsregeln ausschließlich in Texten, die mit einem Platzhalter verknüpft sind, gesetzt werden können!

Weitere Standardregeln können hinzukommen.

[ab v3.3.1 R3355] Die folgende Tabelle zeigt alle Standard-Bedingungen für Textregeln.

Weitere Standardregeln können hinzukommen.

Sie können jeweils bis zu 200 eigene Regeln für Rahmen und Textplatzhalter definieren. Die Regeln werden in actions.xml bzw. der Tabelle actions mit den folgenden ClassIDs definiert:

    ClassID 36 : Rahmenregeln
   ClassID 51 : Regeln für Textplatzhalter

Die so definierten Regeln werden in der Reihenfolge ihrer Sequenznummer sequencenr an die Liste der Standardregeln angefügt. Eine ausführliche Beschreibung der actions-Attribute für Gestaltungsregeln finden Sie hier.

Die Skripte von Gestaltungsregeln können alle Skriptfunktionen verwenden. Beachten Sie aber bitte Folgendes:

• Aufrufe wie document::close können zu Fehlern führen.
• Gestaltungsregeln, die auf Geometrieänderungen reagieren, dürfen keine Dialoge enthalten. Diese Dialoge unterbrechen dadurch, dass sie auf eine Antwort warten, die Geometrieänderung selbst.

Die Skripte sollten mit den folgenden Includes beginnen :

      #include "internal/types.h"
      #include "internal/text.h"

In allen Aufrufen von Gestaltungsregeln ist der aktuelle Rahmen wie üblich mit gFrame definiert. In Regeln, die nach dem Aufbau gerufen werden, ist zusätzlich die Liste gFrames (ItemList) definiert, die alle Rahmen des Aufbaus enthält.

Zusätzlich zu den allgemein gültigen globalen Variablen wie gFrame, gDocument, ... sind eine Reihe weiterer globaler Variablen definiert:

gOrgFrameLeft

float

gOrgFrameTop

gOrgFrameRight

gOrgFrameBottom

float

gParam1
gParam2
gParam3
gParam4

char*

gFrames

ItemList

gWhen

int

gSender

ItemRef

gKey

char*

gSenderData1

char*

gSenderData2

gIsInBuild

int

int

In Textplatzhalterregeln sind außer gParam1-4 alle o.g. Variablen mit den Werten 0/"" definiert.

Im Gegensatz zu allen anderen globalen Variablen dürfen die Inhalte von gParam1-4 im Skript geändert werden. Der String darf dabei aber nicht länger als 5000 Zeichen werden. Änderungen an den Variablen gelten nur innerhalb der ausführenden Regel. Mit Hilfe der Funktion

    frame::change_rule_param

können Parameterwerte von Regeln und Bedingungen auch dauerhaft geändert werden. Die Funktion kann nur die Parameter der gerade ausgeführten Regel oder Bedingung ändern.

Sie haben mit dieser Funktion ein recht mächtiges Werkzeug zum Hinterlegen dynamischer Informationen im Dokument.

Jedesmal, wenn die Regel ausgeführt wird, wird der Parameter 2 der Regel um eins hochgezählt. Der Parameter 2 muss mit einer Zahl initialisiert sein.

int main ()
{
	frame::change_rule_param (2, itoa (val (gParam2)+1));

	return 0;
}

Die Tabelle beschreibt, wie die Regeln konfiguriert werden können. Die eigentliche Implementietung der Regel machen Sie entweder über Ison (PubServer) oder mit ALT-Klick der Regel direkt im InDesign®.

name = Name
     | Submenu^Name
     | Submenu^Submenu^Name
     ...
     | Name,,Shortcut
     | Submenu^Name,,Shortcut
     | Submenu^Submenu^Name,,Shortcut
     ...

Der Name der Gestaltungsregel wird im Attribut name angegeben. Mit einem ^ getrennten Pfad vor dem Namen kann die Regel in Untermenüs des Fly-Out-Menüs der Palette eingeordnet werden. Denken Sie aber daran, dass zu lange Pfade die Benutzerfreundllichkeit eher beeinträchtigen.

Mit den folgenden Pfadangaben können Rahmenregeln in die Untermenüs der Standardregeln für Rahmen eingefügt werden:

• kLayoutRulesFrames^ : Untermenü Rahmen
• kLayoutRulesImages^ : Untermenü Bilder
• kLayoutRulesTexts^ : Untermenü Texte
• kLayoutRulesTables^ : Untermenü Tabellen
• kLayoutRulesMessages^ : Untermenü Nachrichten

Der Name und alle Pfadteile werden mit Hilfe der aktuell verfügbaren Übersetzungen automatisch in die Sprache des verwendeten InDesign® übersetzt.

Mit einer durch ,, (Komma Komma) getrennten Shortcut-Definition können Sie den Menüeintrag mit einer Befehlstasten-Kombination versehen. Informationen zur Definition von Tastaturkombinationen finden Sie hier.

Hier die Definition einer Regel kRemoveFrame, die im Flyout-Menu Rahmen -> A -> B gezeigt werden soll. Mit Shift+Ctrl+Y kann die Regel dem aktuell ausgewählten Rahmen hinzugefügt werden. Für den Schlüssel kRemoveFrame sollte eine Übersetzung definiert werden.

kLayoutRulesFrames^A^B^kRemoveFrame,,Shift+Ctrl+Y

Der Typ einer Regel wird über die ClassID der Aktion bestimmt:

• 36 : Rahmenregel
• 51 : Textplatzhalterregel
• 45 : Bedingungen für Rahmenregeln
• 52 : Bedingungen für Regeln von Textplatzhaltern

Eigene Regeln werden im Flyout der Palette immer hinter den Standardregeln einsortiert. Mit dem Attribut sequencenr der Aktion können Sie dann die weitere Reihenfolge festlegen. Bei fehlenden oder gleichen Sequenznummern ist die Reihenfolge zufällig.

Verhalten  = Default##AllowedFor##Tooltip

Default    = 0 - 47
AllowedFor = 0 - 47

Aktivierung und Beschreibung der Regel werden im Attribut inputdocumentation der Aktion festgelegt. Die Angaben erfolgen in einem dreiteiligen ##-getrennten Text.

Folgende Werte sind den Situationen zur Ausführung einer Regel zugeordnet : 

Icon	Wert	Situation
	2	Laden (Der Rahmen muss dabei keinen Platzhalter haben)
	1	Anlage (aus einem Template)
	32	Produktaufbau
	4	bei Reorganisationen
	8	Geometrieänderungen

Im ersten Teil definieren Sie die Situationen, die bei Neuanlage der Regel automatisch aktiviert werden sollen. Die Angabe ist eine Summe der zu aktivierenden Situationen. So bedeutet 2, dass die Regel nur fürs Laden aktiviert wird, mit 3 wird die Regel für Neuanlage und Laden aktiviert, usw.. Mit 0 oder leer bleiben alle Situationen deaktivert.

Im zweiten Teil legen Sie fest, welche Situationen aktiviert werden können. Die Zahl ist eine Summe der erlaubten Situationen. Mit 0 erlauben Sie nichts, mit 39 (= 32 + 1 + 2 + 4) erlauben Sie alles außer Geometrieänderungen, mit 47 auch Geometrieänderungen. Fehlt die Angabe oder ist leer, werden alle Situationen erlaubt.

Defaults, die nicht in den erlaubten Situationen enthalten sind, werden automatisch erlaubt. Die Angabe 1##0##Hilfetext aktiviert bei Hinzufügen der Regel automatiasch dieNeuanlage. Sollte diese Situation aber an der Regel (etwa zu Testzwecken) abgeschaltet worden sein, kann sie auch wieder aktiviert werden - alle anderen Situationen aber nicht.

Die Regel soll beim Hinzufügen für Neuanlage aktivert sein und darf zusätzlich beim Laden aktiviert werden.

1##2##My_Help

Fehlende oder leere Angaben erzeugen ein leeres Textfeld mit dem Label Unbenutzt. Unabhängig davon können auch diese Felder mit Inhalt versehen und ausgewertet werden. Im Interesse einer guten Benutzerführung sollte Sie diese Situationen aber vermeiden.

Param = Label
      | Label////Tooltip

In der einfachsten Form geben Sie einfach den Parameternamen an. Es wird ein leeres Textfeld mit dem angegebenen Namen angelegt. Beachten Sie aber bitte, dass die Beschriftung nicht zu lang wird!

Optional und durch //// getrennt kann hinter dem Label ein Hilfetext zur Beschreibung des Parameters folgen. Beachten Sie bitte, dass Hilfetexte nur bis zu 255 Zeichen angezeigt werden. Hilfetexte dürfen keine Zeilentrenner enthalten! Sollten Zeilentrenner benötigt werden, müssen diese mit <br> oder <br/> maskiert werden.

Label und Tooltip werden mit Hilfe der aktuell verfügbaren Übersetzungen automatisch in die Sprache des verwendeten InDesign® übersetzt.

Der zweite Parameter erwartet die Angabe einer RGB-Farbe

##Farbe////RGB-Werte der Farbe jeweils im Bereich 0-255, z.B. 255 128 0####

Param = Label^^Default
      | Label^^Default////Tooltip

Der Parameter wird als benanntes Textfeld mit dem Namen Label dargestellt und bei Neuanlage mit dem Wert Default befüllt.

Optional und durch //// getrennt kann am Ende der Definition ein Hilfetext zur Beschreibung des Parameters folgen. Beachten Sie bitte, dass Hilfetexte nur bis zu 255 Zeichen angezeigt werden. Hilfetexte dürfen keine Zeilentrenner enthalten! Sollten Zeilentrenner benötigt werden, müssen diese mit <br> oder <br/> maskiert werden.

Label und Tooltip werden mit Hilfe der aktuell verfügbaren Übersetzungen automatisch in die Sprache des verwendeten InDesign® übersetzt.

Der zweite Parameter erwartet die Angabe einer RGB-Farbe, Schwarz ist der Default

##Farbe^^0 0 0////RGB-Werte der Farbe jeweils im Bereich 0-255, z.B. 255 128 0####

Param = Label
           Entry
           Entry
           ...
      | Label////Tooltip
           Entry
           Entry
           ...

Entry = [!]Label
      | [!]Key//Label

Parameter haben häufig eine definierte Liste unterstützter Werte. Für diese Fälle können die Werte als benannte Dropdowns dargestellt werden. Wie bei den benannten Textfeldern beginnt die Definition mit dem Namen Label des Dropdowns. Optional und durch //// getrennt kann nach dem Namen ein Hilfetext zur Beschreibung des Parameters folgen. Beachten Sie bitte, dass Hilfetexte nur bis zu 255 Zeichen angezeigt werden. Hilfetexte dürfen keine Zeilentrenner enthalten! Sollten Zeilentrenner benötigt werden, müssen diese mit <br> oder <br/> maskiert werden.

Label und Tooltip werden mit Hilfe der aktuell verfügbaren Übersetzungen automatisch in die Sprache des verwendeten InDesign® übersetzt.

Auf Label und Tooltip folgt eine zeilengetrennte beliebig lange Liste der Einträge, die im Dropdown gezeigt werden sollen. Als Zeilentrenner sind die folgenden Zeichen erlaubt:

\n
\n\r
\r
&#xA;
&#xD;

In den Eingabefeldern der Workbench können leider keine Zeilentrenner eingegeben werden, bzw. werden beim Sichern automatisch wieder entfernt. Sie können als Trenner der einzelnen Werte von Popupmenüs daher auch die Zeichenfolge :I: (Doppelpunkt, großes i, Doppelpunkt) verwenden.

Untermenüs in Dropdowns werden von InDesign® leider nicht unterstützt - Sie können hier also nur flache Droddowns anlegen.

In der einfachen Schreibweise geben Sie hier den Text an, der im Eintrag gezeigt werden soll. Nur die Whitespaces am Anfang und Ende werden entfernt. Der Text wird nicht übersetzt und so, wie er im Dropdown steht, auch ins Dokument übernommen werden. Angaben in dieser Schreibweise sind in den folgenden Fällen nützlich:

• Maßeinheiten wie pt, pica, mm, ...
• Allgemein gültige Kürzel wie x, y, internationale Marken, ...
• Namen (z.B. Absatzstile, Firmen, Dateien, ...)

Enthält der Listeneintrag einen sprachabhängigen Wert, empfehlen wir die etwas längere, aber deutlich hilfreichere Schreibweise Key//Label!

Für sprachabhängige Listeneinträge sollten Sie die etwas längere Schreibweise Key//Label verwenden. Whitespaces am Anfang und Ende werden vor der Verwendung entfernt.

Im Dropdown wird die Übersetzung von Label in die aktuelle InDesign®-Sprache eingetragen (vorausgesetzt natürlich, dass Sie diese Übersetzung definiert haben, was Sie mit der Palette Plug-ins -> Comet Admin -> Übersetzungen (Zusatzmodule statt Plug-ins in Versionen vor InDesign® 2025) aber leicht machen können.). Wird der Eintrag jedoch im Dropdown ausgewählt, wird nicht Label sondern Key ins Dokument übernommen. Ihre Gestaltungsregel muß also unabhängig von der verwendeten InDesign®-Sprache auch nur diesen Schlüssel auswerten. Damit haben Sie eine benutzerfreundliche Darstellung und sind trotzdem unabhängig von der InDesign®-Sprache.

Hinweis : Es ist durchaus erlaubt und sinnvoll, für Key und Label den gleichen Begriff zu verwenden. Aber auch dann gilt natürlich : Key ist der Wert, der (unverändert) ins Dokument übernommen wird und der im Skript der Gestaltungsregel verwendet wird. Und Label wird durch die Übersetzung geschickt und in der Anzeige der Palette verwendet.

Trenner im DropDown werden mit einem - (Minus) erzeugt. Trenner können nicht ausgewählt werden, werden also auch nie als Parameterwert übernommen werden.

Der Default-Eintrag des Dropdows, mit dem der Parameter beim Hinzufügen der Regel belegt wird, wird mit einem ! (Ausrufezeichen) am Anfang der Definition des Eintrages gekennzeichnet. Ist kein Default definiert, wird der erste Eintrag der Liste als Default verwendet. Sind mehrere Einträge mit einem ! markiert, wird der letzte gefundene Eintrag verwendet.

Eine Gestaltungsregel zum Anpassen von Rahmengrößen könnte etwa folgende Parameter haben: 

1. Eine Key//Label-Liste, welche Dimension verändert werden soll.
2. Ein benanntes Textfeld, um welchen Wert geändert werden soll.
3. Eine Werteliste ohne Übersetzung mit den unterstützten Einheiten für die Größenangabe.
4. Eine Key//Label-Liste, ob (wenn möglich) die Rahmenproportionen erhalten bleiben sollen.

Bei den allfälligen Übersetzungen können Sie zum Teil auf Standard-Übersetzungen zurückgreifen (im Text blau markiert), siehe hier. Für die rot hervorgehobenen Schlüssel müssen noch Übersetzungen angelegt werden. Dazu können Sie z.B. die Palette Plug-ins -> Comet Admin -> Übersetzungen (Zusatzmodule statt Plug-ins in Versionen vor InDesign® 2025) verwenden.

<outputdocumentation>k_DIRECTION////My_Rule1_Help
    h//k_WIDTH
    w//k_HEIGHT
    b//My_Both
  ##My_Value////My_Value_Help##My_Unit////My_Unit_Help
    mm
    !pt
    %
  ##k_PROPORTIONAL////My_Prop_Help
    y//k_YES
    n//k_NO
</outputdocumentation>

Die Einträge der Popupmenüs können auch dynamisch geladen werden, wenn der jeweilige Dokument-Rahmen in der Palette Gestaltungsregeln gezeigt wird. Die Einträge der Popupmenüs können dabei über Standardfunktionen (z.B. alle verfügbaren Objektstile) geladen werden. Erfüllt keine der Standardfunktionen Ihre Wünsche, können Sie auch selbst ein Skript schreiben und das Popup damit füllen.

In der Werteliste des Parameters geben Sie dazu anstelle einzelner Werte das Schlüsselwort @LOADLIST gefolgt von der Funktion oder der ID Ihrer definierten Aktion an :

     @LOADLIST Standardfunktion | ActionID [Defaulteintrag]

Das Popup enthält als Standard immer den Wert "Leer". Zwischen diesem Eintrag und den dynamischen Werten wird ein Trenner eingefügt. Es kann nur ein @LOADLIST-Eintrag pro Parameter angegeben werden.

Der zweite Parameter einer Gestaltungsregel kann als Wert eine existierenden Objektstile bekommen. Wurde noch kein Wert ausgewählt, wird Objektformat 1 als Standard ausgewählt.

<outputdocumentation>Variable Werte
    links
    !mitte
    rechts
  ##Stil
    @LOADLIST objstyles "Objektformat 1"
  ##[unbenutzt]
  ...

Die folgenden Standardlisten sind definiert. Sie werden einfach über ihren Namen (case sensitv) angesprochen. Nach dem Funktionsnamen kann eine Zahl oder ein String zur Definition des Defaulteintrages folgen.

In dieser Regel werden alle Parameter dynamisch geladen:

<outputdocumentation>Schrift
    @LOADLIST fonts "Courier New"
  ##Absatzstil
    @LOADLIST parastyles 2
  ##Zeichenstil
    @LOADLIST charstyles
  ##Tabellenstil
    @LOADLIST tablestyles 3
<outputdocumentation>

Zusätzlich zu den o.g. Standardlisten können auch eigene Listen für Parameter implementiert werden. Diese Skripte müssen die ClassID 44 haben. Sie werden jedesmal ausgeführt, wenn ein Rahmen in der Palette Gestaltungsregeln ausgewählt wird. Im Skript muss jeweils die hier definierte globale StringList gValues gefüllt werden. Folgende globale Variablen sind neben den allgemeinen globalen Variablen und gFrame definiert :

In dieser Regel werden die Werte für den ersten Parameter mit Hilfe der Aktion 20014 geladen:

<outputdocumentation>Werteliste
    @LOADLIST 20014
  ##Unbenutzt##Unbenutzt##Unbenutzt
<outputdocumentation>

Das ist ein gültiges Skript zum Laden einer dynamischen Werteliste:

int main ()
{
	stringlist::append (gValues, "aaa");		// index 2
	stringlist::append (gValues, "bbb");		// index 3
	stringlist::append (gValues, "ccc");		// index 4
	stringlist::append (gValues, "-");
	stringlist::append (gValues, "111");
	stringlist::append (gValues, "222");
	stringlist::append (gValues, "333");

	*gDefaultEntry = 4;

	return 0;
}

Ebenso wie eigene Regeln können auch eigene Bedingungen implementiert werden. Die Bedingungen werden ebenfalls in actions.xml bzw der Tabelle actions mit den folgenden ClassIDs definiert:

    ClassID 45 : Bedingungen für Rahmenregeln
    ClassID 52 : Bedingungen für Regeln von Textplatzhaltern

Es sind jeweils biz zu 200 eigene Bedingungen erlaubt.

Ob eine Bedingung erfüllt ist oder nicht, wird über den return-Wert der main-Funktion des Skriptes angegeben :

Bedingungen für Textplatzhalter, die die Variable gNewValue nicht enthalten, werden bei Aufrufen des Aufgabenmanagements ignoriert und als Ablehnung (FALSE) betrachtet. Hier erfahren Sie mehr darüber, wie Sie gNewValue verwenden, damit das Aufgabenmanagement Ihre Platzhalter richtig auswerten kann.

Die Bedingung ist erfüllt, wenn im Parameter 1 der IF-Anweisung eine Zahl ungleich 0 steht. Ist der Parameter 1 gleich 0 (oder ein String) ist die Bedingung nicht erfüllt.

int main ()
{
	return val (gParam1);
}

Bedingungen verfügen über die gleichen Umgebungsvariablen wie die Regeln, siehe hier.

Die Konfiguration inklusive der Parameterlisten für Bedingungs-Parameter und ihre Beschreibung wird auf die gleiche Weise wie in den Regeln gemacht, siehe hier. Die Angaben zur Ausführung der Bedingung in inputdocumentation müssen angegeben werden, werden aber ignoriert.

Gestaltungsregeln werden im jeweiligen Rahmen- oder Textplatzhalter abgelegt. Das geschieht automatisch beim Bearbeiten der Gestaltungsregeln mit Hilfe der Palette Gestaltungsregeln. Mit Hilfe Befehle placeholder::sget_value und placeholder::change_tags können die Regeln aber auch über cScript bearbeitet werden. Verwenden Sie dazu den Slot-Namen "LayoutRules".

Regeln und Bedingungen werden gleich formatiert jeweils im Format

int₁ int₂ 'param₁'\t'param₂'\t'param₃'\t'param₄'

Mehrere Regeln/Bedingungen werden durch Leerzeichen getrennt. Die folgende Tabelle beschreibt die Formatierung einer Regel/Bedingung:

Hier der String für die im Bild gezeigten Regeln. Zur besseren Lesbarkeit sind die einzelnen Regeln zeilengetrennt.

-2 10 'ja' 'nein' '' ''
-3 10 'links' 'oben' '' ''
-3 -14 'Datei' '' '' ''
-18 10 't1' '' '' ''
-4 6 '' '' 'nein' ''
0 -2147483647 '' '' '' ''

Mit frame::apply_layout_rules und itemlist::apply_layout_rules können die Gestaltungsregeln anderer Rahmen schon seit v3.1 R1550 (Sept. 2009 ausgeführt werden. Das hat zwei Nachteile : Man kann nur alle Regeln der Zielrahmen ausführen - Auswahlen von Rahmen gehen nicht. Und zweitens : Man muss die Regeln selber schreiben.

Mit den sog. Ereignissen können gezielt Regeln anderer Rahmen der gleichen Cometgruppe ausgeführt werden. Zwei Schritte sind dafür nötig :

1. Der Rahmen muss die Regel "Ereignis senden" feuern
2. Im Zielrahmen muss eine Bedingung "Ereignis ausführen" definiert sein, die die gewünschten Regeln enthält.

Der Sender gibt dabei an, welcher Rahmen der Cometgruppe (identifiziert über dessen Kennung) gemeint ist und liefert einen Schlüssel (irgendein beliebiger Text). Der Empfänger prüft den Schlüssel und führt dann alle Regeln aus, die zur Bedingung gehören. Es ist erlaubt, an dieser Stelle wieder ein Ereignis (auch mit dem gleichen Schlüssel und an den aufrufenden Rahmen) zu senden - es muss aber sichergestellt sein, dass irgendeine Art von Abbruchbedingung definiert ist (z.B. eine Prüfung auf Textübersatz).

Damit der Empfänger die Regeln ausführen kann, müssen die Regeln in Sender und Empfänger für die gleichen Ausführungssituationen freigegeben sein.

Die Rahmen mit den Kennungen A und B gehören zur selben Comet-Gruppe :

A feuert nach jeder Positionsänderung ein "Send Event" mit dem Schlüssel Key 1 an den Rahmen B :

In B prüft "Ereignis ausführen", ob der Schlüssel stimmt und führt dann die Regel "Rahmen anpassen" aus.

Wird A jetzt um einen Pixel verschoben, wird die Größe von B angepasst.

[Seit v5.0 R37020] Beim Verlinken eines Fortsetzungsrahmens mit dem Textrahmen gleicher Kennung im Vorgänger-Template werden die 'OnUpdate'-Regeln des neu verlinkten Rahmen mit folgenden Sonderbedingungen ausgeführt:

1. Es werden ausschließlich eigene Regeln ausgeführt. Alle Standardregeln werden ignoriert!
2. Der Rahmen gFrame ist der neu zur Textkette hinzugefügte Rahmen der Fortsetzung.
3. Die Regeln müssen mit folgendem #pragma markiert sein:

   #pragma LinkContinuation

4. Beim 'normalen' Update, also wenn der Inhalt des ersten Rahmens (im Haupttemplate) geladen wird, werden diese Regeln ignoriert.
5. In allen anderen Zusammenhängen werden mit #pragma LinkContinuation markierte Skripte wie 'normale' Skripte ausgeführt.