Span

L’oggetto span rappresenta una singola informazione rappresentata all’interno di una box. Se la box contiene più di uno span, allora i loro valori verranno concatenati. E’ possibile creare span manualmente, con il menù contestuale dell’oggetto box, oppure tirando colonne della query o altri oggetti sulla box che ne deve contenere l’espressione.

Tutorial report
Video corso: Box e Span per la stampa

Nome: per gli span non è necessario modificare questa proprietà, che viene gestita automaticamente dal sistema.

Descrizione: se l’espressione dello span è vuota, il campo descrizione rappresenta il valore dello span, cioè il testo che verrà stampato.

Espressione: questa proprietà permette di modificare l’espressione dello span, cioè quello che verrà stampato a video. Normalmente viene selezionata una colonna della query del report, ma è possibile inserire qualsiasi espressione valida. Vedi anche:

Dominio/Lista Valori: l’espressione dello span può riferirsi ad un oggetto dominio, oppure ad una lista che ne elenca i possibili valori. In questo modo lo span potrà essere rappresentato a video in modo decodificato, magari mostrando anche un’icona, se essa è associata alle costanti della lista valori.

Stile visuale: è lo stile visuale che verrà applicato allo span. Se non specificato, verrà usato lo stile della box. Può essere modificata a runtime con la proprietà VisualStyle.

Adattamento immagine: se lo span contiene una referenza ad una colonna BLOB che contiene un immagine, questa proprietà indica come essa deve essere ridimensionata nei confronti delle dimensioni della box. Può essere modificata a runtime con la proprietà Stretch.

• Automatico: se il report è in anteprima viene usato Nessuno, se invece è stampato su PDF viene usato Ingrandisci.
• Nessuno: L'immagine non viene adattata ma conserva le dimensioni originali.
• Riempi: L'immagine non viene adattata ma conserva le dimensioni originali.
• Ingrandisci: Adatta l'immagine alle dimensioni della box, preservando le proporzioni dell'immagine. Quindi se l'immagine è più larga che alta, rimarrà uno spazio non occupato dall'immagine sopra e sotto la stessa. Viceversa se l'immagine è più alta, rimarranno spazi a sinistra e a destra dell'immagine.
• Taglia: Adatta l'immagine alle dimensioni della box, cercando di coprire completamente la box stessa mantenendo le proporzioni dell'immagine. Le parti dell'immagine che fuoriescono dalla box vengono tagliate.

Visibile: indica che questo span deve essere visualizzato nella box. Può essere modificata a runtime con la proprietà Visible.

Abilitato: se la box contiene un solo span, indica che il testo contenuto in questo span è modificabile dall’utente quando il libro è mostrato nel browser.

Attivo: indica che le modifiche apportate dall’utente devono essere immediatamente inviate al server, non appena l’utente mette il fuoco in un altro campo.

Colore di sfondo: permette di impostare il colore di sfondo dello span. In questo modo non è più necessario creare uno stile visuale apposito. E' possibile modificare questa impostazione a run-time tramite la proprietà BackgroundColor.

Colore del testo: permette di impostare il colore del testo dello span. In questo modo non è più necessario creare uno stile visuale apposito. E' possibile modificare questa impostazione a run-time tramite la proprietà TextColor.

Maschera di editing: permette di impostare la maschera di formattazione ed editing dello span. In questo modo non è più necessario creare uno stile visuale apposito. E' possibile modificare questa impostazione a run-time tramite la proprietà Mask.

Tipo di carattere: permette di impostare gli attributi grassetto, corsivo, sottolineato e barrato. In questo modo non è più necessario creare uno stile visuale apposito. E' possibile modificare questa impostazione a run-time tramite la proprietà FontModifiers.

Watermark: Permette di definire una stringa che verrà mostrata se il campo è vuoto, come aiuto per l'utente. Vale solo se lo span è Abilitato e se il report è visualizzato in anteprima nel browser.

Codice: è il nome della costante che identifica questo span all’interno del codice sorgente. Non è consigliabile modificare questa proprietà.

Automatico: se impostato indica che la proprietà Codice verrà automaticamente calcolata e disambiguata in base al nome dello span. Si consiglia di non modificare questa opzione.

Class name: Permette di specificare una o più classi CSS aggiuntive da applicare allo Span se mostrato in un Book in anteprima.

Eventi: tramite questo sottomenù puoi aggiungere le procedure di gestione degli eventi notificati dallo span. Per maggiori informazioni sugli eventi disponibili vedi la libreria span.