====== API: Chart Controls ======

Riferimento API per grafici e visualizzazioni.

===== TWvdSChart =====

Control grafico base per tutti i tipi di diagramma.

==== Namespace ====

''WvdS.UI.Controls.Charts''

==== PXAML ====

<code xml>
<Chart Title="Sales Overview">
  <Chart.Series>
    <LineSeries Title="Revenue"
                ArgumentDataMember="Month"
                ValueDataMember="Revenue"
                DataSource="{Binding SalesData}" />
    <BarSeries Title="Orders"
               ArgumentDataMember="Month"
               ValueDataMember="OrderCount"
               DataSource="{Binding SalesData}" />
  </Chart.Series>
  <Chart.Legend Position="Right" />
</Chart>
</code>

==== Properties ====

| Property | Tipo | Default | Descrizione |
^ Title | string | '' | Titolo grafico |
^ Series | TWvdSSeriesCollection | nil | Serie dati |
^ Legend | TWvdSLegend | nil | Legenda |
^ AxisX | TWvdSAxis | nil | Asse X |
^ AxisY | TWvdSAxis | nil | Asse Y |
^ Palette | TWvdSPalette | nil | Palette colori |
^ EnableZoom | Boolean | False | Zoom attivo |
^ EnablePan | Boolean | False | Pan attivo |

==== Events ====

| Event | Firma | Descrizione |
^ OnSeriesClick | TSeriesClickEvent | Click su punto dati |
^ OnLegendClick | TLegendClickEvent | Click su legenda |

----

===== TWvdSSparkline =====

Grafici inline compatti.

==== Namespace ====

''WvdS.UI.Controls.Charts''

==== PXAML ====

<code xml>
<Sparkline Type="Line"
           Data="{Binding TrendData}"
           Width="100" Height="20" />
<Sparkline Type="Bar"
           Data="{Binding Values}"
           HighlightMin="True" HighlightMax="True" />
</code>

==== Properties ====

| Property | Tipo | Default | Descrizione |
^ Type | TWvdSSparklineType | stLine | Line, Bar, WinLoss, Area |
^ Data | TDoubleArray | nil | Punti dati |
^ HighlightMin | Boolean | False | Evidenzia minimo |
^ HighlightMax | Boolean | False | Evidenzia massimo |
^ NegativeColor | TWvdSColor | clRed | Colore valori negativi |

----

===== Tipi Serie =====

Tutte le serie condividono property base comuni:

| Property | Tipo | Descrizione |
^ Title | string | Titolo serie |
^ DataSource | IEnumerable | Sorgente dati |
^ ArgumentDataMember | string | Campo valore X |
^ ValueDataMember | string | Campo valore Y |
^ Color | TWvdSColor | Colore |
^ Visible | Boolean | Visibile |

----

===== TWvdSLineSeries =====

Grafico a linee.

==== PXAML ====

<code xml>
<LineSeries Title="Temperature"
            ArgumentDataMember="Date"
            ValueDataMember="Temp"
            MarkerType="Circle"
            LineStyle="Solid" />
</code>

==== Properties ====

| Property | Tipo | Default | Descrizione |
^ MarkerType | TWvdSMarkerType | mtNone | None, Circle, Square, Triangle |
^ MarkerSize | Integer | 8 | Dimensione marker |
^ LineStyle | TWvdSLineStyle | lsSolid | Solid, Dash, Dot |
^ LineWidth | Integer | 2 | Spessore linea |

----

===== TWvdSAreaSeries =====

Grafico ad area.

==== PXAML ====

<code xml>
<AreaSeries Title="Revenue"
            ArgumentDataMember="Month"
            ValueDataMember="Amount"
            Opacity="0.7" />
</code>

==== Properties ====

| Property | Tipo | Default | Descrizione |
^ Opacity | Double | 0.5 | Trasparenza (0-1) |
^ ShowLine | Boolean | True | Mostra linea superiore |

----

===== TWvdSBarSeries =====

Grafico a barre.

==== PXAML ====

<code xml>
<BarSeries Title="Sales"
           ArgumentDataMember="Product"
           ValueDataMember="Quantity"
           BarWidth="0.8" />
</code>

==== Properties ====

| Property | Tipo | Default | Descrizione |
^ BarWidth | Double | 0.6 | Larghezza barra (0-1) |
^ CornerRadius | Integer | 0 | Raggio angoli |
^ ShowLabels | Boolean | False | Mostra valori |

----

===== TWvdSPieSeries =====

Grafico a torta.

==== PXAML ====

<code xml>
<Chart>
  <PieSeries ArgumentDataMember="Category"
             ValueDataMember="Value"
             InnerRadius="0"
             StartAngle="0"
             ShowLabels="True" />
</Chart>
</code>

==== Properties ====

| Property | Tipo | Default | Descrizione |
^ InnerRadius | Double | 0 | Foro donut (0=Pie) |
^ StartAngle | Double | 0 | Angolo iniziale |
^ ShowLabels | Boolean | True | Mostra etichette |
^ ExplodeOffset | Double | 0 | Distanza segmenti |

----

===== TWvdSFunnelSeries =====

Grafico a imbuto per sales funnel.

==== PXAML ====

<code xml>
<Chart>
  <FunnelSeries ArgumentDataMember="Stage"
                ValueDataMember="Count"
                NeckHeight="0.3"
                NeckWidth="0.3" />
</Chart>
</code>

==== Properties ====

| Property | Tipo | Default | Descrizione |
^ NeckHeight | Double | 0.3 | Altezza collo (0-1) |
^ NeckWidth | Double | 0.3 | Larghezza collo (0-1) |
^ GapRatio | Double | 0 | Distanza tra segmenti |

----

===== TWvdSScatterSeries =====

Grafico a dispersione.

==== PXAML ====

<code xml>
<ScatterSeries ArgumentDataMember="X"
               ValueDataMember="Y"
               MarkerType="Circle"
               MarkerSize="10" />
</code>

----

===== TWvdSBubbleSeries =====

Grafico a bolle.

==== PXAML ====

<code xml>
<BubbleSeries ArgumentDataMember="X"
              ValueDataMember="Y"
              SizeDataMember="Size"
              MinBubbleSize="10"
              MaxBubbleSize="50" />
</code>

==== Properties ====

| Property | Tipo | Default | Descrizione |
^ SizeDataMember | string | '' | Campo dimensione bolla |
^ MinBubbleSize | Integer | 10 | Dimensione minima bolla |
^ MaxBubbleSize | Integer | 50 | Dimensione massima bolla |

----

===== TWvdSCandlestickSeries =====

Grafico candlestick per dati di borsa.

==== PXAML ====

<code xml>
<CandlestickSeries ArgumentDataMember="Date"
                   OpenDataMember="Open"
                   HighDataMember="High"
                   LowDataMember="Low"
                   CloseDataMember="Close" />
</code>

==== Properties ====

| Property | Tipo | Default | Descrizione |
^ OpenDataMember | string | '' | Prezzo apertura |
^ HighDataMember | string | '' | Prezzo massimo |
^ LowDataMember | string | '' | Prezzo minimo |
^ CloseDataMember | string | '' | Prezzo chiusura |
^ UpColor | TWvdSColor | clGreen | Colore guadagno |
^ DownColor | TWvdSColor | clRed | Colore perdita |

----

===== TWvdSRadarSeries =====

Grafico radar/spider.

==== PXAML ====

<code xml>
<Chart ChartType="Radar">
  <RadarSeries ArgumentDataMember="Skill"
               ValueDataMember="Score"
               Fill="True"
               FillOpacity="0.3" />
</Chart>
</code>

----

===== TWvdSTreeMapSeries =====

Visualizzazione TreeMap.

==== PXAML ====

<code xml>
<Chart ChartType="TreeMap">
  <TreeMapSeries LabelDataMember="Name"
                 ValueDataMember="Size"
                 GroupDataMember="Category" />
</Chart>
</code>

----

===== TWvdSSankeyDiagram =====

Diagramma di flusso Sankey.

==== PXAML ====

<code xml>
<SankeyDiagram DataSource="{Binding FlowData}"
               SourceDataMember="From"
               TargetDataMember="To"
               WeightDataMember="Value" />
</code>

==== Properties ====

| Property | Tipo | Default | Descrizione |
^ SourceDataMember | string | '' | Nodo sorgente |
^ TargetDataMember | string | '' | Nodo destinazione |
^ WeightDataMember | string | '' | Intensita flusso |

----

===== TWvdSWaterfallSeries =====

Grafico waterfall.

==== PXAML ====

<code xml>
<WaterfallSeries ArgumentDataMember="Category"
                 ValueDataMember="Change"
                 StartValue="1000"
                 ShowTotal="True" />
</code>

==== Properties ====

| Property | Tipo | Default | Descrizione |
^ StartValue | Double | 0 | Valore iniziale |
^ ShowTotal | Boolean | True | Mostra totale |
^ PositiveColor | TWvdSColor | clGreen | Colore positivo |
^ NegativeColor | TWvdSColor | clRed | Colore negativo |

----

===== Vedi anche =====

  * [[.:control-bibliothek|Libreria Control]]
  * [[.:api-controls-gauges|API Gauges]]
  * [[.:api-controls-data|API Data Controls]]