Lo scheletro del report

Generare un file RTF è un pò come generare un documento HTML, solo che i tag RTF sono molti, ma molti di più. Ho quindi scartato a priori l'idea di scriverlo direttamente nel codice (usando una sfilza di Write("....") insomma). Ci vuole qualcosa di più sofisticato.

Il mio "generatore" sarà quindi costituito da una serie di funzioni, il cui scopo è quello di "incapsulare" la generazione del documento finale in una serie di procedure molto semplici e, soprattutto, riutilizzabili.

Ho bisogno poi dei Tag RTF che mi servono, e dato che sono tanti preferisco averne un elenco e leggerli di volta in volta quando mi servono, in questo modo se voglio aggiungere un tag devo solo aggiungerlo all'elenco, perchè il codice è predisposto per cercarlo nell'elenco e lo troverà.

La funzione "principale" è quella che preleva dall'elenco di tag quello richiesto al momento e lo "spara" nel file che stiamo costruendo.

Il meccanismo quindi si presenta così:

• devo scrivere un tag
• cerco il tag nell'elenco
• scrivo il tag
• ritorno a (1)

Per comodità poi ho pensato che sarebbe utile avere due funzioni di "scrittura" sul file: una che scrive senza andare a capo, e l'altra che invece interrompe la linea e porta il testo a capo (equivalente ad inserire un

Dopo un pò di elucubrazioni sono arrivato al seguente elenco "minimo" di funzioni da implementare:

• IniziaReport()
  : Inizializza il file e ci scrive dentro i tag di inizializzazione dell'RTF.
• ImpostaPortrait()
  : Imposta la pagina in Portrait (normale A4 in verticale)
• ImpostaLandscape() 
  Imposta la pagina in Landscape (A4 per il lungo)
• AggiungiStile()
   Aggiunge al file uno "stile" che può essere utilizzato nel testo (Normale, Titolo...)
• ImpostaTabulatori()
   Imposta i tabulatori da usare nel paragrafo successivo (per le tabulazioni)
• ChiudiParagrafo()
  : Chiude il paragrafo attuale provocando uno "spazio" tra i testi
• ScriviLinea()
   Scrive una linea di testo senza andare a capo in fondo
• ScriviLineaACapo()
  Scrive una linea di testo ed aggiunge la "chiusa" per andare a capo successivamente
• ScriviGrassetto()
  : Scrive il testo indicato in grassetto
• ScriviCorsivo()
  : Scrive il testo indicato in corsivo (anche detto Italico)
• UsaStile()
  : Imposta lo stile da usare per il testo successivo
• ChiudiStile()
   Cessa di utilizzare lo stile attuale, qualunque esso sia
• ChiudiReport()
  : "chiude" il documento RTF attuale

Ognuna delle funzioni sopra descritte, ha la stessa struttura:

• Leggo dall'elenco il tag che mi interessa
• Scrivo il tag nel file
• eventualmente: scrivo il testo fornitomi dall'utente a cui il tag si riferisce
• eventualmente: chiudo il tag attuale

Quindi per prima cosa mi serve la funzione che legge dall'elenco il TAG che voglio. Per evitare di complicare le cose ho deciso di non utilizzare un database per memorizzare i tag, troppo complicato e fondamentalmente inutile, i Tag li memorizzo in un file ASCII, avente tale struttura:

Il "@" separa il codice dal tag vero e proprio, questo significa che nè il tag, nè il codice possono contenere il carattere "@", in quanto a questo siamo a posto perchè nessun tag RTF contiene il "@".

Contenuti dell'articolo

• Pagina 1
  • Produrre un documento Word
  • Creare un documento RTF
• Pagina 2
  • Lo scheletro del report
• Pagina 3
  • Recuperare un Tag dall'elenco
• Pagina 4
  • Iniziare e finire il Report
  • Impostare il formato della pagina
• Pagina 5
  • Scrivere linee e paragrafi
  • Definire e scegliere uno stile di testo
  • Grassetto e corsivo
• Pagina 6
  • Le Tabulazioni (tabelle)
  • L'elenco dei Tag
• Pagina 7
  • Usare il generatore