Rule di tipo Element |
  
|
Rule di tipo Element |
|
Una Rule di tipo Element 
consente di configurare la componente fondamentale Element di un Viewer di tipo Chart, con la quale vengono agganciati i dati da rappresentare. In particolare ad ogni Element è possibile associare:
✓ un singolo valore numerico o una singola coordinata cartesiana, definita manualmente dall'utente;
✓ i record di uno specifico campo numerico della tabella del Model sottostante.
Ogni Viewer di tipo Chart deve sempre contenere almeno una Rule di tipo Element, con la quale acquisire i dati da rappresentare. |
Ogni Element è pienamente caratterizzato dalle seguenti proprietà:
✓ Name, etichetta associata al valore rappresentato dall'Element;
✓ Yvalue, XValue, coordinate numeriche verticale e orizzontale corrispondenti al valore rappresentato dall'Element;
✓ YDateTime e XDateTime, coordinate temporali verticale e orizzontale corrispondenti al valore rappresentato dall'Element;
✓ ZValue, coordinata numerica in profondità.
Le proprietà caratterizzanti una Rule di tipo Element possono essere valorizzate, selezionando dall'apposita drop-down un campo della tabella del Model referenziata dalla Rule mediante l'attributo Table Name. In particolare: ✓ la proprietà Name ammette campi qualitativi (e.g. di tipo Char o VarChar); ✓ le proprietà di tipo Value e DateTime ammettono campi quantitativi (e.g. di tipo Int o Decimal). |
L'etichetta specificata mediante la proprietà Name viene rappresentata in corrispondenza del valore associato:
✓ lungo l'asse orizzontale in caso di grafici cartesiani (e.g. spline o istogrammi);
✓ nella legenda in caso di grafici a torta o anello.
La proprietà YValue è sempre necessaria in quanto permette di identificare univocamente i dati da rappresentare:
✓ sia in caso essi siano valori espressi in coordinate cartesiane;
✓ sia in caso essi siano valori quantitativi (e.g. frequenze o percentuali) associati a caratteri di tipo qualitativo.
La proprietà XValue è efficace solo in caso si stiano rappresentando valori in coordinate cartesiane.
Viceversa, la proprietà ZValue è efficace solo in caso il grafico da rappresentare sia tridimensionale.
Ogni Element può essere incluso in una Series da cui ereditare impostazioni grafiche di tipo generale, condivise con altri Element. La proprietà Series consente di associare l'Element corrente ad una Series, specificando la Key della Rule con cui essa è stata definita.
La rappresentazione grafica degli Element può essere modificata mediante le seguenti proprietà:
✓ Color imposta, mediante un'apposita drop-down, il colore con cui l'Element viene rappresentato sul Chart;
✓ Outline definisce l'aspetto grafico del contorno dell'Element rappresentato sul Chart;
✓ TakeColorFromSeries identifica, mediante la corrispondente Key, una Rule di tipo Series dalle cui proprietà ricavare il colore con cui rappresentare l'Element sul Chart;
✓ TakeColorFromElement identifica, mediante la corrispondente Key, una Rule di tipo Element dalla proprietà Color ricavare il colore con cui rappresentare l'Element sul Chart;
✓ Trasparency imposta la trasparenza del colore con cui l'Element viene rappresentato sul Chart;
✓ ShowValue visualizza sul grafico etichette o valori corrispondenti all'Element rappresentato;
✓ LableTemplate identifica, mediante la corrispondente Key, una Rule di tipo Label con cui impostare lo stile grafico delle etichette associate all'Element corrente;
✓ SmartLabel imposta l'aspetto grafico delle etichette associate all'Element corrente mediante opzioni avanzate di allineamento e posizionamento.
La proprietà TakeColorFromSeries ricava il colore con cui rappresentare l'Element sul Chart dalle proprietà Color nella classe DefaultElement della Series referenziata. |
In caso di grafici che rappresentino gli Element mediante aree colorate (e.g. istogrammi e grafici a torte), è possibile specializzare la proprietà Color mediante trame personalizzabili.
La proprietà Hatch Style consente di scegliere, da un'apposita drop-down, la trama da utilizzare. La proprietà Hatch Color, invece, permette di impostare il colore con cui rappresentare tale trama sui singoli Element.
Le proprietà Outline e Trasparency sono efficaci solo in caso l'Element sia rappresentato sul Chart da un'area ben delimitata, come nel caso di istogrammi e grafici a torta.
Le proprietà Trasparency può assumere un qualsiasi valore intero compreso tra:
✓ 0 valore corrispondente al colore pieno;
✓ 100 valore corrispondente al colore completamente trasparente.
La proprietà SmartLabel può:
✓ essere valorizzate manualmente dall'utente;
✓ richiamare una componente di tipo Smart Label.
In particolare, per richiamare la componente associata, è necessario specificare la Key della Rule con cui essa è stata definita.
La proprietà SmartLabel è efficae solo in caso la proprietà ShowValue sia impostata a True. |
Altre proprietà consentono, invece, di dotare ogni Element di particolari componenti aggiuntive:
✓ la proprietà Annotation crea annotazioni contenenti testi o immagini da associare ad ogni Element rappresentato sul Chart;
✓ la proprietà Marker abilita e definisce l'aspetto grafico dei simboli che identificano i valori rappresentati dall'Element corrente;
✓ la proprietà Tooltip definisce il tooltip da visualizzare contestualmente ad ogni Element rappresentato sul Chart.
Le proprietà Annotation e Marker possono:
✓ essere valorizzate manualmente dall'utente;
✓ richiamare la componente del Chart ad esse associata, rispettivamente, di tipo Annotation o Element Marker.
In particolare, per richiamare la componente associata, è necessario specificare la Key della Rule con cui essa è stata definita.
La proprietà Marker è efficace in caso di grafici che rappresentano coordinate cartesiane, come linee e spline. |
Infine ogni Element può essere dotato di un opportuno intervallo di confidenza, mediante le seguenti proprietà:
✓ ErrorHighValue definisce un intervallo con estremi l'Element ed il valore specificato, corrispondente all'errore massimo assoluto;
✓ ErrorLowValue definisce un intervallo con estremi l'Element ed il valore specificato, corrispondente all'errore minimo assoluto;
✓ ErrorMinusOffset definisce un intervallo di estremo superiore l'Element ed ampiezza pari al valore specificato;
✓ ErrorMinusPercent simile a ErrorMinusOffset, ma il valore specificato definisce l'ampiezza come percentuale del valore rappresentato dall'Element;
✓ ErrorOffset definisce un intervallo centrato nell'Element e semi-ampiezza pari al valore specificato;
✓ ErrorPercent simile a ErrorOffset, ma il valore specificato definisce la semi-ampiezza come percentuale del valore rappresentato dall'Element;
✓ ErrorPlusOffset definisce un intervallo di estremo inferiore l'Element ed ampiezza pari al valore specificato;
✓ ErrorPlusPercent simile a ErrorPlusOffset, ma il valore specificato definisce l'ampiezza come percentuale del valore rappresentato dall'Element.
Le proprietà ErrorOffset e ErrorPercent permettono di definire intervalli di confidenza a due code. Tutte le altre proprietà, invece, definiscono intervalli di confidenza ad una coda. |
A livello di Element è anche possibile personalizzare gli assi associati agli elementi rappresentati, mediante le proprietà:
✓ AxisMarker definisce una la linea o una striscia colorata con cui identificare un valore o un intervallo di valori lungo un dato asse;
✓ XAxisTick e YAxisTick consentono di modificare le proprietà grafiche delle componenti di tipo Axis Tick predefinite dal sistema.
La proprietà AxisMarker può:
✓ essere valorizzate manualmente dall'utente;
✓ richiamare una componente di tipo Axis Marker.
In particolare, per richiamare la componente associata, è necessario specificare la Key della Rule con cui essa è stata definita.