Sub-Report

Navigation:  I Viewer: esposizione dei dati > Il Viewer Document > Le componenti di una Page > Component >

Sub-Report

Previous pageReturn to chapter overviewNext page

Il Sub-Report StiSubReport è 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.

 

warning

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.

 

info

È 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.

 

info

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.