X4 Produktdokumentation
X4 Produktdokumentation
Breadcrumbs

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>

  • <Span>

  • <Translation>

  • <Link>

Paragraph

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

  • Freitext

  • <Binding>

  • <Break>

  • <Span>

  • <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



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

Span

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

  • Freitext

  • <Binding>

  • <Break>

  • <Span>

  • <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


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.

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.


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.


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

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>