Section author: jo, ben

Note

XXXXXXXXXXXXXXX Status 12.10.2010: verbindlich. XXXXXXXXXXXXXXXXXXXX

Note

XXXXXXXXXXXXXXX Status 20.10.2010: verbindlich, List[Lookup] o.ä. steht noch aus XXXXXXXXXXXXXXXXXXXX

6.2. Gemeinsame Properties aller Charttypen

Die im Paket MaongoCharts versammelten Widgettypen (BarChartWidget, LineChartWidget @, PieChartWidget, LabelBarWidget) haben einige gemeinsame Properties...

6.2.1. Properties

AnimationProgress (List[Number])

???

AnimationElements (List[Object]) (read-only)

Die Einzelelemente des Charts (zur Verwendung in Animationen).

siehe: Besonderheiten bei Chartanimationen

Controller (ChartController)

Der Controller steht den Elementen (Lines, Bars, Labels, ...) dieses Widgets über deren “ControllerProxy” Property zur Verfügung. Ist die “ValueColumn” property auf dem Controller gesetzt, dann bindet dieses Chart seine Value Property automatisch an den Controller.

HorizontalRaster (List[KeyValue]: Liste aus Key-/Value-Paaren)

Beschreibung des horizontalen Layout-Rasters. Vgl. Raster-bezogene Widget-Properties.

Beispiel: [label_links: min, spc1: 6, bar: max, spc2: 6, label_rechts: 64]

HorizontalRaster muss für horizontale Balken definiert sein (d.h. für Orientation left oder right).

Default: chart: max

VerticalRaster (List[KeyValue]: Liste aus Key-/Value-Paaren)

Beschreibung des vertikalen Layout-Rasters. Vgl. “Raster”.

Beispiel: [label_oben: min, spc1: 6, bar: max, spc2: 6, label_unten: 64]

VerticalRaster muss für vertikale Balken definiert sein (d.h. für Orientation up oder down).

Default: main: max

RasterDebugColor (Color)

Wenn gesetzt, wird ein Debug-Raster der Rasterpositionen gezeichnet.

Values (Table)

Die Tabelle bzw. Liste der darzustellenden Werte. Values wandelt eine übergenene Liste selbstätig in eine geeignete Tabelle. Zweidimensionale Daten können direkt als Tabelle oder als List[List] zugewiesen werden.

Direkte Zuweisung mit List[Number]:

<property name="Values" type="List[Number]" value="1,2,3,4" />

Binding an den Controller (vgl. ColumnNames). Die Property Values erhält so die TabellenSpalte mit dem Namen “percent”.:

<bind property="Values" to="Controller.Columns" key="percent" />

Colors (List[Color])

Die Farben, die das Chart für die einzelnen Werte nutzen soll. Hiermit werden dann Balken, Säulen, Kreissegmente oder Linien eingefärbt. Wenn mehr Elemente als Farben vorhanden sind,

Direkte Zuweisung mit List[Color]:

<property name="Colors" type="List[Color]" value="#aaa,#999,#888,#777" />

Binding an den Controller (vgl. ColumnNames). Die Property Colors erwartet die gesamte Liste der Werte:

<bind property="Colors" to="Controller.Columns" key="color" />

Groups (List[String])

Die Liste der Gruppen, die bei der Darstellung der Werte genutzt werden sollen:

<property name="Groups" type="List[String]" value="Gruppe1,,Gruppe2," />
<property name="Groups" type="List[String]" value="Gruppe1,Gruppe1,Gruppe2,Gruppe2" />

Beide Schreibweisen sind gleichbedeutend, d.h. es reicht aus, das erste Element einer Gruppe mit einem Gruppennamen zu versehen, es ist aber auch möglich, alle Elemente auszuzeichnen.

Hat die Liste nicht dieselbe Größe wie Values, so werden überzählige Elemente ignoriert bzw. benötigte weitere Elemente mit leeren Strings "" gefüllt. Ein fünfter Wert würde bei obenstehender Groups-Definition also der Gruppe2 angehören.

Binding an den Controller (vgl. ColumnNames):

<bind property="Groups" to="Controller.Columns" key="groups" />

Minimum (Number)

Default: 0

Maximum (Number)

Default: 100

AutoScale (Symbol)

Bei AutoScale=detect werden die Balken des Charts automatisch anhand der tatsächlichen Werte skaliert. Bei AutoScale=none werden stattdessen die Werte in Minimum und Maximum genutzt.

Werte: none, minimum, maximum, both, equal, detect

Default: detect

AutoScale   nutzt Daten     nutzt Minimum   nutzt Maximum   pos+neg gleich
            min   max

none                               X              X
minimum      X                                    X
maximum            X               X
both         X     X
equal        X     X                                                X
detect       X     X                                        X (wenn min < 0
                                                            und max > 0)