PageSetup

PageSetup class

Représente les propriétés de mise en page d’une section.

Pour en savoir plus, visitez leTravailler avec des sections article documentaire.

public class PageSetup

Propriétés

NomLa description
Bidi { get; set; }Spécifie que cette section contient du texte bidirectionnel (scripts complexes).
BorderAlwaysInFront { get; set; }Spécifie où la bordure de la page est positionnée par rapport aux textes et objets qui se croisent.
BorderAppliesTo { get; set; }Spécifie sur quelles pages la bordure de page est imprimée.
BorderDistanceFrom { get; set; }Obtient ou définit une valeur qui indique si la bordure de page spécifiée est mesurée à partir du bord de la page ou à partir du texte qu’elle entoure.
Borders { get; }Obtient une collection des bordures de page.
BorderSurroundsFooter { get; set; }Spécifie si la bordure de la page inclut ou exclut le pied de page.
BorderSurroundsHeader { get; set; }Spécifie si la bordure de la page inclut ou exclut l’en-tête.
BottomMargin { get; set; }Renvoie ou définit la distance (en points) entre le bord inférieur de la page et la limite inférieure du corps du texte.
ChapterPageSeparator { get; set; }Obtient ou définit le caractère séparateur qui apparaît entre le numéro de chapitre et le numéro de page.
CharactersPerLine { get; set; }Obtient ou définit le nombre de caractères par ligne dans la grille du document.
DifferentFirstPageHeaderFooter { get; set; }True si un en-tête ou un pied de page différent est utilisé sur la première page.
EndnoteOptions { get; }Fournit des options qui contrôlent la numérotation et le positionnement des notes de fin dans cette section.
FirstPageTray { get; set; }Obtient ou définit le bac à papier (bac) à utiliser pour la première page d’une section. La valeur est spécifique à l’implémentation (imprimante).
FooterDistance { get; set; }Renvoie ou définit la distance (en points) entre le pied de page et le bas de la page.
FootnoteOptions { get; }Fournit des options qui contrôlent la numérotation et le positionnement des notes de bas de page dans cette section.
Gutter { get; set; }Obtient ou définit la quantité d’espace supplémentaire ajoutée à la marge pour la reliure du document.
HeaderDistance { get; set; }Renvoie ou définit la distance (en points) entre l’en-tête et le haut de la page.
HeadingLevelForChapter { get; set; }Obtient ou définit le style de niveau de titre appliqué aux titres de chapitre dans le document.
LayoutMode { get; set; }Obtient ou définit le mode de mise en page de cette section.
LeftMargin { get; set; }Renvoie ou définit la distance (en points) entre le bord gauche de la page et la limite gauche du corps du texte.
LineNumberCountBy { get; set; }Renvoie ou définit l’incrément numérique pour les numéros de ligne.
LineNumberDistanceFromText { get; set; }Obtient ou définit la distance entre le bord droit des numéros de ligne et le bord gauche du document.
LineNumberRestartMode { get; set; }Obtient ou définit la façon dont la numérotation des lignes s’exécute, qu’elle recommence au début d’une nouvelle page ou d’une nouvelle page ou section ou qu’elle s’exécute en continu.
LinesPerPage { get; set; }Obtient ou définit le nombre de lignes par page dans la grille du document.
LineStartingNumber { get; set; }Obtient ou définit le numéro de la ligne de départ.
Margins { get; set; }Renvoie ou définit le préréglageMargins de la page.
MultiplePages { get; set; }Pour les documents de plusieurs pages, obtient ou définit la manière dont un document est imprimé ou rendu afin qu’il puisse être relié sous forme de livret.
OddAndEvenPagesHeaderFooter { get; set; }Vrai si le document comporte des en-têtes et des pieds de page différents pour les pages impaires et paires.
Orientation { get; set; }Renvoie ou définit l’orientation de la page.
OtherPagesTray { get; set; }Obtient ou définit le bac à papier à utiliser pour toutes les pages d’une section sauf la première. La valeur est spécifique à l’implémentation (imprimante).
PageHeight { get; set; }Renvoie ou définit la hauteur de la page en points.
PageNumberStyle { get; set; }Obtient ou définit le format du numéro de page.
PageStartingNumber { get; set; }Obtient ou définit le numéro de page de début de la section.
PageWidth { get; set; }Renvoie ou définit la largeur de la page en points.
PaperSize { get; set; }Renvoie ou définit le format du papier.
RestartPageNumbering { get; set; }Vrai si la numérotation des pages redémarre au début de la section.
RightMargin { get; set; }Renvoie ou définit la distance (en points) entre le bord droit de la page et la limite droite du corps du texte.
RtlGutter { get; set; }Obtient ou définit si Microsoft Word utilise des gouttières pour la section basée sur une langue de droite à gauche ou une langue de gauche à droite.
SectionStart { get; set; }Renvoie ou définit le type de saut de section pour l’objet spécifié.
SheetsPerBooklet { get; set; }Renvoie ou définit le nombre de pages à inclure dans chaque livret.
SuppressEndnotes { get; set; }Vrai si les notes de fin sont imprimées à la fin de la section suivante qui ne supprime pas les notes de fin. Les notes de fin supprimées sont imprimées avant les notes de fin de cette section.
TextColumns { get; }Renvoie une collection qui représente l’ensemble des colonnes de texte.
TextOrientation { get; set; }Permet de préciserTextOrientation pour toute la page. La valeur par défaut estHorizontal
TopMargin { get; set; }Renvoie ou définit la distance (en points) entre le bord supérieur de la page et la limite supérieure du corps du texte.
VerticalAlignment { get; set; }Renvoie ou définit l’alignement vertical du texte sur chaque page d’un document ou d’une section.

Méthodes

NomLa description
ClearFormatting()Réinitialise la mise en page au format de papier, aux marges et à l’orientation par défaut.

Remarques

PageSetup L’objet contient tous les attributs de mise en page d’une section (marge gauche, marge inférieure, format de papier, etc.) en tant que propriétés.

Exemples

Montre comment appliquer et rétablir les paramètres de mise en page aux sections d’un document.

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

// Modifie les propriétés de mise en page de la section actuelle du générateur et ajoute du texte.
builder.PageSetup.Orientation = Orientation.Landscape;
builder.PageSetup.VerticalAlignment = PageVerticalAlignment.Center;
builder.Writeln("This is the first section, which landscape oriented with vertically centered text.");

// Si on démarre une nouvelle section en utilisant un générateur de documents,
// il héritera des propriétés de mise en page actuelles du constructeur.
builder.InsertBreak(BreakType.SectionBreakNewPage);

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

// Nous pouvons rétablir ses propriétés de mise en page à leurs valeurs par défaut en utilisant la méthode "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");

Voir également