|
<< Fare clic per visualizzazione il sommario >> Percorso: Gli oggetti del mondo Jamio > I tipi strutturati > ConverterSettings |
Definisce le impostazioni da assegnare ad un file formato PDF. Il tipo ad esempio è utilizzato nel metodo ConvertToPDF del Plug Document Automation utile a convertire un file in formato PDF.
Le proprietà del tipo ConverterSettings, da utilizzare in fase di conversione, dipendono dal tipo di file dato in input al metodo ConvertToPDF. I tipi di file che è possibile convertire in PDF sono classificabili in:
•Word (comprende le estensioni estensioni DOC, DOCM, DOCX, DOT, DOTM, DOTX, FODT, HTML, MHTML, ODT, OTT, RTF, TXT, XHTML, XML, SQL)
•Excel (comprende le estensioni estensioni XLS, XLSX, XLSM, XLSB, XLTX, XLTM, CSV, SpreadsheetML, ODS, ODF)
•Presentation (comprende le estensioni estensioni PPT, PPTX, PPS, POT, PPSX, PPTM, PPSM, POTX, POTM, ODP)
•Image ( comprende le estensioni estensioni BMP, JPE, JPEG, JPG, PNG, GIF, TIF, TIFF)
•SignedFile (comprende le estensioni estensioni P7M, TSD)
•SvgFile (estensione SVG)
•Email message (estensione EML)
Il tipo ConverterSettings è una struttura composta dalle seguenti proprietà:
Nome |
Descrizione |
Tipo |
BottomMargin |
Rappresenta il margine inferiore della pagina espressa in centimetri. La proprietà è impostata solo se diversa da zero |
Decimal |
CenterHorizontally |
Permette di centrare orizzontalmente la pagina che si sta convertendo nel file pdf di output |
Boolean |
CenterVertically |
Permette di centrare verticalmente la pagina che si sta convertendo nel file pdf di output |
Boolean |
LeftMargin |
Rappresenta il margine sinistro della pagina espressa in centimetri. La proprietà è impostata solo se diversa da zero |
Decimal |
Orientation |
Rappresenta l'orientamento della pagina da assegnare al file PDF |
|
PageHeight |
Rappresenta l'altezza della pagina espressa in centimetri. La proprietà è impostata solo se diversa da zero |
Decimal |
PageWidth |
Rappresenta la larghezza della pagina espressa in centimetri. La proprietà è impostata solo se diversa da zero |
Decimal |
PaperSize |
Rappresenta la dimensione della pagina da assegnare al file PDF |
|
RightMargin |
Rappresenta il margine destro della pagina espressa in centimetri. La proprietà è impostata solo se diversa da zero |
Decimal |
TopMargin |
Rappresenta il margine superiore della pagina espressa in centimetri. La proprietà è impostata solo se diversa da zero |
Decimal |
UseImageSize |
Permette per i formati immagine (BMP, JPE, JPEG, JPG, PNG, GIF, TIF, TIFF) di impostare le dimensioni della pagina del file in formato PDF ottenuto dalla conversione |
Boolean |
Per ogni tipo di file che è possibile convertire, sono recepite specifiche proprietà del tipo ConverterSettings e per esse sono impostati dei valori di default.
•Proprietà e valori di default del tipo ConverterSettings per i file di tipo Word:
oPaperSize (default = A4)
oPageHeight (considerato solo se PaperSize = Custom, default = altezza del formato A4)
oPageWidth (considerato solo se PaperSize = Custom, default = larghezza del formato A4)
oOrientation (default = Portrait)
oTopMargin (default = 2.5)
oBottomMargin (default = 2)
oLeftMargin (default = 2)
oRightMargin (default = 2)
•Proprietà e valori di default del tipo ConverterSettings per i file di tipo Excel:
oPaperSize (default = Letter)
oPageHeight (considerato solo se PaperSize = Custom, default = altezza del formato Letter)
oPageWidth (considerato solo se PaperSize = Custom, default = altezza del formato Letter)
oOrientation (default = Portrait)
oTopMargin (default = 1.9)
oBottomMargin (default = 1.9)
oLeftMargin (default = 1.8)
oRightMargin (default = 1.8)
oCenterHorizontally (default = false)
oCenterVertically (default = false)
•Proprietà e valori di default del tipo ConverterSettings per i file di tipo Image
oPageHeight (default = altezza del formato A4)
oPageWidth (default = larghezza del formato A4)
oOrientation (considerato solo se PageHeight = 0, PageWidth = 0 e UseImageSize = false; default = Portrait)
oTopMargin (default = 2)
oBottomMargin (default = 2)
oLeftMargin (default = 2.5)
oRightMargin (default = 2.5)
oUseImageSize (default = false; se true, il documento PDF avrà una pagina delle stesse dimensioni dell'immagine, senza margini, e tutte le altre proprietà saranno ignorate). Se la proprietà UseImageSize viene impostata a true, il file PDF avrà una pagina delle stesse dimensioni dell'immagine, senza margini, e tutte le altre proprietà (PaperSize, Orientation,PageHeight, etc.) saranno ignorate. Se la proprietà UseImageSize viene impostata a false, il file PDF avrà le caratteristiche specificate con le altre proprietà (PaperSize, Orientation,PageHeight, etc.). In questo scenario se l'immagine è più piccola delle dimensioni della pagina PDF (quelle impostate o l'A4 di default), verrà inserita con le sue dimensioni inalterate all'interno della pagina, considerando gli eventuali margini e le proprietà CenterHorizontally e CenterVertically; se è più grande delle dimensioni della pagina PDF (anche se solo per l'altezza o solo per la larghezza), l'immagine verrà ridimensionata per essere inserita nella pagina mantenendo le proporzioni.
•Proprietà e valori di default del tipo ConverterSettings per i file di tipo Presentation: nessuno.
•Proprietà e valori di default del tipo ConverterSettings per i file di tipo SignedFile: nessuno.
•Proprietà e valori di default del tipo ConverterSettings per i file di tipo SvgFile: nessuno.
•Proprietà e valori di default del tipo ConverterSettings per i file di tipo Email message: nessuno.