Auswahlliste

www.altova.com Alle erweitern/reduzieren Dieses Kapitel drucken Vorherige Seite Eine Ebene nach oben Nächste Seite

Startseite >  Steuerelemente und Steuerelementereignisse > Steuerelemente >

Auswahlliste

Das Steuerelement "Auswahlliste" stellt einen aus zwei Teilen bestehenden Mechanismus zur Verfügung:

 

Text von Einträgen und XML-Werten: Der Text von Auswahllisteneinträgen (die Dropdown-Liste, die der Endbenutzer sieht) und die dazugehörigen Werte (die im Seitenquellen-Node übernommen werden) werden über die Eigenschaft Eingabewerte der Auswahlliste definiert (nähere Informationen siehe weiter unten).
Verknüpfter XML-Node. Um eine Verknüpfung mit einem Node zu erstellen, wird aus dem Fenster "Seitenquellen" ein Node auf die Auswahlliste gezogen. Dies ist der verknüpfte Node (oder Seitenquellen-Link), der den vom Endbenutzer gewählten Auswahllistenwert erhält. Um den von Endbenutzer ausgewählten Wert an einer anderen Stelle der Seite zu verwenden, wird der Inhalt des Node entweder durch Ziehen des Node auf Steuerelemente oder durch Auswahl des Node in XPath-Ausdrücken referenziert.

 

Normalerweise kann der Benutzer über eine Auswahlliste eine Option aus einer Gruppe von Optionen auswählen. Wenn Sie dem Benutzer die Möglichkeit geben möchten, mehrere Optionen auszuwählen, setzen Sie die Eigenschaft Mehrfachauswahl auf true. Nähere Informationen dazu finden Sie unter der Beschreibung dieser Eigenschaft weiter unten.

 

Click to expand/collapseAnmerkungen
Wenn das Steuerelement mit einem Seitenquellen-Node (Seitenquellen-Link) verknüpft ist, wird der damit verknüpfte Node bei Platzieren der Maus über das Steuerelement (in der Seitendesign-Ansicht) in einem Popup-Fenster angezeigt.
Alle Seitenquellen-Links in der Datenquellstruktur werden in fetter Schrift angezeigt. Strukturnodes, die keine Seitenquellen-Links sind, werden in normaler Schrift angzeigt.
Wenn Sie den Mauszeiger in der Design-Struktur über den Seitenquellen-Link platzieren, werden Informationen zum damit verknüpften Steuerelement angezeigt.
Um eine Verknüpfung mit einem Seitenquellen-Node (und damit die Daten im Steuerelement) zu entfernen, klicken Sie mit der rechten Maustaste (in der Seitendesign-Ansicht) auf das Steuerelement und wählen Sie den Befehl Link zur Seitenquelle löschen.
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.
Die Werte einer Reihe von Eigenschaften können mit Hilfe von XPath-Ausdrücken definiert werden. Auf diese Art können dynamische Werte, d.h. mittels Berechnungen generierte Werte oder Werte, die zur Laufzeit aus Nodes der Seitenquelle abgerufen werden, verwendet werden. Um einen XPath-Ausdruck zu definieren, klicken Sie in der Symbolleiste des Fensters "Stile & Eigenschaften" auf die Schaltfläche XPath bearbeiten.
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.
Um einem Steuerelement bestimmte Eigenschaften zuzuweisen, definieren Sie (über die Eigenschaft Browser-CSS-Klasse) eine oder mehrere Klassen für das Steuerelement und weisen Sie der/den Klasse(n) anschließend in einer externen CSS-Datei (die Sie im Dialogfeld "Browser-Einstellungen" definieren) Regeln zu.
Die CSS-Eigenschaften eines Steuerelements können im Fenster "Stile & Eigenschaften" und/oder in einer externen CSS-Datei definiert werden. Die Eigenschaften, die im Fenster "Stile & Eigenschaften" definiert wurden, haben Vorrang.

 

Auswahllistenereignisse

Es steht das Ereignis "BeimBeendenDerBearbeitung" zur Verfügung. Eine Beschreibung der Aktionen, die für dieses Ereignis definiert werden können, finden Sie im Abschnitt Aktionen.

 

Auswahllisteneigenschaften

Die Eigenschaften eines Steuerelements stehen im Fenster "Stile & Eigenschaften" zur Verfügung und werden unten in der Reihenfolge, in der sie angezeigt werden, aufgelistet.

 

Click to expand/collapseName

Ü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.

 

Click to expand/collapseMehrzeilig

Aktiviert bzw. deaktiviert  (true/false) die Anzeige mehrzeiliger Eingaben. Die Standardeinstellung ist false.

 

Anmerkung

Wenn diese Eigenschaft auf true gesetzt ist und die Eigenschaft Textgröße automatisch anpassen aktiviert wurde, wird der Text nicht auf mehrere Zeilen umbrochen; Zeilenumbruchszeichen im Text würden jedoch einen Zeilenumbruch verursachen.
Wenn diese Eigenschaft für ein Beschriftungssteuerelement auf true gesetzt ist, steht die Eigenschaft Maximale Zeilenanzahl zur Verfügung.

 

 

Click to expand/collapseEingabewerte der Auswahlliste

Stellt die XML-Datenwerte für die Elemente der Dropdown-Liste der Auswahlliste bereit. Klicken Sie auf die Schaltfläche Zusätzliches Dialogfeld, um das Dialogfeld "Auswahlliste bearbeiten" (Abbildung unten) aufzurufen. Alternativ dazu können Sie auf die Auswahlliste doppelklicken, um das Dialogfeld "Auswahlliste bearbeiten" aufzurufen.

 

Click to expand/collapse

 

Um die Einträge und Werte für die Auswahlliste zu definieren, gehen Sie folgendermaßen vor:

 

1.Wählen Sie die Methode, mit der Sie die Einträge und Werte definieren möchten durch Auswahl des entsprechenden Optionsfelds aus: (i) Werteliste verwenden oder (ii) XPath-Ausdruck verwenden. Eine Anleitung zur Verwendung dieser Methoden finden Sie weiter unten.
2.Wenn die in der Dropdown-Liste der Auswahlliste angezeigten Einträge sortiert werden sollen, aktivieren Sie das Kontrollkästchen Werte sortieren.

3.   Klicken Sie auf OK, wenn Sie fertig sind.

 

Verwendung einer Liste von Werten

Wenn Sie die Option Werteliste verwenden auswählen, können Sie jeden Eintrag der Dropdown-Liste der Auswahlliste als Textstring definieren. Sie können den Textstring sowohl (i) für den Text des Eintrags in der Dropdown-Liste als auch als (ii) XML-Datenwert des Eintrags verwenden. Alternativ dazu können Sie unterschiedliche Textstrings für den Eintrag der Dropdown-Liste und den dazugehörigen XML-Datenwert definieren. Fügen Sie für jeden Eintrag eine neue Zeile hinzu und geben Sie den/die gewünschten Textstring(s) ein.

 

Verwendung von XPath-Ausdrücken

Wenn Sie die Option XPath-Ausdruck verwenden auswählen, können Sie die Einträge der Dropdown-Liste und die dazugehörigen XML-Datenwerte mit Hilfe von XPath-Ausdrücken definieren. Es gibt zwei Methoden, um dies zu definieren:

 

Verwendung eines einzigen XPath-Ausdrucks zur Definition sowohl des sichtbaren Texts (des Eintrags in der Dropdown-Liste) als auch der dazugehörigen XML-Datenwerte. Das Ergebnis des XPath-Ausdrucks muss entweder (i) eine Sequenz von Strings sein, wobei jeder String sowohl den Wert des sichtbaren Auswahllisteneintrags als auch den XML-Datenwert dieses Eintrags bildet (Beispiel: ("Eins", "Zwei", "Drei") oder (ii) eine Sequenz von aus zwei Mitgliedern bestehenden Arrays, wobei das erste Mitglied der XML-Datenwert und das zweite der sichtbare Eintrag ist (Beispiel: ["Eins", "1"], ["Zwei", "2"], ["Drei", "3"].
Verwendung zweier unterschiedlicher XPath-Ausdrücke zur Generierung (i) der Sequenz von Strings, die die XML-Datenwerte bilden, und (ii) der Sequenz von Strings, die die sichtbaren Einträge der Auswahlliste bilden. Ein 1:1-Index-Mapping zwischen den Einträgen der beiden Sequenzen definiert die Entsprechung des sichtbaren Eintrags und des XML-Werts. So werden etwa der jeweils erste Eintrag der Sequenz, der jeweils zweite Eintrag der Sequenz, usw. einander zugeordnet.

 

Anmerkung: Mit Hilfe von XPath-Ausdrücken können Sie Einträge und XML-Datenwerte dynamisch generieren. So wird z.B. mit dem Ausdruck distinct-values(region), "Alle" eine Sequenz generiert, deren Einträge die verschiedenen Werte des Elements region plus ein abschließendes Element Alle bilden.

 

Anmerkung: Wenn die Einträge in der Dropdown-Liste aus einer Seitenquelle stammen, werden sie standardmäßig in der Reihenfolge angezeigt, in der sie im Dokument vorkommen.

 

Click to expand/collapseWert aus XPath abrufen

Der vom XPath-Ausdruck zurückgegebene Wert wird im Steuerelement angezeigt. Dadurch können Anzeigewerte für bestimmte Steuerelemente auf eine andere Art eingegeben werden. So könnte z.B. der Anzeigewert für eine Auswahlliste entweder aus einem Seitenquellen-Node abgerufen werden oder es kann der Rückgabewert der Eigenschaft Wert aus XPath abrufen verwendet werden.

 

Anmerkung:  Die Variable $MTControlValue steht für die Generierung des Werts der Eigenschaft Wert aus XPath abrufen nicht zur Verfügung. Falls sie verwendet wird, führt dies zu einem Validierungsfehler.

 

Click to expand/collapseWert automatisch korrigieren

Mögliche Werte sind true oder false. Bei true wird der Wert im damit verknüpften Seitenquellen-Node in den ersten XML-Wert aus der nicht sortierten Liste der Auswahllistenwerte geändert. Der Standardwert der Eigenschaft ist false.

 

Wenn der Seitenquellen-Node über einen anderen Mechanismus als das Steuerelement aktualisiert würde, z.B. mit Hilfe einer Node aktualisieren-Aktion,  könnte er eventuell einen ungültigen Wert enthalten. Mit Hilfe der Eigenschaft Wert automatisch korrigieren stellen Sie sicher, dass kein nicht definierter Wert akzeptiert wird. Die automatische Korrektur erfolgt sofort, wenn der nicht definierte Wert gefunden wird, z.B. beim Öffnen der Lösung oder wenn der falsche Wert eingegeben wird.

 

Click to expand/collapseMehrfachauswahl

Legt fest, ob über die Auswahlliste mehrere Werte ausgewählt werden können oder nicht (true/false). Die Standardeinstellung ist false.

 

Normalerweise stehen in einer Auswahlliste mehrere Optionen zur Verfügung, von denen nur eine ausgewählt werden kann. Der Wert für die ausgewählte Option wird in einer MobileTogether-Lösung in einen Seitenquellen-Node geschrieben.

 

Wenn die Eigenschaft Mehrfachauswahl auf true gesetzt wurde, kann der Benutzer mehr als eine Option auswählen. Die Werte für die einzelnen ausgewählten Optionen werden zu einem einzigen String  verkettet und in den damit verknüpften Seitenquellen-Node eingegeben. Bei der Konstruktion des String werden die ausgewählten Werte durch ein Trennzeichen voneinander getrennt, das Sie in der Eigenschaft Trennzeichen Mehrfachauswahl (siehe unten) definieren. Beachten Sie, dass die Auswahllistenwerte selbst kein Trennzeichen enthalten dürfen.

 

In der Abbildung unten werden die Werte für die ausgewählten Optionen zu einem einzigen (durch Kommata getrennten) String verkettet und in den Attribut-Node weekDay (markiert) geschrieben. Das Trennzeichen für den String, der in die Seitenquelle eingegeben wird, wird über die Eigenschaft Trennzeichen Mehrfachauswahl (siehe unten) definiert, während das Trennzeichen für den String, der in der Auswahlliste selbst angezeigt wird, über die Eigenschaft Sichtbares Trennzeichen Mehrfachauswahl definiert wird.

 

Click to expand/collapse

 

Anmerkung:     Wenn mehrere in einem String enthaltene Werte bei einer späteren Verarbeitung getrennt werden müssen, muss der String unter Verwendung des für die Konstruktion des Strings verwendeten Trennzeichens in Tokens zerlegt werden. Sie können dafür die XPath-Funktion tokenize verwenden.


Click to expand/collapseTrennzeichen Mehrfachauswahl

Diese Eigenschaft ist aktiviert, wenn die Eigenschaft Mehrfachauswahl auf true gesetzt ist. Wenn der Endbenutzer mehrere Werte aus der Auswahlliste auswählt, wird durch Verkettung der XML-Werte der ausgewählten Einträge und Einfügen des Trennzeichens zwischen die Werte anhand dieser Auswahl ein String erstellt. Der auf diese Art konstruierte String wird in den damit verknüpften Seitenquellen-Node eingegeben. Beachten Sie, dass Sie zum Konstruieren des String ein anderes Trennzeichen als das, welches in der Auswahlliste selbst angezeigt wird, verwenden können; siehe Eigenschaft Sichtbares Trennzeichen für Mehrfachauswahl weiter unten. Dank verschiedener Trennzeichen können Sie für die XML-Verarbeitung einerseits und die Anzeige auf dem Gerät selbst andererseits das optimale Trennzeichen auswählen.

 

Sie können (i) entweder ein Trennzeichen aus den verfügbaren Optionen auswählen oder (ii) entweder direkt oder über einen XPath-Ausdruck ein oder mehrere Zeichen eingeben, die Sie als Trennzeichen verwendet möchten.

 

Anmerkung:   Wenn Sie das Trennzeichen mit Hilfe eines XPath-Ausdrucks definieren, beachten Sie, dass der Ausdruck beim Parsen der Auswahllistenwerte ausgewertet wird. Wenn sich daher aufgrund des Ausdrucks der Rückgabewert während der Verarbeitung zur Laufzeit ändert (z.B. aufgrund eines Node mit wechselndem Inhalt), hat der zurückgegebene Wert möglicherweise nicht das/die gewünschten Zeichen.

 

Informationen im Zusammenhang damit finden Sie auch unter der Eigenschaft Mehrfachauswahl.

 

Click to expand/collapseSichtbares Trennzeichen Mehrfachauswahl

Diese Eigenschaft ist aktiviert, wenn die Eigenschaft Mehrfachauswahl auf true gesetzt ist. Wenn der Endbenutzer mehrere Werte aus der Auswahlliste auswählt, wird durch Verkettung der sichbaren Einträge der Auswahl und Einfügen des Trennzeichens zwischen die Werte anhand dieser Auswahl ein String erstellt. Der auf diese Art konstruierte String wird in der Auswahlliste angezeigt. Beachten Sie, dass Sie zum Konstruieren des String, der in den damit verknüpften Seitenquellen-Node eingegeben wird, ein anderes Trennzeichen verwenden können; siehe Eigenschaft Trennzeichen Mehrfachauswahl weiter oben. Dank verschiedener Trennzeichen können Sie für die XML-Verarbeitung einerseits und die Anzeige auf dem Gerät selbst andererseits das optimale Trennzeichen auswählen.

 

Sie können (i) entweder ein Trennzeichen aus den verfügbaren Optionen auswählen oder (ii) entweder direkt oder über einen XPath-Ausdruck ein oder mehrere Zeichen eingeben, die Sie als Trennzeichen verwendet möchten.

 

Anmerkung:   Wenn Sie das Trennzeichen mit Hilfe eines XPath-Ausdrucks definieren, beachten Sie, dass der Ausdruck beim Parsen der Auswahllistenwerte ausgewertet wird. Wenn sich daher aufgrund des Ausdrucks der Rückgabewert während der Verarbeitung zur Laufzeit ändert (z.B. aufgrund eines Node mit wechselndem Inhalt), hat der zurückgegebene Wert möglicherweise nicht das/die gewünschten Zeichen.

 

Informationen im Zusammenhang damit finden Sie auch unter der Eigenschaft Mehrfachauswahl.

 

Click to expand/collapseSteuerelementaktion

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.

 

Click to expand/collapseSichtbar

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.

 

Click to expand/collapseAktiviert/Editierbar

Je nachdem, ob der Wert der Eigenschaft true (aktiviert) oder false (deaktiviert) ist, ist das Steuerelement entweder aktiviert oder deaktiviert. Der Wert kann direkt eingegeben werden (durch Auswahl des Werts in der Auswahlliste oder durch Doppelklick in das Wertfeld und Eingabe des gewünschten Werts). Der Wert kann auch als XPath-Ausdruck, dessen Ergebnis der Boolesche Wert true oder false ist, eingegeben werden. Der Standardwert ist true. Normalerweise überprüft der XPath-Ausdruck der Eigenschaft Aktiviert/Editierbar eines Steuerelements, ob ein Node bzw. ein bestimmter Node-Wert vorhanden ist. Wenn das Ergebnis des XPath-Ausdrucks true ist, wird das Steuerelement aktiviert.

 

Click to expand/collapseTextfarbe

Definiert die Farbe des Steuerelementtexts, wenn das Steuerelement aktiviert ist. Zur Auswahl der Farbe haben Sie folgende Möglichkeiten:

 

Klicken Sie auf die Farbpalette, um eine Hintergrundfarbe auszuwählen.
Wählen Sie aus der Dropdown-Liste der Auswahlliste eine Farbe aus.
Doppelklicken Sie in das Wertefeld, um einen Farbcode (z.B. #FF0000) auszuwählen oder klicken Sie auf die Symbolleisten-Schaltfläche XPath und geben Sie einen XPath-Ausdruck zur Generierung des gewünschten Texts ein.

 

Anmerkung:   Ein Steuerelement kann je nach Kontext aktiviert oder deaktiviert sein. Wenn der Benutzer z.B. in einem Formular für persönliche Daten anhakt, dass er eine Lebensversicherung hat, so können die Felder für die Details der Lebensversicherungspolizze aktiviert werden; andernfalls können diese Felder deaktiviert werden. Um ein Feld zu aktivieren/zu deaktivieren, verwenden Sie die Eigenschaft Aktiviert/Editierbar des entsprechenden Steuerelements. Mit Hilfe der Eigenschaft Textfarbe (deaktiviert) können Sie eine Textfarbe für ein deaktiviertes Steuerelement definieren.

 

Click to expand/collapseTextfarbe (deaktiviert)

Definiert die Farbe des Steuerelementtexts, wenn das Steuerelement deaktiviert ist. Zur Auswahl der Farbe haben Sie folgende Möglichkeiten:

 

Klicken Sie auf die Farbpalette, um eine Hintergrundfarbe auszuwählen.
Wählen Sie aus der Dropdown-Liste der Auswahlliste eine Farbe aus.
Doppelklicken Sie in das Wertefeld, um einen Farbcode (z.B. #FF0000) auszuwählen oder klicken Sie auf die Symbolleisten-Schaltfläche XPath und geben Sie einen XPath-Ausdruck zur Generierung des gewünschten Texts ein.

 

Anmerkung:   Ein Steuerelement kann je nach Kontext aktiviert oder deaktiviert sein. Wenn der Benutzer z.B. in einem Formular für persönliche Daten anhakt, dass er eine Lebensversicherung hat, so können die Felder für die Details der Lebensversicherungspolizze aktiviert werden; andernfalls können diese Felder deaktiviert werden. Um ein Feld zu aktivieren/zu deaktivieren, verwenden Sie die Eigenschaft Aktiviert/Editierbar des entsprechenden Steuerelements. Mit Hilfe der Eigenschaft Textfarbe können Sie eine Textfarbe für ein aktiviertes Steuerelement definieren.

 

Click to expand/collapseTextgröße

Wählen Sie eine Größe aus der Dropdown-Liste der Auswahlliste aus. Zulässige Werte sind: kleinste|klein|mittel|groß|größte. Jede Plattform/Jedes Gerät hat eine eigene Pixelhöhe für die Größe von Wörtern. Die Standardgröße in Pixel ist die Client-spezifische Pixelhöhe, die dem Wert mittel entspricht.

 

Mit Hilfe der Funktion mt-font-height können Sie andere Werte generieren. Um z.B. eine Größe zu erhalten, die 120% größer als die numerische Größe ist, die der Einstellung 'largest' auf einem Gerät entspricht, verwenden Sie für den Wert Textgröße den folgenden XPath-Ausdruck: mt-font-height('größte', 'px') * 1.2. Die Funktion generiert den numerischen (Pixel)wert, der der Größe 'größte' entspricht. Dieser Wert wird anschließend mit 1,2 multipliziert, um den numerischen Wert zu erhalten, der 120 % des Werts für 'größte' entspricht.

 

Click to expand/collapsePunkte oder Pixel auf iOS-Geräten

Wenn Sie Pixelwerte für Eigenschaften, mit denen eine Länge definiert ist, eingeben, so werden diese Werte bei Darstellung auf iOS-Geräten als Punkte im Anzeigebereichkoordinatenraum gelesen. Der Anzeigebereichkoordinatenraum ist der Bildschirmbereich, auf dem die Designkomponenten abgebildet werden und ein Punkt ist die Längeneinheit in diesem Raum, d.h. es handelt sich hierbei nicht um die typografische Einheit, die 1/72 Zoll beträgt. Das iOS-Gerät ordnet die Punkte des Anzeigebereichkoordinatenraums automatisch Pixeln im Gerätekoordinatenraum zu. Dadurch, dass die Werte auf diese Art (Anzeigebereichswerte zu Gerätewerte) zugeordnet werden, wird sichergestellt, dass bei Designkomponenten unabhängig von der Auflösung des iOS-Geräts oder den verwendeten Maßeinheiten das richtige Größenverhältnis in Bezug auf den Bildschirm und auf die Komponenten zueinander beibehalten wird.

 

Sie können in MobileTogether Designer mit Hilfe der dynamischen Variablen $MT_CanvasX und $MT_CanvasY die Größe des aktuellen Anzeigebereichs (Bildschirms) und somit Längenwerte im Verhältnis zu dieser Größe ermitteln. Für iOS-Geräte werden die von diesen Variablen zurückgegebenen Werte folgendermaßen berechnet: Die Pixel-Dimensionen des aktuellen Gerätekoordinatenraums werden (mit Hilfe des entsprechenden Konvertierungsfaktors) in Punktwerte im Anzeigebereichkoordinatenraum konvertiert. Diese Punktwerte (Zahlenwerte) werden von den beiden Variablen für die Verwendung im Design als Pixel zurückgegeben. Wenn ein Bild z.B. die halbe Breite des Anzeigebereichs einnehmen soll, definieren Sie dafür eine Pixelbreite die gleich $MT_CanvasX * 0.5 ist. Der XPath-Ausdruck für diese Bildbreite wäre folgender: concat($MT_CanvasX * 0.5, 'px').

 

Click to expand/collapseTextgröße automatisch anpassen

Legt fest, ob Text automatisch verkleinert werden soll, um in die Breite des Steuerelements zu passen. Die Werte der Eigenschaft sind:

 

Aus (Der Text wird nicht automatisch angepasst; dies ist die Standardeinstellung)
Auslassungszeichen (Fügt Auslassungszeichen zum Ende des sichtbaren Steuerelementtexts hinzu, wenn der Text zu lange ist, um zur Gänze angezeigt zu werden)
einzeln (nur der Text dieses Steuerelements wird automatisch in der Größe angepasst)
Gruppe X (wobei X=1 bis 9). Sie können für ein Steuerelement eine von neun Gruppen für die automatische Anpassung der Textgröße definieren (wobei jede Gruppe eine Nummer von 1 bis 9 erhält). Die Textgröße aller Steuerelemente in einer Gruppe wird automatisch an die des Steuerelements angepasst, das bei der automatischen Anpassung der Textgröße die kleinste Textgröße in dieser Gruppe hat. Damit stellen Sie sicher, dass eine ausgewählte Gruppe von Steuerelementen eine vernünftige einheitliche Textgröße hat, ohne dass Sie die optimale Textgröße für eine solche Steuerelementgruppe durch Versuch und Irrtum herausfinden müssen.

 

In der Design-Ansicht wird die Textgröße auf maximal 50 % der Schriftartgröße verkleinert, auch wenn der Wert für die automatische Anpassung der Textgröße kleiner als das ist. Zur Laufzeit wird der Text jedoch in der tatsächlich ermittelten Größe angezeigt.

 

Anmerkung

 

Wenn die Eigenschaft Mehrzeilig auf true gesetzt wurde, (i) und wenn Textgröße automatisch anpassen deaktiviert ist, wird der Text auf mehrere Zeilen umbrochen; (ii) und wenn Textgröße automatisch anpassen aktiviert ist, wird die Größe des Texts automatisch angepasst und der Text wird nicht umbrochen; Zeilenumbruchszeichen im Text würden jedoch einen Zeilenumbruch verursachen.
Diese Eigenschaft kann nicht aktiviert werden, wenn die Beschriftungseigenschaft Maximale Zeilenanzahl definiert wurde. Sie können nur entweder eine maximale Zeilenanzahl definieren oder die Textgröße automatisch anpassen lassen.
Die Automatische Anpassung der Textgröße steht auf Web Clients nicht zur Verfügung.

 

Click to expand/collapseFetter Text

Wählen Sie in der Dropdown-Liste der Auswahlliste true oder false aus. Sie können auch einen XPath-Ausdruck verwenden. Die Standardeinstellung ist false.

 

Click to expand/collapseKursiver Text

Wählen Sie in der Dropdown-Liste der Auswahlliste true oder false aus. Der Wert kann auch dynamisch mit Hilfe eines XPath-Ausdrucks generiert werden. Die Standardeinstellung ist false.

 

Click to expand/collapseText unterstreichen

Wählen Sie in der Dropdown-Liste der Auswahlliste true oder false aus. Der Wert kann auch dynamisch mit Hilfe eines XPath-Ausdrucks generiert werden. Die Standardeinstellung ist false.

 

Click to expand/collapseHintergrundfarbe

Definiert die Hintergrundfarbe des Objekts, wenn es aktiv ist. Zur Auswahl der Farbe haben Sie folgende Möglichkeiten:

 

Klicken Sie auf die Farbpalette, um eine Hintergrundfarbe auszuwählen.
Wählen Sie aus der Dropdown-Liste der Auswahlliste eine Farbe aus. Um die Hintergrundfarbe des Steuerelements auszuwählen, wählen Sie in der Auswahlliste den Eintrag Steuerelementhintergrundfarbe aus.
Doppelklicken Sie in das Wertefeld, um einen Farbcode (z.B. #FF0000) auszuwählen oder klicken Sie auf die Symbolleisten-Schaltfläche XPath und geben Sie einen XPath-Ausdruck zur Generierung des gewünschten Texts ein. Um die Hintergrundfarbe des Steuerelements zu verwenden, geben Sie den XPath-Ausdruck "control" ein.

 

Anmerkung:   Damit die Zelle dieselbe Hintergrundfarbe wie das Steuerelement in der Zelle erhält, wählen Sie entweder (i) in der Auswahlliste der Eigenschaft den Eintrag Steuerelementhintergrund aus oder (ii) geben Sie in das Wertefeld der Eigenschaft den XPath-Ausdruck "control" ein.

 

Anmerkung:   Ein Steuerelement kann je nach Kontext aktiviert oder deaktiviert sein. Wenn der Benutzer z.B. in einem Formular für persönliche Daten anhakt, dass er eine Lebensversicherung hat, so können die Felder für die Details der Lebensversicherungspolizze aktiviert werden; andernfalls können diese Felder deaktiviert werden. Um ein Feld zu aktivieren/zu deaktivieren, verwenden Sie die Eigenschaft Aktiviert/Editierbar des entsprechenden Steuerelements. Mit Hilfe der Eigenschaft Textfarbe (deaktiviert) können Sie eine Textfarbe für ein deaktiviertes Steuerelement definieren.

Click to expand/collapseHintergrundfarbe (deaktiviert)

Definiert die Hintergrundfarbe des Objekts, wenn es deaktiviert ist. Zur Auswahl der Farbe haben Sie folgende Möglichkeiten:

 

Klicken Sie auf die Farbpalette, um eine Hintergrundfarbe auszuwählen.
Wählen Sie aus der Dropdown-Liste der Auswahlliste eine Farbe aus.
Doppelklicken Sie in das Wertefeld, um einen Farbcode (z.B. #FF0000) auszuwählen oder klicken Sie auf die Symbolleisten-Schaltfläche XPath und geben Sie einen XPath-Ausdruck zur Generierung des gewünschten Texts ein.

 

Anmerkung:   Ein Steuerelement kann je nach Kontext aktiviert oder deaktiviert sein. Wenn der Benutzer z.B. in einem Formular für persönliche Daten anhakt, dass er eine Lebensversicherung hat, so können die Felder für die Details der Lebensversicherungspolizze aktiviert werden; andernfalls können diese Felder deaktiviert werden. Um ein Feld zu aktivieren/zu deaktivieren, verwenden Sie die Eigenschaft Aktiviert/Editierbar des entsprechenden Steuerelements. Mit Hilfe der Eigenschaft Textfarbe können Sie eine Textfarbe für ein aktiviertes Steuerelement definieren.

Click to expand/collapseHorizontale Ausrichtung

Setzt die horizontale Ausrichtung auf left, center oder right. Die Standardeinstellung ist center. Der Wert kann auch über einen XPath-Ausdruck definiert werden (Auf diese Art kann der Wert dynamisch generiert werden).

 

Click to expand/collapseVertikale Ausrichtung

Setzt die vertikale Ausrichtung auf top, middle oder bottom. Die Standardeinstellung ist middle. Der Wert kann auch über einen XPath-Ausdruck definiert werden (Auf diese Art kann der Wert dynamisch generiert werden).

 

Click to expand/collapseBreite des Steuerelements

Definiert die Breite des Steuerelements. Wählen Sie über die Auswahlliste der Eigenschaft einen Wert aus. Es stehen die folgenden Werte zur Verfügung:

 

Parent_ausfüllen: Die Breite des Steuerelements wird an die des übergeordneten Elements, z.B. einer Tabellenzelle oder der Seite angepasst.
Inhalt_umbrechen: Das Steuerelement wird nur so breit gemacht, dass der Inhalt des Steuerelements Platz hat. Wenn dieser Wert ausgewählt ist, wird die Eigenschaft Maximale Steuerelementbreite verfügbar.
Prozentwert: ein Prozentwert der Seitenbreite; wählen Sie einen Wert aus der Dropdown-Liste aus oder geben Sie den Wert direkt ein.
Pixelwert: Wählen Sie einen Pixelwert aus der Dropdown-Liste aus oder geben Sie direkt einen Wert ein.

 

Mit Parent_ausfüllen wird somit eine maximale Breite definiert, während mit Inhalt_umbrechen eine minimale Breite festgelegt wird.

 

Der Standardwert für alle Steuerelemente mit Ausnahme der folgenden ist Parent_ausfüllen.

 

Bild und Diagramm: Für diese ist der Standardwert Inhalt_umbrechen.
Geolocation-Karte: Der Standardwert ist der kleinere der beiden Werte $MT_CanvasX und $MT_CanvasY. Mit diesen beiden dynamischen Variablen wird die Breite bzw. Höhe des Anzeigebereichs des Geräts angegeben. Da die Standardwerte von Höhe des Steuerelements and Breite des Steuerelements die gleichen sind (in beiden Fällen jeweils der kleinere Wert von $MT_CanvasX und $MT_CanvasY), bildet die Standardform und -größe des Anzeigebereichs im Steuerelement immer ein Quadrat, das gleich min($MT_CanvasX, $MT_CanvasY) ist.

 

Click to expand/collapsePunkte oder Pixel auf iOS-Geräten

Wenn Sie Pixelwerte für Eigenschaften, mit denen eine Länge definiert ist, eingeben, so werden diese Werte bei Darstellung auf iOS-Geräten als Punkte im Anzeigebereichkoordinatenraum gelesen. Der Anzeigebereichkoordinatenraum ist der Bildschirmbereich, auf dem die Designkomponenten abgebildet werden und ein Punkt ist die Längeneinheit in diesem Raum, d.h. es handelt sich hierbei nicht um die typografische Einheit, die 1/72 Zoll beträgt. Das iOS-Gerät ordnet die Punkte des Anzeigebereichkoordinatenraums automatisch Pixeln im Gerätekoordinatenraum zu. Dadurch, dass die Werte auf diese Art (Anzeigebereichswerte zu Gerätewerte) zugeordnet werden, wird sichergestellt, dass bei Designkomponenten unabhängig von der Auflösung des iOS-Geräts oder den verwendeten Maßeinheiten das richtige Größenverhältnis in Bezug auf den Bildschirm und auf die Komponenten zueinander beibehalten wird.

 

Sie können in MobileTogether Designer mit Hilfe der dynamischen Variablen $MT_CanvasX und $MT_CanvasY die Größe des aktuellen Anzeigebereichs (Bildschirms) und somit Längenwerte im Verhältnis zu dieser Größe ermitteln. Für iOS-Geräte werden die von diesen Variablen zurückgegebenen Werte folgendermaßen berechnet: Die Pixel-Dimensionen des aktuellen Gerätekoordinatenraums werden (mit Hilfe des entsprechenden Konvertierungsfaktors) in Punktwerte im Anzeigebereichkoordinatenraum konvertiert. Diese Punktwerte (Zahlenwerte) werden von den beiden Variablen für die Verwendung im Design als Pixel zurückgegeben. Wenn ein Bild z.B. die halbe Breite des Anzeigebereichs einnehmen soll, definieren Sie dafür eine Pixelbreite die gleich $MT_CanvasX * 0.5 ist. Der XPath-Ausdruck für diese Bildbreite wäre folgender: concat($MT_CanvasX * 0.5, 'px').

 

Click to expand/collapseMaximale Steuerelementbreite

Diese Eigenschaft steht nur zur Verfügung, wenn die Eigenschaft Steuerelementbreite des Steuerelements auf Inhalt_umbrechen gesetzt wurde. Mit der Eigenschaft Maximale Steuerelementbreite wird die maximale Breite des Steuerelements definiert. Wählen Sie einen Wert aus der Auswahlliste der Eigenschaft aus. Die folgenden Werte stehen zur Verfügung:

 

Prozentwert: ein Prozentwert der Seitenbreite; wählen Sie einen Wert aus der Dropdown-Liste aus oder geben Sie einen Wert direkt ein.
Pixelwert: Wählen Sie einen Pixelwert aus der Dropdown-Liste aus oder geben Sie einen Wert direkt ein.

 

Click to expand/collapseRand

Definiert den Randabstand des Steuerelements zu umgebenden Objekten oder zu den Rändern des enthaltenden Objekts. Wählen Sie in der Dropdown-Liste der Auswahlliste einen Wert in Pixel aus oder doppelklicken Sie in das Wertfeld, um eine Pixellänge einzugeben. Der definierte Randabstand wird auf allen vier Seiten des Steuerelements erstellt. Wenn Sie für eine der vier Seiten einen anderen Rand definieren möchten, erweitern Sie die Eigenschaft Rand, um die einzelnen Randeigenschaften (links, rechts, oben und unten) anzuzeigen und definieren Sie einen anderen Wert dafür. Wenn Sie z.B. Rand auf 6px und Unterer Rand auf 12px setzen, so erhalten der obere, linke und rechte Rand eine Breite von 6px und der untere Rand eine von 12px.

 

Click to expand/collapsePunkte oder Pixel auf iOS-Geräten

Wenn Sie Pixelwerte für Eigenschaften, mit denen eine Länge definiert ist, eingeben, so werden diese Werte bei Darstellung auf iOS-Geräten als Punkte im Anzeigebereichkoordinatenraum gelesen. Der Anzeigebereichkoordinatenraum ist der Bildschirmbereich, auf dem die Designkomponenten abgebildet werden und ein Punkt ist die Längeneinheit in diesem Raum, d.h. es handelt sich hierbei nicht um die typografische Einheit, die 1/72 Zoll beträgt. Das iOS-Gerät ordnet die Punkte des Anzeigebereichkoordinatenraums automatisch Pixeln im Gerätekoordinatenraum zu. Dadurch, dass die Werte auf diese Art (Anzeigebereichswerte zu Gerätewerte) zugeordnet werden, wird sichergestellt, dass bei Designkomponenten unabhängig von der Auflösung des iOS-Geräts oder den verwendeten Maßeinheiten das richtige Größenverhältnis in Bezug auf den Bildschirm und auf die Komponenten zueinander beibehalten wird.

 

Sie können in MobileTogether Designer mit Hilfe der dynamischen Variablen $MT_CanvasX und $MT_CanvasY die Größe des aktuellen Anzeigebereichs (Bildschirms) und somit Längenwerte im Verhältnis zu dieser Größe ermitteln. Für iOS-Geräte werden die von diesen Variablen zurückgegebenen Werte folgendermaßen berechnet: Die Pixel-Dimensionen des aktuellen Gerätekoordinatenraums werden (mit Hilfe des entsprechenden Konvertierungsfaktors) in Punktwerte im Anzeigebereichkoordinatenraum konvertiert. Diese Punktwerte (Zahlenwerte) werden von den beiden Variablen für die Verwendung im Design als Pixel zurückgegeben. Wenn ein Bild z.B. die halbe Breite des Anzeigebereichs einnehmen soll, definieren Sie dafür eine Pixelbreite die gleich $MT_CanvasX * 0.5 ist. Der XPath-Ausdruck für diese Bildbreite wäre folgender: concat($MT_CanvasX * 0.5, 'px').

 

Click to expand/collapseAbstände

Definiert die Abstände eines Steuerelements, d.h. den Raum zwischen dem Rand des Steuerelements und dem Inhalt des Steuerelements. Wählen Sie aus der Dropdown-Liste der Auswahlliste einen Wert in Pixel aus oder doppelklicken Sie in das Wertefeld, um einen Pixelwert einzugeben. Die Abstände werde für alle vier Seiten des Steuerelements definiert. Wenn Sie für eine der vier Seiten einen anderen Abstand definieren möchten, erweitern Sie die Eigenschaft Abstände, um die einzelnen Abstandseigenschaften (links, rechts, oben und unten) anzuzeigen und definieren Sie einen anderen Wert dafür. Wenn Sie z.B. Abstände auf 6px und Abstand unten auf 12px setzen, so Sie oben, rechts und links einen Abstand von 6px und unten 12px.

 

Click to expand/collapsePunkte oder Pixel auf iOS-Geräten

Wenn Sie Pixelwerte für Eigenschaften, mit denen eine Länge definiert ist, eingeben, so werden diese Werte bei Darstellung auf iOS-Geräten als Punkte im Anzeigebereichkoordinatenraum gelesen. Der Anzeigebereichkoordinatenraum ist der Bildschirmbereich, auf dem die Designkomponenten abgebildet werden und ein Punkt ist die Längeneinheit in diesem Raum, d.h. es handelt sich hierbei nicht um die typografische Einheit, die 1/72 Zoll beträgt. Das iOS-Gerät ordnet die Punkte des Anzeigebereichkoordinatenraums automatisch Pixeln im Gerätekoordinatenraum zu. Dadurch, dass die Werte auf diese Art (Anzeigebereichswerte zu Gerätewerte) zugeordnet werden, wird sichergestellt, dass bei Designkomponenten unabhängig von der Auflösung des iOS-Geräts oder den verwendeten Maßeinheiten das richtige Größenverhältnis in Bezug auf den Bildschirm und auf die Komponenten zueinander beibehalten wird.

 

Sie können in MobileTogether Designer mit Hilfe der dynamischen Variablen $MT_CanvasX und $MT_CanvasY die Größe des aktuellen Anzeigebereichs (Bildschirms) und somit Längenwerte im Verhältnis zu dieser Größe ermitteln. Für iOS-Geräte werden die von diesen Variablen zurückgegebenen Werte folgendermaßen berechnet: Die Pixel-Dimensionen des aktuellen Gerätekoordinatenraums werden (mit Hilfe des entsprechenden Konvertierungsfaktors) in Punktwerte im Anzeigebereichkoordinatenraum konvertiert. Diese Punktwerte (Zahlenwerte) werden von den beiden Variablen für die Verwendung im Design als Pixel zurückgegeben. Wenn ein Bild z.B. die halbe Breite des Anzeigebereichs einnehmen soll, definieren Sie dafür eine Pixelbreite die gleich $MT_CanvasX * 0.5 ist. Der XPath-Ausdruck für diese Bildbreite wäre folgender: concat($MT_CanvasX * 0.5, 'px').

 

Click to expand/collapseAktivierreihenfolge

Die Eigenschaft Aktivierreihenfolge erhält als Wert eine Ganzzahl oder eine XPath-Erweiterung, deren Ergebnis eine Ganzzahl ist. Diese Ganzzahl gibt die Position des Steuerelements in der Aktivierreihenfolge an.

 

Die Aktivierreihenfolge ist die Reihenfolge, in der Steuerelemente den Fokus erhalten, wenn der Benutzer auf dem Client-Gerät die Tabulatortaste drückt. Die gesamte Aktivierreihenfolge kann mit dem Befehl Seite | Aktivierreihenfolge anzeigen/definieren schnell und im visuellen Kontext aller Steuerelemente der Seite definiert werden. Die Eigenschaft Aktivierreihenfolge einzelner Steuerelemente gibt die Reihenfolgeposition nur dieses Steuerelements an.

 

Anmerkung:    Die Funktion "Aktivierreihenfolge" steht nur auf Web und Windows Clients zur Verfügung.

 

 

Click to expand/collapseStylesheet

Mit der Eigenschaft Stylesheet wird definiert, welches Stylesheet für das Steuerelement verwendet werden soll. In der Dropdown-Liste der Auswahlliste der Eigenschaft Stylesheet werden alle benutzerdefinierten Stylesheets, die im Projekt definiert wurden, angezeigt. Wählen Sie das gewünschte Stylesheet für das Steuerelement aus. Alternativ dazu können Sie einen XPath-Ausdruck auswählen, um das gewünschte Stylesheet auszuwählen; dies hat den Vorteil, dass Sie der Auswahl des Stylesheet eine Bedingung zugrunde legen können (siehe Anwenden benutzerdefinierter Stylesheets). Nähere Informationen dazu finden Sie im Abschnitt Stylesheets.

 

Click to expand/collapseBrowser-CSS-Klasse

Der Name einer oder mehrerer CSS-Klassen, die mit diesem Steuerelement verknüpft werden sollen. Verwenden Sie ein Leerzeichen, um mehrere Klassen zuzuweisen: LabelClassOne LabelClassTwo. Diese Klassen können anschließend in einer (im Dialogfeld "Browser-Einstellungen") definierten) CSS-Datei verwendet werden, um diesem Steuerelement Eigenschaften zuzuweisen. Der Name/Die Namen der Klasse(n) kann/können auch mit Hilfe eines XPath-Ausdrucks generiert oder abgerufen werden.

 

 


© 2019 Altova GmbH