Verwenden einer Steuerelementvorlage: Platzhaltersteuerelemente
Nachdem Sie eine Steuerelementvorlage erstellt haben, können Sie diese in Komponenten vom Typ "Seite" an einer oder mehreren Stellen verwenden: (i) auf Toplevel-Seiten, (ii) auf Unterseiten, (iii) in Steuerelementvorlagen.
Um eine Steuerelementvorlage auf einer Seite oder in einer Steuerelementvorlage zu verwenden, gehen Sie folgendermaßen vor:
1.Ziehen Sie ein Platzhaltersteuerelement entweder direkt auf die Seite oder in ein passendes Steuerelement wie z.B. ein Tabellensteuerelement.
2.Wählen Sie für die Eigenschaft Steuerelementvorlage des Platzhaltersteuerelements die Steuerelementvorlage, die an dieser Stelle instanziiert werden soll, aus.
3.Konfigurieren Sie die anderen Einstellungen des Platzhaltersteuerelements im Fenster Stile & Eigenschaften nach Bedarf.
Besonders nützlich ist es, wenn Sie ein Platzhaltersteuerelement, über das eine Steuerelementvorlage aufgerufen wird, in eine Tabelle mit sich wiederholenden Elementen einfügen, da die Vorlage dadurch auf die einzelnen sich wiederholenden Elemente der Tabelle angewendet werden kann. So haben wir etwa im Beispiel in der Abbildung unten eine Tabelle mit sich wiederholenden Zeilen erstellt, wobei jeder dieser Zeilen einem Land in einer XML-Datengruppe, die mehrere gleichrangige Country-Elemente enthält, entspricht. Anschließend haben wir ein Platzhaltersteuerelement in die sich wiederholende Zeile der Tabelle gezogen und in ihrer Eigenschaft Steuerelementvorlage die Vorlage DataWithParams ausgewählt.
Wie Sie in der Abbildung sehen, hat die Steuerelementvorlage sieben Zellen für sieben verschiedene "Country"-Eigenschaften. Im aktuellen Platzhalter wurden drei der Eigenschaften instanziiert. In einem anderen Platzhalter könnte eine andere Gruppe von Eigenschaften instanziiert werden, wodurch dieselbe Steuerelementvorlage an verschiedenen Stellen aufgerufen werden könnte, um unterschiedliche Gruppen von Daten zu generieren.
Weitere Anwendungsbeispiele finden Sie auch unter Beispielprojekte.
Konfigurieren des Platzhaltersteuerelements
Konfigurieren Sie ein Platzhaltersteuerelement folgendermaßen:
1.Nachdem Sie das Platzhaltersteuerelement in das Design gezogen haben, wählen Sie es im Design aus.
2.Gehen Sie zum Fenster "Stile & Eigenschaften" und stellen Sie sicher, dass für die Eigenschaft Steuerelementvorlage des Platzhaltersteuerelements der Name der gewünschten Steuerelementvorlage ausgewählt wurde. (In der Abbildung oben wurde als Steuerelementvorlage DataWithParams ausgewählt; sie wurde aus einer Dropdown-Liste, die alle Steuerelementvorlagen im Design enthält, ausgewählt.) 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.
3.Nach Auswahl der Steuerelementvorlage werden ihre Parameter als untergeordnete Eigenschaften der Vorlage angezeigt (siehe Abbildung unten). Geben Sie Werte für diese Parameter in Form von XPath-Ausdrücken ein. Für alle obligatorischen Parameter (diejenigen, die nicht als optional definiert wurden) müssen Werte definiert werden. Der Kontext-Node für die Auswertung von XPath-Ausdrücken von Parameterwerten ist der Kontext-Node des Platzhaltersteuerelements. Dieser Kontext für Parameter wird durch die Eigenschaft Steuerelement-XPath-Kontext (siehe unten) nicht geändert.
Wenn Sie eine Steuerelementvorlage mit Hilfe eines XPath-Ausdrucks (anstatt durch Auswahl eines Namens in der Auswahlliste der Eigenschaft) 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 (siehe Abbildung unten). 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. (Im Fall von Zuordnungen werden die Werte anhand der Schlüssel korrekt zugewiesen). Ein Beispiel für einen solchen Ausdruck finden Sie in den Beispielprojekten.
4.Der Kontext-Node aller XPath-Ausdrücke in einer Steuerelementvorlage ist standardmäßig der Kontext-Node des Platzhaltersteuerelements, das die Steuerelementvorlage instanziiert (oder aufruft). Sie können den an die Steuerelementvorlage übergebenen Kontext-Node ändern, indem Sie als Wert der Eigenschaft Steuerelement-XPath-Kontext einen neuen Kontext-Node eingeben (siehe Abbildung oben). Anhand des neuen Kontext-Nodes werden XPath-Ausdrücke innerhalb der Vorlage, darunter auch Ausdrücke zur Definition der Werte von Vorlagenvariablen, ausgewertet.