I Viewer: esposizione dei dati > Il Viewer Chart

La definizione delle componenti di un Chart avviene nel Chart Editor, mediante la definizione di regole grafiche, dette Rule. In particolare, ogni componente è sempre caratterizzata da almeno una Rule, la quale consente di:

✓ associarvi eventuali dati del Model sottostante da rappresentare,

✓ personalizzarne l'aspetto grafico.

La creazione di una nuova Rule avviene mediante il selettore di componenti, posto sulla sinistra della UI del Chart Editor. Selezionando una componente, la corrispondente Rule viene aggiunta all'elenco delle regole nel riquadro dedicato.

Ogni Rule può essere abilitata o disabilitata mediante l'apposito flag, esposto nel riquadro contenente l'elenco delle regole impostate. Inoltre, selezionando una regola con il tasto destro del mouse, è possibile accedere ad uno specifico menù a tendina. Esso espone opzioni per:

✓ eliminare la regola selezionata;

✓ copiarla, tagliarla o copiarla;

✓ ordinarla rispetto alle altre regole presenti in elenco.

Ogni Rule di un Chart è caratterizzata dai seguenti attributi:

✓ Type, tipo di componente a cui la regola si riferisce;

✓ Key, identificativo univoco della regola;

✓ Table Name, eventuale tabella del Model dai cui valori dipendono la componente e gli elementi definitori della regola stessa.

Ogni Key identifica in modo univoco una Rule impostata su uno specifico componente del Chart. In particolare:

✓ se una Rule con certo Type ed una data Key non esiste, viene creata la corrispondente componente sul Chart;

✓ se una Rule di un certo Type ed una data Key già esiste, le corrispondente componente del Chart viene modificata;

✓ se una Rule di un certo Type è priva di Key, la corrispondente componente viene creata sul Chart, ma risulta non modificabile da nuove Rule.

Tutte le Rule di tipo Chart condividono la stessa Key (predefinita dal sistema e non modificabile), in quanto ogni Viewer Chart può comporsi di un'unica componente di tipo Chart.

In caso il campo Table Name sia vuoto, la corrispondente Rule viene applicata una sola volta. Viceversa, se esso referenzia una specifica tabella del Model sottostante, la Rule viene applicata per ogni record del dataset corrispondente.

Eventuali Rule associate a tabelle prive di record sono inefficaci.

Le Rule di un Chart si contraddistinguono anche per i diversi colori con cui vengono visualizzate nel riquadro ad esse dedicato. In particolare:

✓ il colore bianco identifica regole la cui definizione è indipendente dall'ordine con cui vengono aggiunte al Chart;

✓ il colore verde identifica regole la cui definizione dipende da Rule precedentemente definite sullo stesso Chart;

✓ il colore giallo identifica regole di tipo Chart.

La definizione di una Rule avviene mediante la configurazione di opportune proprietà grafiche, esposte nel visualizzatore delle Property del Chart Editor. Esso dispone di alcuni tasti e flag con cui semplificare la navigazione delle proprietà. In particolare è possibile:

✓ ordinare le proprietà per categoria (Sort By Catogory ) o per nome (Sort Alphabetical );

✓ filtrare le proprietà per nome, mediante l'apposito riquadro;

✓ visualizzare le sole proprietà modificate (Non Default).

Il visualizzatore delle Property espone proprietà grafiche ed elementi definitori contestuali alla regola attualmente selezionata, i quali possono essere valorizzati mediante:

✓ valori costanti, inseriti manualmente dall'utente;

✓ valori contenuti in un campo della tabella del Model associata alla Rule, selezionati mediante opportune drop-down.

Eventuali valori NULL nei campi associati ad una proprietà grafica, non apportano alcuna modifica sulla componente corrente del Chart.

In caso due o più Rule condividano lo stesso Type e la stessa Key, l'aspetto grafico della corrispondente componente è soggetto a modifica. In particolare la sequenza di applicazione di tali regole ne ricalca l’ordine, dal basso verso l’alto. Tra proprietà comuni a Rule con stesso Type e stessa Key, la prima in elenco sovrascrive tutte le seguenti.

In base a questo principio di override, le proprietà grafiche definite da Rule di tipo Chart vengono combinate per definire l’aspetto grafico dell’unico componente di tipo Chart presente nel Viewer.

Le classi di proprietà con prefisso Default (e.g. DefaultChartArea, Default Series, DefaultElement, DefaultAxis e DefaultLegendBox) consentono di specificare stili grafici generali per la corrispondente componente che si possono propagare alle componenti sottostanti. In particolare classi di tipo Default in una Rule di tipo Chart consentono di generalizzare l'aspetto grafico di tutte le componenti del Viewer. Tuttavia, la definizioni di proprietà sulle componenti di livelli inferiori, prevalgono sulle corrispondenti proprietà delle classi Default secondo una logica di override bottom-up.

Ogni Chart dispone delle seguenti componenti predefinite:

✓ MainChartArea;

✓ XAxis, YAxis e ZAxis;

✓ XAxisTick e YAxisTick;

✓ MainLegendBox.

Esse possono essere modificate, sulla base delle precedenti logiche di override. In particolare, per modificare la definizione delle corrispondenti proprietà grafiche, è necessario creare Rule del tipo corrispondente la cui Key coincida con il nome effettivo della componente predefinita.

In alternativa, è possibile anche intervenire sulle proprietà delle classi:

✓ MainChartArea e MainLegendBox disponibili in Rule di tipo Chart;

✓ XAxis, YAxis e ZAxis disponibili in Rule di tipo Series, ChartArea e Chart;

✓ XAxisTick e YAxisTick disponibili in Rule di tipo Element.

APPROFONDIMENTI E ARGOMENTI CORRELATI

& Rule di tipo Element

& Rule di tipo Series

& Rule di tipo ChartArea

& Rule di tipo Chart

& Rule di tipo Axis

& Rule di tipo Legend Box e Legend Entry

& Rule di tipo Axis Details