Geolocation-Karte
Mit Hilfe des Steuerelements "Geolocation-Karte" kann die Karte eines bestimmten Gebiets in einer Straßen-, Satelliten- oder Hybridansicht angezeigt werden (die Ansicht wird in der Eigenschaft Kartentyp definiert). POIs (Points of Interest) in dem in der Karte angezeigten Gebiet können durch Marker gekennzeichnet werden. In der Eigenschaft Marker des Steuerelements können beliebig viele Marker defineirt werden. Optional können in die Karte der aktuelle Standort sowie Zoom-Steuerelemente (siehe die entsprechenden Eigenschaften weiter unten) inkludiert werden. Die Größe und der Vergrößerungfaktor der zu Anfang im Steuerelement angezeigten Karte können über die Eigenschaften Anzeigebereich, Breite des Steuerelements und Höhe des Steuerelements definiert werden. Außerdem verfügt das Steuerelement "Geolocation-Karte" über ein Ereignis namens BeiKlickAufGeoMapMarker, mit Hilfe dessen Sie Aktionen definieren können, die ausgeführt werden sollen, wenn der Benutzer auf einen bestimmten Marker klickt.
•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 Seitenquellenzuweisung aufheben <NodeName>. •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. |
Ereignisse für "Geolocation-Karte"
Es steht das Ereignis BeiKlickAufGeoMapMarker zur Verfügung. Damit können Sie Aktionen definieren, die ausgeführt werden sollen, wenn ein Marker in der Karte angeklickt wird. Mit Hilfe der dynamischen Variablen \$MT_GeolocationMapMarker können Informationen über den angeklickten Marker abgerufen werden.
Die dynamische Variable \$MT_GeolocationMapMarker enthält Informationen über den vom Client-Benutzer zuletzt angeklickten Marker. Diese in der Variablen enthaltenen Informationen sind in einem XPath-Kartenkonstrukt in einem im folgenden Beispiel gezeigten Format gespeichert:
map {
"id":"vie",
"geolocation":(48.2143531, 16.3707266),
"title":"Vienna",
"text":"Altova EU"
}
Um einen Wert aus dem XPath-Kartenkonstrukt abzurufen, verwenden Sie einen XPath-Ausdruck wie den folgenden: map:get( \$MT_GeolocationMapMarker, "id" ). Der Ausdruck in diesem Beispiel gibt den Wert des id-Schlüssels (d.h. die id das angeklickten Markers) zurück.
Eine Beschreibung der Aktionen, die für das Ereignis BeiKlickAufGeoMapMarker definiert werden können, finden Sie im Abschnitt Aktionen.
Eigenschaften von "Geolocation-Karte"
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.
|
Die Eigenschaft Alle Stile wird angezeigt, wenn die Einstellung Alle Stile des Dialogfelds "Weitere Projekteinstellungen" auf true gesetzt wurde. (Die Standardeinstellung hierfür ist false).
Über diese Eigenschaft können Sie alle Stile der Komponente mit Hilfe eines einzigen XPath-Zuordnungsausdrucks definieren. Ein Beispiel bilden die zwei unten stehenden Zuordnungsausdrücke:
map{ "Bold Text" : \$XML1/R/@bold = "1", "Italic Text" : true(), "Text" : "hello", "Text Color" : "red", "Background Color" : \$XML1/R/@background, "Text Size" : \$XML1/R/@textsize }
map{ "Style Sheet" : "Sheet-1" }
Beachten Sie die folgenden Punkte:
•Wenn Sie für die Eigenschaft Alle Stile einen Wert eingeben, - selbst wenn es sich dabei nicht um eine Zuordnung handelt - werden alle Stileigenschaften der aktuellen Komponente im Fenster "Stile & Eigenschaften" nicht mehr angezeigt. •Es handelt sich hierbei um eine komplexe Funktionalität. Sie müssen daher sicherstellen, dass Ihr XPath-Zuordnungsausdruck sowohl hinsichtlich Syntax als auch Werten korrekt ist. •Sie können die Schlüssel-Wert-Paare der Zuordnung in jeder beliebigen Reihenfolge eingeben. •Die Schlüsselnamen sind die Namen der Stileigenschaften (oder Stile). So sind etwa in der ersten Zuordnung oben Bold Text (Fetter Text) und Text Size (Textgröße) Stilnamen. Die Stile, die für eine bestimmte Komponente zur Verfügung stehen, werden im Fenster "Stile & Eigenschaften" unter dieser Komponente aufgelistet. •Sie müssen die englischen Namen der Stile verwenden. Diese werden am Ende des Popup-Fensters, das jeweils angezeigt wird, wenn Sie den Mauszeiger über einen Stil platzieren, angezeigt. •Sie können, wie in der zweiten Zuordnung oben, auch ein Stylesheet definieren.
|
Definiert den Typ der im Steuerelement "Geolocation-Karten" angezeigten Karte. Es stehen die folgenden Optionen zur Verfügung:
•Standardeinstellung (keine Auswahl): Es wird der auf dem Client-Gerät ausgewählte Kartentyp verwendet. •Straße: Zeigt eine Straßenkarte des jeweiligen Gebiets an. •Satellit: Zeigt ein Satellitenbild des jeweiligen Gebiets an. •Hybrid: Zeigt eine Kombination aus Straßenkarte und Satellitenbild an.
Anmerkung: Mit Hilfe eines XPath-Ausdrucks kann der Kartentyp auch dynamisch definiert werden. Das Ergebnis des Ausdrucks muss eine der folgenden Optionen sein: (i) Straße, (ii) Satellit, (iii) Hybrid.
Anmerkung: Auf Web Clients und im Simulator steht unabhängig davon, welche der obigen Optionen ausgewählt ist, nur ein einziger Kartentyp zur Verfügung.
|
Gibt an, ob der aktuelle Standort des Client-Geräts auf der Karte angezeigt werden soll. Damit sieht der Benutzer, wo auf der Karte er sich gerade befindet. Die Werte der Eigenschaft sind true oder false, wobei der Standardwert false ist. Mit Hilfe eines XPath-Ausdrucks kann der Wert der Eigenschaft dynamisch definiert werden. (So wäre z.B. das Ergebnis von Element/@attribute="1" je nach dem Wert von Element/@attribute true oder false).
Anmerkung: Damit diese Funktion verwendet werden kann, müssen auf dem Client-Gerät die Standortdaten freigegeben worden sein.
|
Gibt an, ob auf der Karte Zoom-Steuerelemente angezeigt werden sollen. Die Werte der Eigenschaft sind true oder false, wobei der Standardwert true ist. Der Wert der Eigenschaft kann mit Hilfe eines XPath-Ausdrucks dynamisch definiert werden. Beachten Sie, dass Zoom-Steuerelemente auf iOS-Geräten nicht angezeigt werden.
|
Ein XPath-Ausdruck, der die Anzahl der in die Karte inkludierten Marker sowie deren Eigenschaften definiert. Das Ergebnis des XPath-Ausdrucks müssen ein oder mehrere XPath-Kartenkonstrukte sein: map-1, map-2, ... map-N. Jedes XPath-Kartenkonstrukt besteht aus einer Gruppe von Schlüssel-Wert-Paaren, die gemeinsam die Eigenschaften eines einzigen Markers definieren. Es werden die folgenden Schlüssel definiert:
•id: Der Wert ist eine ID für den Marker •geolocation: Dies ist eine Sequenz von zwei Strings oder zwei Zahlen (Ganzzahl oder Dezimalzahl): Die geografische Breite und Höhe, z.B.: (48.2143531, 16.3707266) •title: Ein String, der den Titel des Popups bildet, das angezeigt wird, wenn auf der Karte auf den Marker geklickt wird. •text: Ein String, der den Text des Popups bildet, der angezeigt wird, wenn auf der Karte auf den Marker geklickt wird.
Ein vollständiges XPath-Kartenkonstrukt würde in etwa folgendermaßen aussehen:
map { "id":"vie", "geolocation":(48.2143531, 16.3707266), "title":"Vienna", "text":"Altova EU" }
Mit dem obigen XPath-Kartenkonstrukt würde ein Marker für das Altova-Büro in Wien erstellt. Um weitere Marker zur Karte hinzuzufügen, geben Sie nach Eingabe eines Kommas als Trennzeichen die weiteren XPath-Kartenkonstrukte ein: map-1, map-2, ... map-N.
mt-geo-map-marker()Mit Hilfe der MobileTogether XPath-Erweiterungsfunktion mt-geo-map-marker kann ein Marker dynamisch erstellt werden. Jede mt-geo-map-marker-Funktion gibt ein XPath-Kartenkonstrukt, d.h. jeweils einen Marker zurück. Um mehrere Marker zu erstellen, verwenden Sie mehrere mt-geo-map-marker-Funktionen. Nähere Informationen zu dieser Funktion finden Sie unter der Beschreibung zu mt-geo-map-marker().
|
Ein XPath-Ausdruck, dessen Ergebnis zwei geografische Koordinaten sind: die linke obere und die rechte untere Ecke des Anzeigebereichrechtecks. Der Anzeigebereich ist der Kartenbereich, der in der Geolocation-Karte angezeigt wird. Beachten Sie jedoch, dass die Dimensionen des Geolocation-Karten-Steuerelements durch die Eigenschaften "Breite des Steuerelements" und "Höhe des Steuerelements" definiert sind. Der Anzeigebereich befindet sich, wenn er korrekt definiert wurde, innerhalb des im Steuerelement angezeigten Kartenbereichs.
Das Ergebnis des XPath-Ausdrucks muss eine Sequenz von zwei Strings sein, wobei jeder String eine Gruppe von Koordinaten darstellt. So ist der erste String im folgenden Beispiel die linke obere Koordinate, während der zweite String die rechte untere Koordinate bildet: ("61° -10°", "41° 10°"). Die linke obere Koordinate wäre also 61°N 10°W, während die rechte untere Koordinate 41°N 10°O wäre. Mit Hilfe dieser Koordinaten würde ein Anzeigebereich von ungefähr 10° im Quadrat mit dem Zentrum von London erstellt (ungefähr 51°N 0°O).
Die Standardeinstellung für den Anzeigebereich sind die Koordinaten eines Rechtecks, in dem alle definierten Marker mit dem größtmöglichen Vergrößerungsfaktor angezeigt werden.
geolocations-bounding-rectangle()Mit Hilfe der Altova-Erweiterungsfunktion geolocations-bounding-rectangle kann ein Rechteck rund um eine Gruppe definierter geografischer Punkte erstellt werden. Das Ergebnis dieser Funktion sind die linke obere und rechte untere Ecke eines Rechtecks, das sich mit dem größtmöglichen Vergrößerungsfaktor, also so genau wie möglich, um die angegebenen geografischen Positionen legen lässt. Der Rückgabewert der Funktion ist eine Sequenz von zwei Strings. Dadurch kann diese Funktion in einem XPath-Ausdruck verwendet werden, um den Wert der Eigenschaft "Anzeigebereich" zu generieren.
Nähere Informationen zu der Funktion finden Sie in der Beschreibung zu geolocations-bounding-rectangle().
|
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.
|
Damit definieren Sie den Text, der als Tooltip angezeigt werden soll, wenn der Endbenutzer die Maus über ein Steuerelement platziert oder lange auf das Steuerelement tippt. Ein Tooltip gibt dem Endbenutzer nützliche Informationen über das Steuerelement. Doppelklicken Sie in das Wertefeld, um den Text zu bearbeiten. Wenn für ein langes Antippen des Steuerelements bereits eine Aktion definiert wurde, wird bei langem Antippen kein Tooltip angezeigt.
Anmerkung: Tooltips stehen nicht für alle Steuerelemente und für einige Steuerelemente nicht auf allen Plattformen zur Verfügung Auf iOS-Systemen stehen Tooltips nicht für Bearbeitungsfelder oder Unterschrifts-Steuerelemente zur Verfügung.
|
Diese Eigenschaft wird bei einigen Steuerelementen (wie z.B. Bildern und vertikalen Linien) auf das Steuerelement, in anderen Fällen (wie z.B. bei Optionsfeldern und Kontrollkästchen) auf den Text für das Steuerelement angewendet. Mit der Eigenschaft wird die horizontale Ausrichtung des Steuerelements bzw. Texts auf links, zentriert oder rechts gesetzt. Die Standardeinstellung ist für alle Steuerelemente links. Eine Ausnahme bilden vertikale Linien. Für diese ist die Einstellung zentriert. Der Wert der Eigenschaft kann auch über einen XPath-Ausdruck definiert werden (Auf diese Art kann der Wert dynamisch generiert werden).
|
Setzt die vertikale Ausrichtung auf oben, Mitte oder unten. Die Standardeinstellung ist Mitte. Der Wert kann auch über einen XPath-Ausdruck definiert werden (Auf diese Art kann der Wert dynamisch generiert werden). Bei Kontrollkästchen-Steuerelementen wird mit dieser Eigenschaft die vertikale Ausrichtung des Kontrollkästchens relativ zu seinem Text definiert, wenn der Text mehrzeilig ist (siehe Eigenschaft Mehrzeilig).
|
Definiert die Breite des Steuerelements. Wählen Sie einen Wert aus der Auswahlliste der Eigenschaft aus. Die folgenden Werte stehen 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. •Inhalt_umbrechen_längster_Eintrag: Steht für Auswahllisten-Steuerelemente zur Verfügung. Die Auswahlliste wird nur so breit gemacht, dass der Inhalt des längsten Eintrags Platz hat. Wenn dieser Eigenschaftswert 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 einen Wert direkt ein. •Pixel, dp oder sp-Wert: Wählen Sie einen Pixel-, dp- oder sp-Wert aus der Dropdown-Liste aus oder geben Sie den Wert direkt ein.
Mit Parent_ausfüllen wird somit eine maximale Breite definiert, während mit Inhalt_umbrechen eine minimale Breite festgelegt wird. Wenn sich die Auswahlliste z.B. in einer Tabellenzelle befindet, würde die Auswahlliste die Zelle bei Parent_ausfüllen ausfüllen, während sie mit Inhalt_umbrechen die Zelle eventuell nicht ausfüllen würde.
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.
Informationen über das Verhältnis zwischen Pixel, dp (device-independent pixels) und sp (scale--independent pixels) finden Sie unter Größen: Pixel, DPI, DP, SP.
|
Definiert die Höhe 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 Höhe des Steuerelements wird an die des übergeordneten Elements, z.B. einer Tabellenzelle oder der Seite angepasst. •Inhalt_umbrechen: Das Steuerelement wird nur so hoch gemacht, dass der Inhalt des Steuerelements Platz hat.
Mit Parent_ausfüllen wird somit eine maximale Höhe definiert, während mit Inhalt_umbrechen eine minimale Höhe festgelegt wird.
Standardwerte •Für das Steuerelement "Geolocation-Karte" ist der Standardwert 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. •Die Standardeinstellung für alle anderen Steuerelemente ist Inhalt_umbrechen.
|
Definiert den Randabstand des Steuerelements (oder der Seite) zu umgebenden Objekten oder zu den Rändern des enthaltenden Objekts. Wählen Sie aus der Dropdown-Liste der Auswahlliste einen Wert in Pixel, dp oder sp aus oder doppelklicken Sie in das Wertefeld, um einen Längenwert einzugeben. Der definierte Randabstand wird auf allen vier Seiten des Steuerelements bzw. der Seite 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.
Informationen über das Verhältnis zwischen Pixel, dp (device-independent pixels) und sp (scale--independent pixels) finden Sie unter Größen: Pixel, DPI, DP, SP.
|
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.
|
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.
|