Il file di formato per gli assegni è utilizzato per indicare a GnuCash come stampare uno o più
            assegni in un foglio di carta. Questo file descrive dapprima la disposizione generale
            della pagina (numero di assegni, orientazione, ecc…) e poi descrive
            l’impaginazione delle singole voci per ogni assegno. Il file è organizzato nel
            tipico formato a chiave e valore utilizzato dalla maggior parte delle applicazioni
            Linux. Le coppie di chiave e valore sono raggruppate in sezioni che iniziano con il nome
            del gruppo racchiuso tra parentesi quadre.
          
GnuCash cerca i file di formato per gli assegni in due differenti posizioni nel momento in cui viene
            aperta la finestra di stampa degli assegni: la prima posizione è generalmente
            /usr/share/gnucash/checks, dove risiedono i file
            di formato distribuiti con il programma; la seconda posizione è la cartella personale
            ~/.gnucash/checks. L’utente può aggiungere
            dei file di formato in qualsiasi momento (anche mentre GnuCash è in esecuzione) copiando
            semplicemente un nuovo file *.chk in questa cartella. Aprendo
            nuovamente la finestra di stampa degli assegni, il nuovo formato apparirà nella lista
            di quelli disponibili.
          
![]()  | Nota | 
|---|---|
La stampa funziona in modo differente in funzione della versione di GTK installata nel sistema.
              Quando   | |
Un tipico file per gli assegni di GnuCash è mostrato di seguito. Il contenuto di questo file verrà
            descritto nelle sezioni successive.
          
[Top]
Guid = 67b144d1-96a5-48d5-9337-0e1083bbf229
Title = Quicken/QuickBooks (tm) US-Letter
Rotation = 0.0
Translation = 0.0;4.0
Show_Grid = false
Show_Boxes = false
[Check Positions]
Height = 252.0
Names = Top;Middle;Bottom
[Check Items]
Type_1 = PAYEE
Coords_1 = 90.0;102.0;400.0;20.0
Type_2 = AMOUNT_WORDS
Coords_2 = 90.0;132.0
Type_3 = AMOUNT_NUMBER
Blocking_Chars_3 = true
Coords_3 = 500.0;102.0
Type_4 = DATE
Coords_4 = 500.0;67.0
Type_5 = NOTES
Coords_5 = 50.0;212.0
        Questa sezione del file degli assegni descrive la disposizione generale nella pagina degli assegni (o dell’assegno) che vengono immessi nella stampante.
Tabella B.1. Campo per la descrizione della disposizione generale
| Nome | Tipo | Necessario | Descrizione | 
|---|---|---|---|
| Guid | stringa | obbligatorio | 
                      Il codice guid permette di identificare univocamente un
                      formato di assegni utilizzato da GnuCash. Deve essere unico tra tutti quelli
                      delle applicazioni fornite e quelli forniti dall’utente. Se si copia un
                      file di formato esistente da utilizzare come base per le proprie modifiche,
                      questo valore deve essere cambiato. Il programma uuidgen
                      può essere usato per generare questo identificativo.
                     | 
| Titolo | stringa | obbligatorio | Il campo title permette di identificare univocamente il formato di assegni da parte dell’utente. Questo valore è presentato tale e quale nella lista dei formati presente nella finestra di stampa degli assegni. Se si copia un file di formato esistente da utilizzare come base per le proprie modifiche, questo valore deve essere cambiato adottando una qualsiasi stringa in formato utf-8. | 
| Carattere | stringa | opzionale | 
                      Se fornita, rappresenta il carattere predefinito utilizzato per stampare tutti
                      campi di testo nell’assegno. Questo campo può contenere qualsiasi
                      stringa accettata da GTK come carattere. Se questo campo è lasciato vuoto,
                      verrà utilizzato il carattere predefinito indicato nelle preferenze di GnuCash.
                      Un valore tipico può essere «sans 12».
                     | 
| Blocking_Chars | Booleano | opzionale | Se fornito, rappresenta il valore di default quando si stampano tutti gli elementi TEXT su questo assegno. Quando impostato a «true», stampa i caratteri *** prima e dopo ogni campo di testo nell’assegno. I caratteri di blocco sono stampati per proteggere i campi di testo da modifiche. Per esempio, il campo dell’importo potrebbe essere stampato come ***100,00*** | 
| DateFormat | Booleano | opzionale | Se fornito, rappresenta il valore predifinto quando si stampano tutti gli elementi DATE su questo assegno. Se impostato a «true», il formato di data verrà stampato in 8 punti, centrato e sopra la data corrente. Per esempio DDMMYYYY. | 
| Rotation | virgola mobile | opzionale | Questo valore indica la rotazione di tutta la pagina (in gradi) rispetto al punto di origine. Per le versioni di GTK precedenti alla 2.10, il punto di origine è situato nell’angolo in basso a sinistra della pagina e la rotazione è positiva in senso antiorario. Per le versioni di GTK superiori o uguali alla 2.10, il punto di origine è nell’angolo in alto a sinistra della pagina e la rotazione è positiva in senso orario. La rotazione della pagina è applicata prima della traslazione. | 
| Translation | elenco di 2 numeri a virgola mobile | opzionale | Questi valori specificano la rotazione lungo x e lungo y dell’intera pagina (in punti) relativamente al punto di origine. Per le versioni di GTK precedenti alla 2.10, il punto di origine è situato nell’angolo in basso a sinistra della pagina e la traslazione è positiva verso l’alto e verso destra. Per le versioni di GTK superiori o uguali alla 2.10, il punto di origine è nell’angolo in alto a sinistra della pagina e la traslazione è positiva verso destra e verso il basso. La rotazione alla pagina è applicata prima della traslazione. | 
| Show_Grid | Booleano | opzionale | 
                      Se questo valore è impostato a true allora GnuCash
                      disegnerà una griglia nella pagina, partendo dal punto di origine con delle
                      linee intervallate di 50 punti. Questa opzione è utile quando si desidera
                      creare un nuovo file di formato per la stampa degli assegni.
                     | 
| Show_Boxes | Booleano | opzionale | 
                      Se questo valore è impostato a true allora per ogni
                      elemento di cui sono state specificate larghezza e altezza, GnuCash disegnerà
                      un riquadro che mostra la posizione e l’ingombro massimo
                      dell’elemento stesso. Questa opzione è utile quando si desidera creare
                      un nuovo file di formato per la stampa degli assegni.
                     | 
![]()  | Nota | 
|---|---|
Le opzioni Blocking_Chars e DateFormat sono definite per tutti i formati di assegno nella scheda Stampa in → . Si raccomanda che queste opzioni globali rimangano impostate a falso (valore predefinito) e che vengano invece impostate per ogni assegno nel gruppo Check Items come descritto nel seguito.  | |
Questo gruppo di elementi specifica come sono distribuiti gli assegni nel foglio di carta e fornisce
              dei nomi a ogni posizione di un assegno in modo che l’utente possa indicare a
              GnuCash quale di queste posizioni debba essere stampata. Questo gruppo di valori e
              chiavi è opzionale e deve essere tralasciato se si desidera che venga stampato un
              solo assegno per foglio.
            
Tabella B.2. Campi per la stampa di più assegni per foglio
| Nome | Tipo | Necessario | Descrizione | 
|---|---|---|---|
| Altezza | virgola mobile | obbligatorio | Questo campo specifica l’altezza del singolo assegno nella pagina. Se si desidera stampare più di un assegno per pagina, allora questo campo è obbligatorio. Se si desidera invece stampare un solo assegno per foglio, tutta la sezione dovrebbe essere tralasciata. | 
| Names | elenco di stringhe | obbligatorio | Questo campo specifica i nomi delle posizioni degli assegni che possono essere stampati per ogni pagina. Questi nomi rappresentano le posizioni dell’assegno partendo dall’alto della pagina e spostandosi verso il basso. I nomi vengono indicati in modo identico nella lista delle posizioni presente nella finestra di stampa degli assegni. Un valore tipico per questo campo può essere Top;Middle;Bottom, ma potrebbe anche essere First;Second;Third o qualsiasi altro insieme di stringhe che identifica chiaramente la posizione dell’assegno. Se si desidera stampare più di un assegno per pagina, allora questo campo è obbligatorio. Se si desidera invece stampare un solo assegno per foglio, tutta la sezione dovrebbe essere tralasciata.. | 
Questa sezione indica le singole voci da stampare sull’assegno. Non c’è limite al numero di voci che è possibile inserire e la stessa tipologia può essere ripetuta più volte; questo permette la stampa di assegni che hanno una matrice laterale, o degli assegni per le imprese che sono uno per pagina e che hanno sia l’assegno e le matrici multiple nella stessa pagina. per esempio, per stampare il nome del beneficiario in un assegno per imprese e in entrambe le matrici, basta specificare tre diverse voci del tipo Payee con differenti coordinate per la stampa.
Ogni nome di chiave contenuta in questa sezione include esplicitamente il numero dell’elemento
              a cui viene applicata: es. la chiave denominata Type_1 si applica
              al primo elemento stampato e la chiave Coords_3 viene applicata
              al terzo elemento che deve essere stampato. I numeri delle voci cominciano da uno e
              crescono in modo sequenziale. Ogni salto nella numerazione viene interpretato da GnuCash
              come la fine della lista della voce. Gli elementi sono stampati secondo l’ordine
              numerico, non nell’ordine con cui appaiono nel file.
            
Ogni elemento specificato deve includere un tipo di dichiarazione. I restanti parametri per l’elemento dipendo dal suo particolare tipo. Consultare la Tabella B.4, «Tipi di voci per un singolo assegno» per recuperare una lista di tipi di elementi validi e i rispettivi parametri richiesti.
Tabella B.3. Campi degli elementi per un unico assegno
| Nome | Tipo | Necessario | Descrizione | ||||
|---|---|---|---|---|---|---|---|
| Type_n | stringa | obbligatorio | Questo campo specifica il tipo di elemento da stampare sull’assegno. Consultare la Tabella B.4, «Tipi di voci per un singolo assegno» per una lista di voci valide. | ||||
| Coords_n | elenco di 2 o 4 numeri a virgola mobile | obbligatorio | 
                      Questo campo specifica le coordinate in cui la voce verrà inserita
                      nell’assegno e, opzionalmente, ne specifica anche l’altezza e la
                      larghezza. I valori rappresentano rispettivamente gli spostamenti lungo agli
                      assi X e Y rispetto all’angolo in basso a sinistra dell’elemento e
                      opzionalmente la sua larghezza e altezza. Se viene fornito un valore per
                      l’altezza, allora deve essere inserita anche la larghezza e quindi
                      questo campo deve contenere 2 o 4 valori. Per le versioni GTK precedenti alla
                      2.10, il punto di origine è nell’angolo in bsso a sinistra della pagina
                      e le traslazioni sono positive verso l’alto e verso destra. Per le
                      versioni GTK 2.10 e superiori, il punto di origine è situato in alto a
                      sinistra e le traslazioni sono positive verso il basso e verso destra.
                      
  | ||||
| Font_n | stringa | opzionale | 
                      Se fornita, rappresenta il carattere utilizzato per stampare la specifica voce
                      di testo. Questo campo può contenere una stringa qualsiasi purché sia
                      accettata da GTK. Se questo campo è lasciato vuoto, verrà utilizzato il
                      carattere predefinito specificato nella sezione Iniziale
                      del file di descrizione degli assegni o, se anche questo è stato tralasciato,
                      il carattere specificato nelle preferenze di GnuCash. Questo campo viene
                      riconosciuto solamente se si utilizza GTK 2.10 o successivo.
                     | ||||
| Align_n | stringa | opzionale | Se fornita, rappresenta l’allineamento utilizzato per stampare la specifica voce di testo. Questo campo deve contenere una delle seguenti stringhe «sinistra», «centro» o «destra». Se questo campo è lasciato vuoto, il testo verrà allineato a sinistra. Questo campo viene riconosciuto solamente se si utilizzano le GTK 2.10 o successive. | ||||
| Text_n | stringa | opzionale | Questo campo è utilizzato solamente quando il tipo di voce è impostato a TEXT. Specifica il testo, in formato utf-8, da stampare sull’assegno. | ||||
| Filename_n | stringa | opzionale | 
                      Questo campo è utilizzato solamente quando il tipo di elemento è impostato a
                      PICTURE. Specifica il nome del file dell’immagine
                      da stampare sull’assegno. La stringa può specificare un percorso
                      assoluto o relativo. In quest’ultimo caso, GnuCash controlla prima nella
                      cartella dei formati di assegno forniti dal programma (generalmente
                      /usr/share/gnucash/checks) e, se non lo
                      dovesse trovare, cercherà nella cartella personale
                      ~/.gnucash/checks. Questo campo viene
                      riconosciuto solamente se si utilizza GTK 2.10 o successivo.
                     | ||||
| Blocking_Chars_n | Booleano | opzionale | Se fornito, imposta l’opzione di stampa Blocking_Chars per questo elemento. | ||||
| DateFormat_n | Booleano | opzionale | Se fornito, imposta l’opzione di stampa DateFormat per questo elemento. | ||||
Queste sono le voci che possono essere stampate individualmente su un assegno; necessitano tutte delle coordinate rispetto alla pagina dove devono essere stampate. La maggioranza di queste voci producono la stampa di un testo sul foglio ed è possibile, per ognuna di esse, specificare un carattere e un allineamento. Per esempio, l’importo in cifre di un assegno può essere stampato con la giustificazione a destra mentre, tutto il resto, giustificato a sinistra. Gli altri tipi devono avere dei parametri unici.
Tabella B.4. Tipi di voci per un singolo assegno
| Nome | Valori obbligatorio | Valori facoltativi | Descrizione | 
|---|---|---|---|
| PAYEE | Coordinate | 
 Font  | 
                      Questo valore del tipo indica a GnuCash di stampare il nome del beneficiario
                      partendo dalle coordinate specificate.
                     | 
| DATE | Coordinate | 
 Font  | 
                      Questo valore del tipo indica a GnuCash di stampare la data partendo dalle
                      coordinate specificate.
                     | 
| NOTES | Coordinate | 
 Font  | 
                      Questo valore del tipo indica a GnuCash di stampare il campo delle note della
                      transazione partendo dalle coordinate specificate.
                     | 
| CHECK_NUMBER | Coordinate | 
 Font  | 
                      This type value tells GnuCash to print the check number at the specified
                      coordinates. The check number reflects the book option selection under
                       → 
                      for number source (transaction number or anchor-split action - see
                      Use Split
                      Action Field for Number in the Book Options section of the GnuCash Help
                      Manual).
                     | 
| MEMO | Coordinate | 
 Font  | 
                      Questo valore del tipo indica a GnuCash di stampare il il campo promemoria della
                      suddivisione partendo dalle coordinate specificate.
                     | 
| ACTION | Coordinate | 
 Font  | 
                      This type value tells GnuCash to print the split action field at the specified
                      coordinates. However, the printed field reflects the book option selection
                      under
                       → 
                      for number source (transaction number or anchor-split action - see
                       Use Split
                      Action Field for Number in the Book Options section of the GnuCash Help
                      Manual). If number source for the book is specified as anchor-split action,
                      this field will instead print the transaction number field.
                     | 
| AMOUNT_WORDS | Coordinate | 
 Font  | 
                      Questo valore del tipo indica a GnuCash di stampare l’importo in lettere
                      dell’assegno partendo dalle coordinate specificate. L’importo
                      apparirà nella forma Un milione, due cento trenta quattro e
                      56/100.
                     | 
| AMOUNT_NUMBER | Coordinate | 
 Font  | 
                      Questo valore del tipo indica a GnuCash di stampare l’importo in cifre
                      dell’assegno partendo dalle coordinate specificate. L’importo
                      apparirà nella forma €1.234,56.
                     | 
| ADDRESS | Coordinate | 
 Font  | 
                      Questo valore del tipo indica a GnuCash di stampare l’indirizzo alle
                      coordinate specificate.
                     | 
| SPLITS_ACCOUNT | Coordinate | 
 Font  | 
                      Questo valore del tipo indica a GnuCash di stampare i nomi dei conti per ogni
                      suddivisione partendo dalle coordinate specificate. Vedere la nota sulla
                      stampa delle suddivisioni.
                     | 
| SPLITS_AMOUNT | Coordinate | 
 Font  | 
                      Questo valore del tipo indica a GnuCash di stampare l’importo per ogni
                      suddivisione partendo dalle coordinate specificate. Gli importi sono stampati
                      con il simbolo della valuta. Vedere la nota sulla stampa delle suddivisioni.
                     | 
| SPLITS_MEMO | Coordinate | 
 Font  | 
                      Questo valore del tipo indica a GnuCash di stampare il campo del promemoria
                      partendo dalle coordinate specificate. Vedere la nota sulla stampa delle
                      suddivisioni.
                     | 
| TEXT | Coordinate, testo | 
 Font  | 
                      Questo valore del tipo indica a GnuCash di stampare una stringa arbitraria
                      partendo dalle coordinate specificate. La stringa da stampare è specificata
                      dalla chiave Text_n.
                     | 
| PICTURE | Coordinate, nome del file | (nessuno) | 
                      Questo valore del tipo indica a GnuCash di stampare un’immagine partendo
                      dalle coordinate specificate. L’immagine da stampare è specificata
                      attraverso la chiave Filename_n. Questo tipo è
                      riconosciuto solamente quando si utilizza GTK 2.10 o successiva.
                     | 
![]()  | Nota | 
|---|---|
SPLIT items include all split entries for the transaction except for the split that applies to the current account register (referred to as the anchor-split). This is usually the last split listed when splits are displayed in the register. The coordinate location defines the lower left location for the split information.  | |
Creare un proprio file di formato per gli assegni è un’operazione piuttosto semplice. Il
            metodo più semplice consiste nel copiare un file di formato esistente dalla cartella
            del programma (generalmente
            /usr/share/gnucash/checks) alla cartella
            ~/.gnucash/checks. È importante ricordarsi di
            cambiare il valore guid per fare in modo che il nuovo file venga
            accettato da GnuCash e di cambiare il titolo in modo che sia di descrittivo. A questo
            punto è possibile cambiare e aggiungere i campi come si desidera. È possibile anche
            creare un nuovo file di formato premendo il pulsante Salva formato
            nella pagina del Formato personalizzato della finestra di stampa
            degli assegni.
          
![]()  | Nota | 
|---|---|
I nomi delle chiavi sono sensibili alle lettere maiuscole o minuscole. Se si avessero dei problemi con un file di formato per gli assegni, assicurarsi che tutti i nomi delle chiavi inizino con la lettera maiuscola.  | |