TextBlock

<TextBlock>-Controls werden verwendet, um Textblöcke innerhalb einer Web-Anwendung zu formatieren.

Das TextBlock-Control wird über die allgemeinen Attribute für Controls definiert.

Das Element <TextBlock> kann folgende Elemente enthalten:

Freitext
<Paragraph>
<Binding>
<Break>

<Translation>
<Link>

Paragraph

Das Element <Paragraph> wird verwendet, um Texte in verschiedene Absätze zu unterteilen und kann folgende Elemente enthalten:

Freitext
<Binding>
<Break>

<Translation>
<Link>

Ein Paragraph kann über folgende Attribute definiert werden:

Attribut	Beschreibung
`background`	Definiert eine Farbe für den Hintergrund des Controls. Diese Einstellung überschreibt die Standardfarbe des Farbschemas! Dieses Attribut funktioniert nicht für das Control Maps! Mögliche Werte: Hexadezimaler Farbwert, z. B. `ff5a00` Verwenden Sie keine Raute vor dem Farbwert oder eine verkürzte Schreibweise! Farbcode aus der Farbpalette der Web App (vgl. Theming), z. B. `A200`

`fontFamily`	Legt die Schriftfamilie fest. Mit diesem Attribut wird die Standardschrift der Web App für dieses Control überschrieben. Wird das Attribut auf einem Element definiert, so wird die Schriftfamilie an die Kindelemente des Elementes vererbt, sofern die Kindelemente das Attribut `fontFamily` nicht explizit gesetzt haben. Dieses Attribut funktioniert nicht für die Elemente `Image`, `Map` und `HtmlDocument`. Mögliche Werte: `MainFont`: hinterlegte Hauptschrift Fontcode aus der Font-Palette, z. B. `Font04`
`fontSize`	Legt die Schriftgröße fest. Mit diesem Attribut wird die Standardschriftgröße der Web App für dieses Control überschrieben. Dieses Attribut funktioniert nicht für die Elemente `Image`, `Map` und `HtmlDocument`. Mögliche Werte: Beliebige ganze Zahl oder Dezimalzahl mit einem Punkt als Dezimaltrennzeichen, z. B. `20` ; `20.8` ; `.9` Schriftgröße in Pixel, z. B. `20px` Schriftgröße in Punkt, z. B. `18pt` Schriftgröße im Vergleich zur Schriftgröße des Elternelements, z. B. `.8em` oder `120%` Schlüsselwörter: `xx-Small` , `x-small` , `small` , `medium` , `large` , `x-large` , `xx-large` , `smaller` , `larger`
`fontStretch`	Legt die Breite der einzelnen Schriftzeichen fest. Mit diesem Attribut wird die Standardbreite der Schriftzeichen für dieses Control überschrieben. Mögliche Werte: `Condensed` `Expanded` `ExtraCondensed` `ExtraExpanded` `Medium` `Normal` (Standard) `SemiCondensed` `SemiExpanded` `UltraCondensed` `UltraExpanded` Dieses Attribut funktioniert nicht für die Elemente `Image`, `Map`, `Chart` und `HtmlDocument`.
`fontStyle`	Legt die Neigung der Schrift fest. Mit diesem Attribut wird die Standardneigung der Schriftzeichen für dieses Control überschrieben. Mögliche Werte: `italic`: kursive Schrift `normal`: normale Schrift (Standard) `oblique`: schräg gestellter Schriftstil (berechnet) Dieses Attribut funktioniert nicht für die Elemente `Image`, `Map` und `HtmlDocument`.
`fontWeight`	Legt die Schriftstärke fest. Mit diesem Attribut wird die Standardstärke der Schriftzeichen für dieses Control überschrieben. Mögliche Werte: `Black` `Bold` `DemiBold` `ExtraBlack` `ExtraBold` `ExtraLight` `Heavy` `Light` `Medium` `Normal` (Standard) `Regular` `SemiBold` `Thin` `UltraBlack` `UltraBold` `UltraLight` Dieses Attribut funktioniert nicht für die Elemente `Image`, `Map` und `HtmlDocument`.
`foreground`	Definiert die Schriftfarbe. Diese Einstellung überschreibt die Standardfarbe des Farbschemas! Mögliche Werte: Hexadezimaler Farbwert, z. B. `ff5a00` Verwenden Sie keine Raute vor dem Farbwert! Verwenden Sie keine verkürzte Schreibweise des Farbwerts! Farbcode aus der Farbpalette der Web App (vgl. (7.3.3-de) Theming), z. B. `A200`

justifyText

Legt die Textausrichtung innerhalb des Textblocks fest.

Mögliche Werte:

justify (Standard): Blocksatz
center: Zentriert
left: Linksbündig
right: Rechtsbündig

textOverflow

Gibt an, was passieren soll, wenn das Control voll ist.

Mögliche Werte:

ellipsis (Standard): Mit ... zeigen, dass der Text nicht zu Ende ist
hidden: Text abbrechen, auf ganze Wörter achten
wordBreak: innerhalb des Wortes abbrechen
allow: Text zwischen den Wörtern umbrechen

Beispiel <Paragraph>

XML

<Paragraph justifyText="justify" textOverflow="allow">
    Paragraph
    <Binding value="#test" />
</Paragraph>

Span

Das Element  wird verwendet, um Textabschnitte oder einzelne Textelemente zu formatieren und kann folgende Elemente enthalten:

Freitext
<Binding>
<Break>

<Translation>
<Link>

Das Element Span kann über folgende Attribute definiert werden:

Attribut	Beschreibung
`background`	Definiert eine Farbe für den Hintergrund des Controls. Diese Einstellung überschreibt die Standardfarbe des Farbschemas! Dieses Attribut funktioniert nicht für das Control Maps! Mögliche Werte: Hexadezimaler Farbwert, z. B. `ff5a00` Verwenden Sie keine Raute vor dem Farbwert oder eine verkürzte Schreibweise! Farbcode aus der Farbpalette der Web App (vgl. Theming), z. B. `A200`

`fontFamily`	Legt die Schriftfamilie fest. Mit diesem Attribut wird die Standardschrift der Web App für dieses Control überschrieben. Wird das Attribut auf einem Element definiert, so wird die Schriftfamilie an die Kindelemente des Elementes vererbt, sofern die Kindelemente das Attribut `fontFamily` nicht explizit gesetzt haben. Dieses Attribut funktioniert nicht für die Elemente `Image`, `Map` und `HtmlDocument`. Mögliche Werte: `MainFont`: hinterlegte Hauptschrift Fontcode aus der Font-Palette, z. B. `Font04`
`fontSize`	Legt die Schriftgröße fest. Mit diesem Attribut wird die Standardschriftgröße der Web App für dieses Control überschrieben. Dieses Attribut funktioniert nicht für die Elemente `Image`, `Map` und `HtmlDocument`. Mögliche Werte: Beliebige ganze Zahl oder Dezimalzahl mit einem Punkt als Dezimaltrennzeichen, z. B. `20` ; `20.8` ; `.9` Schriftgröße in Pixel, z. B. `20px` Schriftgröße in Punkt, z. B. `18pt` Schriftgröße im Vergleich zur Schriftgröße des Elternelements, z. B. `.8em` oder `120%` Schlüsselwörter: `xx-Small` , `x-small` , `small` , `medium` , `large` , `x-large` , `xx-large` , `smaller` , `larger`
`fontStretch`	Legt die Breite der einzelnen Schriftzeichen fest. Mit diesem Attribut wird die Standardbreite der Schriftzeichen für dieses Control überschrieben. Mögliche Werte: `Condensed` `Expanded` `ExtraCondensed` `ExtraExpanded` `Medium` `Normal` (Standard) `SemiCondensed` `SemiExpanded` `UltraCondensed` `UltraExpanded` Dieses Attribut funktioniert nicht für die Elemente `Image`, `Map`, `Chart` und `HtmlDocument`.
`fontStyle`	Legt die Neigung der Schrift fest. Mit diesem Attribut wird die Standardneigung der Schriftzeichen für dieses Control überschrieben. Mögliche Werte: `italic`: kursive Schrift `normal`: normale Schrift (Standard) `oblique`: schräg gestellter Schriftstil (berechnet) Dieses Attribut funktioniert nicht für die Elemente `Image`, `Map` und `HtmlDocument`.
`fontWeight`	Legt die Schriftstärke fest. Mit diesem Attribut wird die Standardstärke der Schriftzeichen für dieses Control überschrieben. Mögliche Werte: `Black` `Bold` `DemiBold` `ExtraBlack` `ExtraBold` `ExtraLight` `Heavy` `Light` `Medium` `Normal` (Standard) `Regular` `SemiBold` `Thin` `UltraBlack` `UltraBold` `UltraLight` Dieses Attribut funktioniert nicht für die Elemente `Image`, `Map` und `HtmlDocument`.
`foreground`	Definiert die Schriftfarbe. Diese Einstellung überschreibt die Standardfarbe des Farbschemas! Mögliche Werte: Hexadezimaler Farbwert, z. B. `ff5a00` Verwenden Sie keine Raute vor dem Farbwert! Verwenden Sie keine verkürzte Schreibweise des Farbwerts! Farbcode aus der Farbpalette der Web App (vgl. (7.3.3-de) Theming), z. B. `A200`

Beispiel

XML

<Span fontWeight="ExtraBold" foreground="GaugeAxisMiddle">
    Span
    <Binding value="#test" />
</Span>

Break

Das Element <Break> wird verwendet, um Zeilenumbrüche innerhalb eines Textabschnitts einzufügen.

Beispiel <Break>

XML

<Paragraph>
   	SoftProject GmbH
  	<Break/>
   	Am Erlengraben 3
   	<Break/>
  	D-76275 Ettlingen
   	<Break />
   	E-Mail: info@softproject.de
</Paragraph>

Binding

Das Element <Binding> wird für Data Binding verwendet.

Das Element Binding wird über folgendes Attribut definiert:

Attribut	Beschreibung
`value`	Bindet eine gültige Data-Binding-Zeichenkette. Beachten Sie, dass keine Konstanten erlaubt sind.

Beispiel <Binding>

XML

<Span>
    Span with binding
    <Break />
    value = '<Binding value="#test" />'
</Span>

Translation

Das Element <Translation> wird verwendet, um für mehrsprachige Oberflächen einen Übersetzungsschlüssel zu hinterlegen.

Das Element Translation wird über folgendes Attribut definiert:

Attribut	Beschreibung
`value`	Gibt den Übersetzungsschlüssel an.

Beispiel <Translation>

XML

<Span>
    Span with translation
    <Break />
    value = '<Translation value="$TranslationKey" />'
</Span>

Link

Das Element <Link> wird verwendet, um eine Verlinkung zu erstellen. Um die Verlinkung zu generieren, muss eine Action definiert werden.

Folgende Actions werden dabei unterstützt:

Upload Action
Download Action
Select Action
CustomAction

Beispiel

XML

<?xml version="1.0" encoding="UTF-8"?>
<DetailComponent xmlns="http://softproject.de/webapp/1.0">
	<FlowLayout>
		<Header value="Welcome to my new Web App!" />
		<TextBlock>
			<Link>
				<SelectAction
					process="myProcess.wrf"
					displayName="Click here"></SelectAction>
			</Link>
		</TextBlock>
	</FlowLayout>
</DetailComponent>