DEFCHART
Consente di definire un oggetto di tipo grafico all'interno di una videata.
La fonte dati del controllo è una struttura dinamica.
La modifica dei dati sulla struttura si riflette automaticamente sul componente grafico senza necessità di ulteriori operazioni.
Sulle videate web la fonte dati si basa un una collezione.
Anche in questo caso la modifica dei dati presenti al suo interno si riflette automaticamente sul componente grafico.
Nel caso in cui si debbano eseguire modifiche massive è possibile sospendere l'aggiornamento del controllo video tramite la specifica '@SUSPENDEDVIDREFRESH.
Non è possibile utilizzare il grafico sulla rappresentazione a pannello della videata.
Parametri
| Parametro | Definizione | I/O | Versione traduttore | SMP | |
|---|---|---|---|---|---|
| ID | Stringa | ||||
| IDCHART | Intero | ||||
| POS | |||||
| DIM | |||||
| GRID | |||||
| COLLEZIONE | |||||
| TIT | Stringa | ||||
| TITASSEX | Stringa | ||||
| TITASSEY | Stringa | ||||
| LEGENDA | Intero | ||||
| ETICHETTE | Intero | ||||
| GRIGLIA | Intero | ||||
| POSIZIONELEGENDA | Enumerazione | ||||
| AZIONE | |||||
| SERIESELEZIONATA | Variabile | ||||
| VALORESERIESELEZIONATA | Variabile | ||||
| RIGASERIESELEZIONATA | Variabile | ||||
| IDMENU | Stringa | ||||
| DISABILITATO | Condizione | ||||
| GRUPPO | |||||
| CATEGORIE | |||||
| SERIE | |||||
| RIDIMENSIONABILE | |||||
| STRUTTURA | Stringa | ||||
| SFONDOTRASPARENTE | Intero | ||||
| TABELLARIEPILOGATIVA | Intero | ||||
| STACK | |||||
| EXPANDER | |||||
| DOCK | |||||
| PERSONALIZZABILE | Intero | ||||
| LINKTO |
ID
Consente di definire l'identificativo univoco del controllo.
Viene utilizzato dall'ambiente per gestire le personalizzazioni effettuate durante l'esecuzione del programma.
IDCHART
Consente di indicare la variabile che identifica il controllo grafico all'interno della videata.
POS
Consente di definire la posizione del controllo rispetto al contenitore.
DIM
Dimensione del controllo.
Consente di indicare l'altezza e la larghezza. Per entrambi è possibile specificare l'unità di misura.
DIM[Altezza [UnitàMisura], Larghezza [UnitàMisura]]
L'unità di misura può essere: 'C' per il posizionamento a caratteri e 'P' per il posizionamento in pixel. L'indicazione è opzionale, se omesso si assume 'C' come default.
GRID
Consente di definire l'attached property riferita ad un pannello grid.
COLLEZIONE
Consente di indicare la collezione da cui il grafico ricava i suoi dati.
TIT
Consente di definire il titolo del grafico, il quale viene visualizzato all'interno del controllo sopra il grafico vero e proprio.
TITASSEX
Consente di definire il titolo dell'asse X, il quale viene visualizzato al di sotto del grafico, dopo l'ascissa e prima della legenda.
TITASSEY
Consente di definire il titolo dell'asse Y, il quale viene visualizzato alla sinistra del grafico, prima dell'ordinata.
LEGENDA
Consente di indicare se visualizzare o meno la legenda del grafico.
Di default la legenda è sempre visualizzata.
ETICHETTE
Consente di indicare se visualizzare o meno i titoli legati agli assi del grafico.
Di default le etichette sono sempre visualizzate.
I valori ammessi sono:
| Valore | Descrizione |
|---|---|
| 0 | Non visualizzare le etichette |
| 1 | Visualizza le etichette |
GRIGLIA
Consente di indicare se visualizzare o meno la griglia di disegno del grafico.
I valori ammessi sono:
| Valore | Descrizione |
|---|---|
| 0 | Non visualizzare la griglia |
| 1 | Visualizza la griglia |
POSIZIONELEGENDA
Consente di definire la posizione della legenda all'interno del grafico.
Parametro enumerato, può assumere i seguenti valori:
| Valore | Descrizione |
|---|---|
ALTO | La legenda viene posizionata sopra il grafico |
BASSO | La legenda viene posizionata sotto il grafico |
SINISTRA | La legenda viene posizionata a sinistra del grafico |
DESTRA | La legenda viene posizionata a destra del grafico |
DESTRAALTO | La legenda viene posizionata a destra nel vertice alto del grafico |
AZIONE
Consente di definire la callback da eseguire quando si seleziona un membro della serie del grafico.
SERIESELEZIONATA
Consente di indicare la variabile che verrà valorizzata con il nome della serie selezionata.
Tale gestione viene abilitata solo se il parametro AZIONE è specificato nella definizione del controllo e verrà valorizzata prima dell'esecuzione della callback.
VALORESERIESELEZIONATA
Consente di indicare la variabile che verrà valorizzata con il valore selezionato dall'utente tramite il click sul mouse.
Tale gestione viene abilitata solo se il parametro AZIONE è specificato nella definizione del controllo è verrà valorizzata prima dell'esecuzione della callback.
RIGASERIESELEZIONATA
Consente di indicare la variabile che verrà valorizzata con il valore della riga della struttura dinamica corrispondente al valore selezionato attraverso il click sul mouse.
Tale gestione viene abilitata solo se il parametro AZIONE è specificato nella definizione del controllo è verrà valorizzata prima dell'esecuzione della callback.
IDMENU
Consente di definire l'identificativo univoco del menu contestuale da associare al grafico.
DISABILITATO
Consente di disabilitare l'interattività del grafico al verificarsi di una determinata condizione.
GRUPPO
Consente di definire un raggruppamento a cui associare la singola serie.
CATEGORIE
Consente di indicare le categorie del grafico che si sta definendo.
SERIE
Consente di indicare il dato da analizzare all'interno di un grafico.
Possono essere definite diverse serie differenti, a seconda dell'analisi che si deve eseguire.
RIDIMENSIONABILE
Consente di indicare in che modo è possibile ridimensionare la griglia.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
TUTTO | L'oggetto si ridimensionerà sia verso destra che verso il basso |
DESTRA | L'oggetto si ridimensionerà solamente verso destra |
BASSO | L'oggetto si ridimensionerà solamente verso il basso |
NESSUNO | L'oggetto diventerà un oggetto NON ridimensionabile |
STRUTTURA
Consente di indicare il nome della struttura dinamica su cui si basa il grafico.
SFONDOTRASPARENTE
Consente di definire il livello di contrasto tra la videata e l'oggetto.
Se il valore è 0, il controllo viene disegnato sopra un rettangolo di colore bianco.
Se invece il valore è 1, il controllo viene disegnato sopra un rettangolo dello stesso colore della videata.
In questo modo è possibile integrare perfettamente il controllo all'interno della videata.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
TABELLARIEPILOGATIVA
Consente di inserire una tabella riepilogativa di tutti i valori delle serie, categoria per categoria, al fondo del grafico.
In questo modo lo spazio occupato dal grafico viene ridotto in favore di una migliore leggibilità.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
STACK
Consente di definire l'attached property riferita ad un pannello stack.
EXPANDER
Consente di definire l'attached property riferita ad un pannello expander.
DOCK
Consente di indicare se il controllo deve occupare tutto lo spazio del DockPanel in verticale e/o in orizzontale.
PERSONALIZZABILE
Consente di definire se il controllo grafico è personalizzabile dall'utente in fase di runtime.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
LINKTO
Consente di definire un legame tra due controlli esistenti all'interno della stessa videata.
Esempi
Esempio
'@DEFTOOLBAR IDTOOLBAR["TOOLBAR"] _
BOTTONE[IDBOTTONE["SYS_EXIT"] AZIONE[Exit()]] _
BOTTONE[IDBOTTONE["SYS_EXIT_ESC"] AZIONE[Exit()] INVISIBILE[1]]
'@DEFVID DIM[20,70] NOME[Videata] ID["VIDEATA"] TIT["Titolo Videata"] TOOLBAR[IDTOOLBAR["TOOLBAR"]]
'@DEFGRIDPANEL NOME[GridPanel] ID["GridPanel"] _
COLONNA[LUNGHEZZA[70] LAYOUT[#DINAMICO]] _
RIGA[ALTEZZA[20] LAYOUT[#DINAMICO]]
'@DEFCHART IDCHART[IdChart] ID["CHART"] DIM[1,1] POS[1,1] _
STRUTTURA[Structure] TITASSEX["Titolo Asse X"] TITASSEY["Titolo Asse Y"] _
TIT["Titolo Grafico"] LEGENDA[1] _
SERIESELEZIONATA[SelectrdSerie] _
CATEGORIE[VAR["art"] FMT[TESTO]] _
SERIE[VAR["magQty"] SCHEMA["LINEA"] ETICHETTE[TESTO[#PERCENTUALE]] NOMESERIE["In magazzino"]] _
SERIE[VAR["cadPrice"] SCHEMA["BARRA"] ETICHETTE[TESTO[#ASSEX]] NOMESERIE["Prezzo cad."] SCALA[#SECONDARIA]] _
SERIE[VAR["inOrder"] SCHEMA["LINEA"] NOMESERIE["Articoli in ordine"]] _
GRID[COL[1] RIGA[1] COLDIN[1] RIGADIN[1]]
'@ENDGRIDPANEL NOME[GridPanel]
'@RUNVID
...
'@SRP Load()
GoSub DefChartData
Return
...
'@SR DefChartData
' Definizione variabili struttura
DIM art[STRING]
DIM cadPrice[DOUBLE]
DIM magQty[INT]
DIM inOrder[INT]
' Definizione struttura
'@DEFDYNSTRUCT STRUTTURA[Structure] CAMPI[art, magQty, cadPrice, inOrder]
' Valorizzazione variabili e popolamento campi struttura
art="Maglie":magQty=15:cadPrice=1:inOrder=100
'@ADDDYNSTRUCT STRUTTURA[Structure] CAMPI[art, magQty, cadPrice, inOrder]
art="Pantaloni":magQty=22:cadPrice=1.25:inOrder=90
'@ADDDYNSTRUCT STRUTTURA[Structure] CAMPI[art, magQty, cadPrice, inOrder]
art="Calze":magQty=50:cadPrice=2.10:inOrder=80
'@ADDDYNSTRUCT STRUTTURA[Structure] CAMPI[art, magQty, cadPrice, inOrder]
art="Felpe":magQty=1:cadPrice=1.95:inOrder=70
'@ADDDYNSTRUCT STRUTTURA[Structure] CAMPI[art, magQty, cadPrice, inOrder]
Return
...
'@SRP Exit()
'@EXITWINDOW
Return