Platzhaltersteuerelement
Mit Hilfe eines Platzhaltersteuerelements können Sie zu einer Seite sowie zu einer Steuerelementvorlage selbst eine Steuerelementvorlage hinzufügen. Nähere Informationen zur Funktionsweise von Steuerelementvorlagen und Platzhaltersteuerelementen finden Sie im Abschnitt Steuerelementvorlagen.
•Um einen Stil oder eine Eigenschaft (im Fenster "Stile & Eigenschaften") zurückzusetzen, wählen Sie die Eigenschaft aus und klicken Sie in der Symbolleiste des Fensters auf Zurücksetzen. •Um den XPath-Ausdruck eines Stils oder einer Eigenschaft zu bearbeiten, wählen Sie den Stil bzw. die Eigenschaft (im Fenster "Stile & Eigenschaften") aus und klicken Sie in der Symbolleiste des Fensters auf XPath bearbeiten. •Um ein Steuerelement an eine andere Stelle im Design zu kopieren, halten Sie die Strg-Taste gedrückt, während Sie das Steuerelement an die gewünschte Stelle ziehen. |
Platzhaltersteuerelement-Ereignisse
Mit dem Platzhaltersteuerelement ist kein Ereignis verknüpft.
Platzhaltersteuerelement-Eigenschaften
Die Eigenschaften eines Steuerelements stehen im Fenster "Stile & Eigenschaften" zur Verfügung und werden unten in der Reihenfolge, in der sie angezeigt werden, aufgelistet.
Über seinen Namen wird das Steuerelement von anderen Stellen auf der Seite oder im Projekt aus referenziert. Doppelklicken Sie in das Wertefeld, um es zu bearbeiten.
|
Klicken Sie auf die Schaltfläche Zusätzliches Dialogfeld, um das Dialogfeld "Aktionen" für das Steuerelement aufzurufen. Sie können definieren, welche Aktionen bei Auslösen eines Steuerelementereignisses ausgelöst werden. Das/Die Ereignis(se) des Steuerelements ist/sind vordefiniert und wird/werden auf der rechten Seite des Dialogfelds "Aktionen" auf eigenen Registern angezeigt. Im linken Bereich des Fensters wird eine Aktionsbibliothek angezeigt. Sie können eine Aktion aus dem Fenster auf der linken Seite auf das Register eines Ereignisses ziehen und anschließend die Eigenschaften der Aktion definieren. Es können für jedes Ereignis mehrere Aktionen definiert werden, die in der Reihenfolge, in der sie von oben nach unten vorkommen, ausgeführt werden.
Nachdem Sie die Aktionen eines Steuerelements definiert haben, können Sie diese jederzeit über die Schaltfläche Zusätzliches Dialogfeld der Eigenschaft aufrufen und bearbeiten. Alternativ dazu können Sie ein Steuerelementereignis auch durch Rechtsklick auf das Steuerelement und Auswahl des Ereignisses aus dem angezeigten Kontextmenü aufrufen.
|
Ein XPath-Ausdruck, dessen Ergebnis true() oder false() sein sollte. Wenn das Ergebnis des Ausdrucks false() ist, - und nur dann - ist das Steuerelement nicht sichtbar. Ist das Ergebnis des Ausdrucks true() oder wird ein anderer Wert zurückgegeben, so bleibt das Steuerelement sichtbar. Der Standardwert ist true(). Doppelklicken Sie in das Wertfeld oder klicken Sie auf die Schaltfläche XPath, um einen XPath-Ausdruck zu bearbeiten. Mit Hilfe der Eigenschaft Sichtbar kann ein Objekt sichtbar oder unsichtbar gemacht werden, je nachdem, welches Ergebnis der XPath-Ausdruck hat. Dadurch kann die Anzeige eines Objektsd dynamisch vom Inhalt oder der Struktur von Daten abhängig gemacht werden.
Anmerkung: Informationen zur Sichtbarkeit von Spalten-/Zeilenbereichen finden Sie unter Tabelleneigenschaften.
Anmerkung: Die Variable $MTControlValue steht für die Generierung des Werts der Eigenschaft Sichtbar nicht zur Verfügung. Falls sie verwendet wird, führt dies zu einem Validierungsfehler.
|
Dient zur Auswahl der Steuerelementvorlage, die dieses Platzhaltersteuerelement instanziiert. In der Dropdown-Liste des Wertefelds der Eigenschaft werden alle bisher im Design definierten Steuerelementvorlagen angezeigt. Alternativ dazu können Sie eine Steuerelementvorlage auch mit Hilfe eines XPath-Ausdrucks auswählen. Das Ergebnis eines solchen XPath-Ausdrucks muss der Name einer Steuerelementvorlage im Design sein. Mit Hilfe von XPath-Ausdrücken können Vorlagen auf Basis von Bedingungen ausgewählt werden. Eine Anleitung dazu finden Sie in den Beispielprojekten. Bei Auswahl einer Steuerelementvorlage werden ihre Parameter als untergeordnete Eigenschaften der Eigenschaft Steuerelementvorlage angezeigt (siehe Abbildung unten). Durch Eingabe von XPath-Ausdrücken können Sie die Werte der Parameter auswählen oder generieren. Als Kontext-Node des Ausdrucks wird der Kontext-Node des Platzhaltersteuerelements zum Zeitpunkt der Verarbeitung des Steuerelements verwendet. Der Kontext-Node für die Auswertung der Parameter und Variablen wird durch die Eigenschaft Steuerelement-XPath-Kontext (siehe unten) nicht geändert.
Wenn Sie eine Steuerelementvorlage mit Hilfe eines XPath-Ausdrucks auswählen, wird die Steuerelementvorlage erst zur Laufzeit zum Zeitpunkt der Auswertung des Ausdrucks ausgewählt. Da die Steuerelementvorlage zum Zeitpunkt der Designerstellung nicht bekannt ist, können im Fenster keine Parameter angezeigt werden. Anstelle einer Liste von Parametern steht eine Eigenschaft mit dem Namen "Vorlagenparameter" zur Verfügung. Sie können zur Generierung der Werte der erwarteten Parameter einen XPath-Ausdruck eingeben. Dabei muss es sich entweder um einen Array- oder einen Zuordnungsausdruck handeln. Wenn Sie einen Array-Ausdruck verwenden, müssen die Parameterwerte in derselben Reihenfolge wie die Parameterdefinition in der Steuerelementvorlage angegeben werden; außerdem dürfen etwaige optionale Parameter nicht weggelassen werden. Ein Beispiel für einen solchen Ausdruck finden Sie in den Beispielprojekten.
|
Über die Eigenschaft Vorlagenparameter werden die Parameterwerte für die in der Eigenschaft Steuerelementvorlage des Platzhaltersteuerelements ausgewählte Steuerelementvorlage bereitgestellt.
Sie können für die Eigenschaft Vorlagenparameter zur Generierung der Werte der erwarteten Parameter einen XPath-Ausdruck eingeben. Bei diesem XPath-Ausdruck muss es sich entweder um einen Array- oder einen Zuordnungsausdruck handeln. Wenn Sie einen Array-Ausdruck verwenden, müssen die Parameterwerte in derselben Reihenfolge wie die Parameterdefinition in der Steuerelementvorlage angegeben werden; außerdem dürfen etwaige optionale Parameter nicht weggelassen werden. (Im Fall von Zuordnungen werden die Werte der Zuordnung anhand der Schlüssel korrekt zugewiesen). Ein Beispiel für einen solchen Ausdruck finden Sie in den Beispielprojekten zu Vorlagenparametern.
|
Mit Hilfe dieser Eigenschaft können Sie den Kontext-Node von XPath-Ausdrücken ändern, die in der Steuerelementvorlage, die das Platzhaltersteuerelement instanziiert, ausgewertet werden. Die instanziierte Steuerelementvorlage ist die in der Eigenschaft Steuerelementvorlage (siehe oben) genannte Vorlage.
Beachten Sie die folgenden Punkte:
•XPath-Ausdrücke für die Werte von Vorlagenparametern werden im Kontext des Kontext-Node des Platzhaltersteuerelements und nicht dem des geänderten Kontext-Node ausgewertet. •XPath-Ausdrücke hingegen, mit denen die Werte von Vorlagenvariablen generiert werden, werden in dem durch diese Eigenschaft definierten Kontext (Steuerelement-XPath-Kontext) ausgewertet. Wenn für diese Eigenschaft kein Wert definiert ist, werden auch Variablenwerte anhand des Kontext-Node des Platzhaltersteuerelements ausgewertet.
|