Il Sub-Report è un elemento che consente di includere il contenuto di una Page all’interno di un’altra. Esso è rappresentato nella Page con un riquadro a sfondo tratteggiato.
Le Component di tipo Sub-Report sono utilizzate per costruire report complessi in cui è possibile comporre le Page inglobando altre Page. Ciò permette, in molti casi, di semplificare la fase di progettazione e di ottimizzare i tempi di visualizzazione dell'output.
Il Sub-Report può essere inserito in:
✓ una Page;
✓ una Band;
✓ un Panel.
Inserendo un nuovo Sub-Report, è automaticamente creata una nuova Page del Document. Essa prende il nome di Sub Report Page.
La maschera Select Sub-Report Page, che si apre con un doppio click sul riquadro tratteggiato della Page principale, permette di selezionare la Page da collegare alla Page corrente.
Eventuali Sub Report Page, create e successivamente scollegate dalla Page principale, devono essere, alternativamente: ✓ cancellate, con il pulsante Delete Page della barra degli strumenti Standard del Report Designer; ✓ disattivate mediante l'apposita proprietà della classe Behavior della Page. |
È possibile creare gerarchie di Sub-Report annidati inserendo ulteriori riquadri di tipo Sub-Report nelle Sub Report Page |
Ogni Sub-Report può essere ulteriormente configurato mediante le proprietà esposte nel riquadro delle Properties. Le proprietà sono classificate nei seguenti gruppi:
✓ Sub Report, proprietà principali di configurazione del Sub-Report;
✓ Position, proprietà di posizionamento del Sub-Report;
✓ Appearance, proprietà per modificare l'aspetto grafico del Sub-Report;
✓ Behavior, proprietà per impostare il comportamento del Sub-Report Box all'interno di una Page del Document;
✓ Design, proprietà per modificare la visibilità del Sub-Report all'interno di una Page del Document.
La proprietà principale del gruppo Sub Report è Sub Report Page. Essa permette di selezionare, nella maschera Select Sub-Report Page, la Page da includere nella Page corrente.
Le proprietà principali del gruppo Position sono le seguenti:
✓ Left definisce la distanza della cella dal margine sinistro della Page;
✓ Top definisce la distanza della cella dal margine superiore della Page;
✓ Width definisce la larghezza della cella;
✓ Height definisce l'altezza della cella.
L'unità di misura delle distanze, definite nelle proprietà Position, è quella impostata nella Status Bar del Report Designer. |
Le proprietà principali del gruppo Appearance sono le seguenti:
✓ Brush permette di selezionare la forma ed il colore di sfondo del Sub-Report;
✓ Border permette di disegnare il bordo del Sub-Report;
✓ Conditions consente di definire un insieme di regole di formattazione condizionale del Sub-Report;
✓ Component Style consente di definire lo stile del Sub-Report, attraverso lo Style Designer.
In particolare, la proprietà Border si imposta attraverso la maschera omonima, manualmente nel tab Simple o graficamente nel tab Advanced.