La classe di property Events |
  
|
La classe di property Events |
|
Le proprietà della classe Events sono presenti in tutti gli elementi, siano essi Page, Band o Component. Esse sono accessibili selezionando il pulsante 
relativo all' Events Tab del riquadro Properties.
Un evento è un segnale che informa il Viewer Document di IrionEDM che si è verificato qualcosa di importante. Gli eventi consentono anche la comunicazione tra diverse attività.
Le proprietà sono, in questo caso, gli eventi stessi, definiti attraverso routine che si scrivono con l'ausilio di un Event Editor. Esso si attiva dalla cella a destra di quella contenente l'etichetta della proprietà.
La routine deve essere scritta nel linguaggio (C# o VB.net) specificato nel Report Setup. Si presuppone una conoscenza adeguata del linguaggio di programmazione adottato. |
L'utilizzo di proprietà della classe Events permette di sovrascrivere in modo opportuno le proprietà di un report, in base al verificarsi di particolari situazioni in fase di visualizzazione dell'output. Ciò può risultare particolarmente utile al fine di ottenere comportamenti interattivi. |
Esiste un insieme di eventi comuni a tutti gli elementi. Inoltre, per ciascun elemento, esistono ulteriori eventi configurabili che permettono di specializzarne il comportamento. In modo analogo al Property Tab, gli eventi sono organizzati nei seguenti gruppi:
✓ Mouse Events, eventi che si generano in corrispondenza di azioni del mouse;
✓ Navigation Events, eventi che si generano in corrispondenza di azioni di navigazione;
✓ Print Events, eventi che si generano in fase di stampa;
✓ Render Events, eventi che si generano in fase di visualizzazione;
✓ Value Events, eventi relativi ai valori visualizzati.
Si riporta un esempio elementare relativo all'utilizzo di routine programmate all'interno di una proprietà della classe Events:
EVENTO CLICK Quando ad esempio l'utente fa clic sulla visualizzazione di un report, quest'ultimo può generare un evento Click e chiamare una routine che gestisce tale evento. |
Gli eventi del gruppo Mouse Events sono i seguenti:
✓ Click si attiva al click sull'elemento in visualizzazione;
✓ Double Click si attiva al doppio click sull'elemento in visualizzazione.
Gli eventi del gruppo Navigation Events sono i seguenti:
✓ Get Bookmark si attiva in presenza di un segnalibro;
✓ Get Hyperlink si attiva in corrispondenza di un collegamento ipertestuale.
Gli eventi del gruppo Print Events sono i seguenti:
✓ After Print si attiva dopo la stampa;
✓ Before Print si attiva prima della stampa.
Gli eventi del gruppo Render Events sono i seguenti:
✓ Begin Render si attiva all'inizio della visualizzazione del report;
✓ Column Begin Render si attiva all'inizio della visualizzazione di una colonna del report;
✓ Column End Render si attiva al termine della visualizzazione di una colonna del report;
✓ End Render si attiva al termine della visualizzazione del report;
✓ Rendering si attiva in fase di visualizzazione del report.
Gli eventi del gruppo Value Events sono i seguenti:
✓ Get Excel Sheet si attiva in presenza di un calcolo per un foglio di lavoro di Excel®;
✓ Get Tag si attiva in presenza di un tag;
✓ Get Tool Tip si attiva in presenza di un tool tip.