INITFORM
Consente di inizializzare in memoria un formato grafico di stampa.
Parametri
| Parametro | Definizione | I/O | Versione traduttore | SMP | |
|---|---|---|---|---|---|
| IDFORMATO | Long | ||||
| FORMATO | Stringa | ||||
| DIRFORMATO | Stringa | ||||
| DIZ | Stringa | ||||
| DIRDIZ | Stringa | ||||
| MODELLO | Stringa | ||||
| DIRMODELLO | Stringa | ||||
| DESCR | Stringa | ||||
| COPIA | Intero | ||||
| REPORT | Intero | ||||
| STRUTTURA | Stringa | ||||
| GRAFICOFOGLIO | Stringa | ||||
| AGHIRIGHE | Intero | ||||
| AGHICOLS | Intero | ||||
| AGHICHAR | Stringa | ||||
| ERRORE | Intero |
IDFORMATO
Consente di reperire l'identificatore assegnato al formato di stampa dal programma in esecuzione.
FORMATO
Consente di indicare il nome del formato da inizializzare.
Se non esiste verrà prodotta la creazione di un nuovo formato.
Se il nome del formato è indicato senza estensione viene considerata l'estensione .SXF
DIRFORMATO
Consente di indicare la directory di collocazione del formato.
DIZ
Consente di indicare il nome del dizionario da utilizzare in creazione di un nuovo formato.
Se il dizionario non è indicato (o viene valorizzato con 'NESSUNO') il formato non sarà associato a nessun dizionario.
Se il nome del dizionario è indicato senza estensione viene considerata l'estensione .SXN
DIRDIZ
Consente di indicare la directory di collocazione del dizionario.
MODELLO
Consente di indicare il nome del formato da utilizzare come modello.
Viene utilizzato per la creazione di un nuovo formato o per integrare le informazioni di un formato già esistente.
DIRMODELLO
Consente di indicare la directory di collocazione del formato da utilizzare come modello.
DESCR
Consente di definire la descrizione da associare al formato.
COPIA
Consente di indicare se il formato che si sta creando è la copia di un formato già esistente.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
REPORT
Consente di indicare se si sta trattando un formato per report.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No, si tratta di un formato libero .SXF |
1 | Sì, il formato da utilizzare per la stampa è un Report, ovvero ha estensione .SXRPT |
STRUTTURA
Consente di definire, in creazione di un formato, la struttura da utilizzare.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
TCP | se il formato presenta la struttura Testata/Corpo/Piede |
PAGINA | se il formato presenta la struttura PaginaUnica |
GRAFICOFOGLIO
Consente di definire, in creazione di un formato, le dimensioni del foglio utilizzato per il disegno del formato grafico su stampanti laser.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
A4_VERTICALE | se il formato prevede le dimensioni del foglio A4 con orientamento verticale |
A4_ORIZZONTALE | se il formato prevede le dimensioni del foglio A4 con orientamento orizzontale |
LIBERO | se il formato prevede dimensioni libere, esplicitamente indicate |
AGHIRIGHE
Consente di definire, in creazione di un formato, il numero di righe da utilizzare su stampanti ad aghi.
AGHICOLS
Consente di definire, in creazione di un formato, il numero di colonne da utilizzare su stampanti ad aghi.
AGHICHAR
Consente di definire, in creazione di un formato, il tipo di carattere da utilizzare su stampanti ad aghi.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
N | Stampa con carattere Normale (10' di pollice) |
D | Stampa con carattere Dodicesimi (12' di pollice) |
C | Stampa con carattere compresso (17' di pollice) |
ERRORE
Consente al programma di intercettare e gestire l'errore restituito dalla funzione.
Utilizzare uno dei metodi GetLastError*() della classe BCContextInfo per ottenere le informazioni dell'errore.
Errori
| Codice | Descrizione |
|---|---|
| 24609 | '@INITFORM - Attenzione! Il formato 'XXX' non è stato trovato! Probabilmente il percorso è errato o il file non esiste! |
| 24610 | '@INITFORM - Attenzione! Il modello 'XXX' non è stato trovato! Probabilmente il percorso è errato o il file non esiste! |
| 24611 | '@INITFORM - Attenzione! Il dizionario 'XXX' del formato 'YYY', non è stato trovato! Probabilmente il percorso è errato o il file non esiste! Il formato non può essere creato. |
| 24612 | '@INITFORM - Attenzione! Si è verificato un errore sulla lettura del formato 'XXX'! Il dizionario 'YYY' non è stato trovato! Probabilmente il percorso è errato o il file non esiste! |
| 24613 | '@INITFORM - Attenzione! Si e' verificato un errore sulla creazione del formato '%s'! Il formato non puo' essere creato. |
Esempi
Creazione di un nuovo formato
'...
DIM idFormato[INT]
DIM nomeForm[STRING] = "BOLLA"
DIM dirForm[STRING] = percorsoFormato + "BOLLA"
'@INITFORM IDFORMATO[idFormato] _
FORMATO[nomeForm] _
DIRFORMATO[dirForm] _
DESCR["Formato per BOLLA"] _
GRAFICOFOGLIO[LIBERO]
'...
Creazione di un nuovo formato come copia da un altro formato
'...
DIM dirModello[STRING] = percorsoFormato + "MODELLO"
DIM dirFormato[STRING] = percorsoFormato + "BOLLA"
DIM idFormato[INT]
'@INITFORM IDFORMATO[idFormato] _
FORMATO["BOLLA"] _
DIRFORMATO[dirFormato] _
MODELLO["MODELLO"] _
DIRMODELLO[dirModello] _
DESCR["Formato per BOLLA"] _
GRAFICOFOGLIO[A4_VERTICALE]
'...
Apertura di un formato esistente
'...
DIM idFormato[INT]
DIM dirFormato[STRING] = percorsoFormato + "BOLLA"
'@INITFORM IDFORMATO[idFormato] _
FORMATO["BOLLA"] _
DIRFORMATO[dirFormato]
'...