.. sectionauthor:: jo, ben .. note:: XXXXXXXXXXXXXXX Status 12.10.2010: verbindlich. XXXXXXXXXXXXXXXXXXXX .. note:: XXXXXXXXXXXXXXX Status 20.10.2010: verbindlich, List[Lookup] o.ä. steht noch aus XXXXXXXXXXXXXXXXXXXX .. _ref-charts-common: ############################################################################### Gemeinsame Properties aller Charttypen ############################################################################### Die im Paket MaongoCharts versammelten Widgettypen (:ref:`ref-barchart`, :ref:`ref-linechart`, :ref:`ref-piechart`, :ref:`ref-labelbar`) haben einige gemeinsame Properties... Properties ------------------------------------------------------------------------------- **AnimationProgress** (List[Number]) *???* **AnimationElements** (List[Object]) (read-only) Die Einzelelemente des Charts (zur Verwendung in Animationen). siehe: :ref:`ref-charts-animation` **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. :ref:`ref-raster-widget-props`. 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]:: Binding an den Controller (vgl. ColumnNames). Die Property ``Values`` erhält so die TabellenSpalte mit dem Namen "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]:: Binding an den Controller (vgl. ColumnNames). Die Property ``Colors`` erwartet die gesamte Liste der Werte:: **Groups** (List[String]) Die Liste der Gruppen, die bei der Darstellung der Werte genutzt werden sollen:: 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):: **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)