PageSetup

PageSetup class

Rappresenta le proprietà di impostazione della pagina di una sezione.

Per saperne di più, visita ilLavorare con le sezioni articolo di documentazione.

public class PageSetup

Proprietà

NomeDescrizione
Bidi { get; set; }Specifica che questa sezione contiene testo bidirezionale (script complessi).
BorderAlwaysInFront { get; set; }Specifica dove viene posizionato il bordo della pagina rispetto ai testi e agli oggetti che si intersecano.
BorderAppliesTo { get; set; }Specifica su quali pagine viene stampato il bordo della pagina.
BorderDistanceFrom { get; set; }Ottiene o imposta un valore che indica se il bordo della pagina specificato viene misurato dal bordo della pagina o dal testo che lo circonda.
Borders { get; }Ottiene una raccolta dei bordi della pagina.
BorderSurroundsFooter { get; set; }Specifica se il bordo della pagina include o esclude il piè di pagina.
BorderSurroundsHeader { get; set; }Specifica se il bordo della pagina include o esclude l’intestazione.
BottomMargin { get; set; }Restituisce o imposta la distanza (in punti) tra il bordo inferiore della pagina e il limite inferiore del corpo del testo.
ChapterPageSeparator { get; set; }Ottiene o imposta il carattere separatore visualizzato tra il numero del capitolo e il numero della pagina.
CharactersPerLine { get; set; }Ottiene o imposta il numero di caratteri per riga nella griglia del documento.
DifferentFirstPageHeaderFooter { get; set; }Vero se nella prima pagina viene utilizzata un’intestazione o un piè di pagina diverso.
EndnoteOptions { get; }Fornisce opzioni che controllano la numerazione e il posizionamento delle note di chiusura in questa sezione.
FirstPageTray { get; set; }Ottiene o imposta il vassoio della carta (scomparto) da utilizzare per la prima pagina di una sezione. Il valore è specifico dell’implementazione (stampante).
FooterDistance { get; set; }Restituisce o imposta la distanza (in punti) tra il piè di pagina e il fondo della pagina.
FootnoteOptions { get; }Fornisce opzioni che controllano la numerazione e il posizionamento delle note a piè di pagina in questa sezione.
Gutter { get; set; }Ottiene o imposta la quantità di spazio aggiuntivo aggiunto al margine per la rilegatura del documento.
HeaderDistance { get; set; }Restituisce o imposta la distanza (in punti) tra l’intestazione e la parte superiore della pagina.
HeadingLevelForChapter { get; set; }Ottiene o imposta lo stile del livello di intestazione applicato ai titoli dei capitoli nel documento.
LayoutMode { get; set; }Ottiene o imposta la modalità di layout di questa sezione.
LeftMargin { get; set; }Restituisce o imposta la distanza (in punti) tra il bordo sinistro della pagina e il limite sinistro del corpo del testo.
LineNumberCountBy { get; set; }Restituisce o imposta l’incremento numerico per i numeri di riga.
LineNumberDistanceFromText { get; set; }Ottiene o imposta la distanza tra il bordo destro dei numeri di riga e il bordo sinistro del documento.
LineNumberRestartMode { get; set; }Ottiene o imposta il modo in cui viene eseguita la numerazione delle righe, ovvero se ricomincia dall’inizio di una nuova pagina o sezione o se viene eseguita in modo continuo.
LinesPerPage { get; set; }Ottiene o imposta il numero di righe per pagina nella griglia del documento.
LineStartingNumber { get; set; }Ottiene o imposta il numero della riga iniziale.
Margins { get; set; }Restituisce o imposta il presetMargins della pagina.
MultiplePages { get; set; }Per documenti di più pagine, ottiene o imposta la modalità di stampa o rendering di un documento in modo che possa essere rilegato come un opuscolo.
OddAndEvenPagesHeaderFooter { get; set; }Vero se il documento ha intestazioni e piè di pagina diversi per le pagine con numeri dispari e con numeri pari.
Orientation { get; set; }Restituisce o imposta l’orientamento della pagina.
OtherPagesTray { get; set; }Ottiene o imposta il vassoio della carta (scomparto) da utilizzare per tutte le pagine tranne la prima di una sezione. Il valore è specifico dell’implementazione (stampante).
PageHeight { get; set; }Restituisce o imposta l’altezza della pagina in punti.
PageNumberStyle { get; set; }Ottiene o imposta il formato del numero di pagina.
PageStartingNumber { get; set; }Ottiene o imposta il numero di pagina iniziale della sezione.
PageWidth { get; set; }Restituisce o imposta la larghezza della pagina in punti.
PaperSize { get; set; }Restituisce o imposta la dimensione della carta.
RestartPageNumbering { get; set; }Vero se la numerazione delle pagine ricomincia dall’inizio della sezione.
RightMargin { get; set; }Restituisce o imposta la distanza (in punti) tra il bordo destro della pagina e il limite destro del corpo del testo.
RtlGutter { get; set; }Ottiene o imposta se Microsoft Word utilizza i margini interni per la sezione in base a una lingua da destra a sinistra o da sinistra a destra.
SectionStart { get; set; }Restituisce o imposta il tipo di interruzione di sezione per l’oggetto specificato.
SheetsPerBooklet { get; set; }Restituisce o imposta il numero di pagine da includere in ciascun booklet.
SuppressEndnotes { get; set; }Vero se le note di chiusura vengono stampate alla fine della sezione successiva che non elimina le note di chiusura. Le note di chiusura soppresse vengono stampate prima delle note di chiusura in quella sezione.
TextColumns { get; }Restituisce una raccolta che rappresenta l’insieme di colonne di testo.
TextOrientation { get; set; }Permette di specificareTextOrientation per l’intera pagina. Il valore predefinito èHorizontal
TopMargin { get; set; }Restituisce o imposta la distanza (in punti) tra il bordo superiore della pagina e il limite superiore del corpo del testo.
VerticalAlignment { get; set; }Restituisce o imposta l’allineamento verticale del testo su ogni pagina di un documento o sezione.

Metodi

NomeDescrizione
ClearFormatting()Ripristina l’impostazione della pagina sul formato carta, sui margini e sull’orientamento predefiniti.

Osservazioni

PageSetup L’oggetto contiene tutti gli attributi di impostazione della pagina di una sezione (margine sinistro, margine inferiore, formato carta e così via) come proprietà.

Esempi

Mostra come applicare e ripristinare le impostazioni di impostazione della pagina nelle sezioni di un documento.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Modifica le proprietà di impostazione della pagina per la sezione corrente del builder e aggiunge testo.
builder.PageSetup.Orientation = Orientation.Landscape;
builder.PageSetup.VerticalAlignment = PageVerticalAlignment.Center;
builder.Writeln("This is the first section, which landscape oriented with vertically centered text.");

// Se iniziamo una nuova sezione utilizzando un generatore di documenti,
// erediterà le proprietà di impostazione della pagina corrente del builder.
builder.InsertBreak(BreakType.SectionBreakNewPage);

Assert.AreEqual(Orientation.Landscape, doc.Sections[1].PageSetup.Orientation);
Assert.AreEqual(PageVerticalAlignment.Center, doc.Sections[1].PageSetup.VerticalAlignment);

// Possiamo ripristinare le proprietà di impostazione della pagina ai valori predefiniti utilizzando il metodo "ClearFormatting".
builder.PageSetup.ClearFormatting();

Assert.AreEqual(Orientation.Portrait, doc.Sections[1].PageSetup.Orientation);
Assert.AreEqual(PageVerticalAlignment.Top, doc.Sections[1].PageSetup.VerticalAlignment);

builder.Writeln("This is the second section, which is in default Letter paper size, portrait orientation and top alignment.");

doc.Save(ArtifactsDir + "PageSetup.ClearFormatting.docx");

Guarda anche