PageSetup

PageSetup class

Stellt die Seiteneinrichtungseigenschaften eines Abschnitts dar.

Um mehr zu erfahren, besuchen Sie dieArbeiten mit Abschnitten Dokumentationsartikel.

public class PageSetup

Eigenschaften

NameBeschreibung
Bidi { get; set; }Gibt an, dass dieser Abschnitt bidirektionalen Text (komplexe Skripts) enthält.
BorderAlwaysInFront { get; set; }Gibt an, wo der Seitenrand relativ zu sich überschneidenden Texten und Objekten positioniert wird.
BorderAppliesTo { get; set; }Gibt an, auf welchen Seiten der Seitenrand gedruckt wird.
BorderDistanceFrom { get; set; }Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob der angegebene Seitenrand vom Rand der Seite oder vom umgebenden Text gemessen wird.
Borders { get; }Ruft eine Sammlung der Seitenränder ab.
BorderSurroundsFooter { get; set; }Gibt an, ob der Seitenrand die Fußzeile einschließt oder nicht.
BorderSurroundsHeader { get; set; }Gibt an, ob der Seitenrand die Kopfzeile einschließt oder nicht.
BottomMargin { get; set; }Gibt den Abstand (in Punkten) zwischen der unteren Seitenkante und der unteren Begrenzung des Fließtextes zurück oder legt ihn fest.
ChapterPageSeparator { get; set; }Ruft das Trennzeichen ab, das zwischen der Kapitelnummer und der Seitenzahl angezeigt wird, oder legt dieses fest.
CharactersPerLine { get; set; }Ruft die Anzahl der Zeichen pro Zeile im Dokumentraster ab oder legt sie fest.
DifferentFirstPageHeaderFooter { get; set; }Wahr, wenn auf der ersten Seite eine andere Kopf- oder Fußzeile verwendet wird.
EndnoteOptions { get; }Bietet Optionen zur Steuerung der Nummerierung und Positionierung von Endnoten in diesem Abschnitt.
FirstPageTray { get; set; }Ruft das für die erste Seite eines Abschnitts zu verwendende Papierfach ab oder legt es fest. Der Wert ist implementierungsspezifisch (druckerspezifisch).
FooterDistance { get; set; }Gibt den Abstand (in Punkten) zwischen der Fußzeile und dem unteren Seitenrand zurück oder legt ihn fest.
FootnoteOptions { get; }Bietet Optionen zur Steuerung der Nummerierung und Positionierung von Fußnoten in diesem Abschnitt.
Gutter { get; set; }Ruft den zusätzlichen Platz ab, der zum Rand für die Dokumentbindung hinzugefügt wird, oder legt diesen fest.
HeaderDistance { get; set; }Gibt den Abstand (in Punkten) zwischen der Kopfzeile und dem oberen Seitenrand zurück oder legt ihn fest.
HeadingLevelForChapter { get; set; }Ruft den Überschriftenebenenstil ab oder legt ihn fest, der auf die Kapitelüberschriften im Dokument angewendet wird.
LayoutMode { get; set; }Ruft den Layoutmodus dieses Abschnitts ab oder legt ihn fest.
LeftMargin { get; set; }Gibt den Abstand (in Punkten) zwischen dem linken Seitenrand und der linken Begrenzung des Fließtextes zurück oder legt ihn fest.
LineNumberCountBy { get; set; }Gibt das numerische Inkrement für Zeilennummern zurück oder legt es fest.
LineNumberDistanceFromText { get; set; }Ruft den Abstand zwischen der rechten Kante der Zeilennummern und der linken Kante des Dokuments ab oder legt ihn fest.
LineNumberRestartMode { get; set; }Ruft die Art und Weise ab, in der die Zeilennummerierung ausgeführt wird, d. h., ob sie am Anfang einer neuen Seite oder eines neuen Abschnitts neu beginnt oder kontinuierlich ausgeführt wird.
LinesPerPage { get; set; }Ruft die Anzahl der Zeilen pro Seite im Dokumentraster ab oder legt sie fest.
LineStartingNumber { get; set; }Ruft die Startzeilennummer ab oder legt sie fest.
Margins { get; set; }Gibt die Voreinstellung zurück oder setzt sieMargins der Seite.
MultiplePages { get; set; }Ruft bei mehrseitigen Dokumenten ab oder legt fest, wie ein Dokument gedruckt oder gerendert wird, damit es als Broschüre gebunden werden kann.
OddAndEvenPagesHeaderFooter { get; set; }Wahr, wenn das Dokument unterschiedliche Kopf- und Fußzeilen für Seiten mit ungeraden und geraden Seitennummern hat.
Orientation { get; set; }Gibt die Ausrichtung der Seite zurück oder legt sie fest.
OtherPagesTray { get; set; }Ruft das Papierfach (Bin) ab, das für alle Seiten eines Abschnitts außer der ersten verwendet werden soll, oder legt es fest. Der Wert ist implementierungsspezifisch (druckerspezifisch).
PageHeight { get; set; }Gibt die Höhe der Seite in Punkten zurück oder legt sie fest.
PageNumberStyle { get; set; }Ruft das Seitenzahlenformat ab oder legt es fest.
PageStartingNumber { get; set; }Ruft die Startseitennummer des Abschnitts ab oder legt sie fest.
PageWidth { get; set; }Gibt die Breite der Seite in Punkten zurück oder legt sie fest.
PaperSize { get; set; }Gibt die Papiergröße zurück oder legt sie fest.
RestartPageNumbering { get; set; }Wahr, wenn die Seitennummerierung am Anfang des Abschnitts neu beginnt.
RightMargin { get; set; }Gibt den Abstand (in Punkten) zwischen dem rechten Seitenrand und der rechten Begrenzung des Fließtextes zurück oder legt ihn fest.
RtlGutter { get; set; }Ruft ab oder legt fest, ob Microsoft Word basierend auf einer Sprache, die von rechts nach links oder von links nach rechts geschrieben wird, Bundstege für den Abschnitt verwendet.
SectionStart { get; set; }Gibt den Typ des Abschnittsumbruchs für das angegebene Objekt zurück oder legt ihn fest.
SheetsPerBooklet { get; set; }Gibt die Anzahl der Seiten zurück, die in jeder Broschüre enthalten sein sollen, oder legt sie fest.
SuppressEndnotes { get; set; }Wahr, wenn Endnoten am Ende des nächsten Abschnitts gedruckt werden, der Endnoten nicht unterdrückt. Unterdrückte Endnoten werden vor den Endnoten in diesem Abschnitt gedruckt.
TextColumns { get; }Gibt eine Auflistung zurück, die den Satz von Textspalten darstellt.
TextOrientation { get; set; }Ermöglicht die AngabeTextOrientation für die ganze Seite. Der Standardwert istHorizontal
TopMargin { get; set; }Gibt den Abstand (in Punkten) zwischen der oberen Seitenkante und der oberen Begrenzung des Fließtextes zurück oder legt ihn fest.
VerticalAlignment { get; set; }Gibt die vertikale Ausrichtung des Textes auf jeder Seite in einem Dokument oder Abschnitt zurück oder legt sie fest.

Methoden

NameBeschreibung
ClearFormatting()Setzt die Seiteneinrichtung auf die Standardpapiergröße, -ränder und -ausrichtung zurück.

Bemerkungen

PageSetup Das Objekt enthält alle Seiteneinrichtungsattribute eines Abschnitts (linker Rand, unterer Rand, Papiergröße usw.) als Eigenschaften.

Beispiele

Zeigt, wie Sie Seiteneinrichtungseinstellungen auf Abschnitte in einem Dokument anwenden und zurücksetzen.

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

// Ändern Sie die Seiteneinrichtungseigenschaften für den aktuellen Abschnitt des Builders und fügen Sie Text hinzu.
builder.PageSetup.Orientation = Orientation.Landscape;
builder.PageSetup.VerticalAlignment = PageVerticalAlignment.Center;
builder.Writeln("This is the first section, which landscape oriented with vertically centered text.");

// Wenn wir einen neuen Abschnitt mit einem Dokumentgenerator beginnen,
// Es werden die aktuellen Seiteneinrichtungseigenschaften des Builders übernommen.
builder.InsertBreak(BreakType.SectionBreakNewPage);

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

// Wir können die Seiteneinrichtungseigenschaften mit der Methode „ClearFormatting“ auf ihre Standardwerte zurücksetzen.
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");

Siehe auch

PageBorderDistanceFrom Enum PageVerticalAlignment Enum