WaBis

walter.bislins.ch

JSG: Text Properties

Die Text Properties geben Auskunft über die Eigenschaften, welche auf das Zeichnen von Text Einfluss haben.

Neben den auf dieser Seite beschriebenen Text Properties hat auch Color Einfluss auf das Aussehen eines Textes.

Hinweis: Alle Properties sind read only, dürfen somit nicht direkt verändert werden.

TextRendering Legt fest, mit welchem Verfahren Text gezeichnet wird: 'canvas' (default), 'html'
TextClass CSS-Klasse die einem Text zugewiesen werden kann, der im HTML-Rendering TextRendering-Mode gezeichnet wird
TextColor Farbe von Texten
TextFont Schriftart
TextSize Textgrösse in Pixel
TextRotation Drehung des Textes in Grad oder Radian, siehe SetAngleMeasure()
LineHeight Zeilenabstand bei Text
FontStyle Text-Stil (normal, schräg)
FontWeight Text-Dicke (normal, fett)
TextHAlign, TextVAlign Text-Ausrichtung
TextHPad, TextVPad Text-Padding

JsGraph.TextRendering

JsGraph.TextRendering: String; ReadOnly; Init = 'Canvas' 

Das TextRendering legt fest, mit welchem Verfahren der Text gezeichnet werden soll. Das TextRendering kann beim Erzeugen des JsGraph Objektes global festgelegt werden oder mit der Funktion SetTextRendering() für jeden Text individuell eingestellt werden.

Canvas
verwendet die nativen Canvas-Funktionen. Diese Texte sind reine Grafik und können nicht selektiert werden. HTML-Auszeichnungen werden nicht interpretiert sondern 1:1 ausgegeben. Canvas-Text kann durch später gezeichnete Grafik verdeckt werden.
Html
Erzeugt Div-Elemente welche den Html-Text enthalten. Dieser Text kann in der Grafik selektiert werden. Html-Auszeichnungen werden interpretiert (z.B. Hoch-/Tiefstellen, Fett, Kursiv, Styles). Html-Text liegt immer über der Grafik.

Html-Text benötigt viele Resourcen und ist langsam und daher nur eingeschränkt für Animationen geeignet. Wenn immer wieder der selbe Text gezeichnet wird, ist der Resourcenverbrauch nicht so extrem (dank Caching).

Für statische Beschriftungen in animierten Grafiken empfiehlt sich, die Funktionen MakeSnapshot() und DrawSnapshot() zu verwenden, damit die Beschriftung nur einmal generiert werden muss und als Snapshot zur Wiederverwendung als Hintergrund herangezogen werden kann.

JsGraph.TextClass

JsGraph.TextClass: String; ReadOnly; Init = '' 

CSS Klasse, die einem Text-Element zugeordnet werden kann, um das Aussehen des Textes festzulegen. Einzelne Styles dieser Klasse können durch die verschiedenen Attribute überschrieben werden.

Die Klasse kann mit der Funktion SetTextClass() festgelegt werden.

JsGraph.TextColor

JsGraph.TextColor: String; ReadOnly; Init = 'black' 

Steuert die Farbe des Textes. Die Text-Farbe kann mit SetTextColor() vor dem Zeichnen von Text gesetzt werden.

Für das Format und Farb-Funktionen siehe Farben.

Wenn beim Setzen einer Farbe ein JsgColor Objekt verwendet wurde, wird hier der mit JsgColor.ToString() erzeugte Farb-String gespeichert.

JsGraph.TextFont

JsGraph.TextFont: String; ReadOnly; Init = 'Arial' 

Name eines oder mehrer Fonts. Wenn TextFont = '' ist, wird der Font mit TextClass festgelegt oder es wird der Font der übergeordneten Elemente geerbt.

Der Font kann mit den Funktionen SetTextFont() und SetTextAttr() gesetzt werden.

JsGraph.TextSize

JsGraph.TextSize: Number(>=0); ReadOnly; Init = 15 

Grösse des Textes in Pixel. Wenn TextSize = 0 ist, wird die Textgrösse mit TextClass festgelegt oder sie wird von übergeordneten Elementen geerbt.

Die Text Grösse kann mit den Funktionen SetTextSize() und SetTextAttr() gesetzt werden.

JsGraph.TextRotation

JsGraph.TextRotation: Number; ReadOnly; Init = 0 

Rotation des Textes in Grad oder Radian (siehe SetAngleMeasure(). Positive Werte rotieren immer im Uhrzeigersinn, unabhängig von der aktuelle gewählten Transformation (siehe SelectTrans()).

Solange keine Objekt-Transformation definiert ist, rotiert der Text immer unverzerrt, selbst wenn im Bild für die X- und Y-Achsen verschiedene Skalierungen definiert sind.

Die Text Rotation kann mit den Funktionen SetTextRotation() und SetTextAttr() gesetzt werden.

Ein den Text umschliessendes Rechteck kann mit der Funktion TextBox() gezeichnet werden.

Hinweis: Es können nur Texte rotiert werden, welche im TextRendering = 'canvas' gezeichnet werden.

JsGraph.LineHeight

JsGraph.LineHeight: Number(>=0,-1); ReadOnly; Init = 0 

Zeilenhöhe in Pixeln. Die Zeilenhöhe legt den Zeilenabstand bei mehrzeiligem Text fest. Wenn LineHeight = 0 ist, wird die Zeilenhöhe auf 100% gegsetzt. Wenn LineHeight = -1 ist, wird die Zeilenhöhe mit TextClass festgelegt oder sie wird von übergeordneten Elementen geerbt.

Die Zeilenhöhe kann mit der Funktion SetLineHeight() gesetzt werden.

JsGraph.FontStyle

JsGraph.FontStyle: String; ReadOnly; Init = 'normal'; → '', 'normal' oder 'italic'

Der Font-Style kann mit einer der Funktionen SetFontStyle(), SetFontWeight() oder SetTextAttr() gesetzt werden. Wenn FontStyle = '' ist, wird der Style mit TextClass festgelegt oder er wird von übergeordneten Elementen geerbt.

JsGraph.FontWeight

JsGraph.FontWeight: String; ReadOnly; Init = 'normal'; → '', 'normal' oder 'bold'

Das Font-Weight kann mit einer der Funktionen SetFontWeight(), SetFontStyle() oder SetTextAttr() gesetzt werden. Wenn FontWeight = '' ist, wird der Style mit TextClass festgelegt oder er wird von übergeordneten Elementen geerbt.

JsGraph.TextHAlign, TextVAlign

JsGraph.TextHAlign: String; ReadOnly; Init = 'center'; → 'left', 'center', 'right', 'justify'
JsGraph.TextVAlign: String; ReadOnly; Init = 'middle'; → 'top', 'midddle', 'bottom'

Die Text-Ausrichtung kann mit einer der Funktionen SetTextHAlign(), SetTextVAlign(), SetTextAlign() oder SetTextAttr() gesetzt werden.

JsGraph.TextHPad , TextVPad

JsGraph.TextHPad: Number(>=0); ReadOnly; Init = 0; Horizontales Padding
JsGraph.TextVPad: Number(>=0); ReadOnly; Init = 0; Vertikales Padding

Bewirkt, dass der Abstand zwischen Text und Referenzpunkt (Padding) vergrössert wird. Die Textbox GetTextBox() wird um das Padding entsprechend vergrössert. Das Text-Padding kann mit der Funktion SetTextPadding() gesetzt werden.

Weitere Infos zur Seite
Erzeugt Dienstag, 2. Februar 2016
von wabis
Zum Seitenanfang
Geändert Samstag, 28. Januar 2017
von wabis