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 diesen fest, der angibt, ob der angegebene Seitenrand vom Rand der Seite oder vom Text, den er umgibt, 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 ausschließt.
BorderSurroundsHeader { get; set; }Gibt an, ob der Seitenrand die Kopfzeile einschließt oder ausschließt.
BottomMargin { get; set; }Gibt den Abstand (in Punkt) zwischen dem unteren Rand der Seite und der unteren Grenze des Textkörpers zurück oder legt ihn fest.
ChapterPageSeparator { get; set; }Ruft das Trennzeichen ab, das zwischen der Kapitelnummer und der Seitennummer angezeigt wird, oder legt dieses fest.
CharactersPerLine { get; set; }Ruft die Anzahl der Zeichen pro Zeile im Dokumentraster ab oder legt diese fest.
DifferentFirstPageHeaderFooter { get; set; }True, 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 Papierfach (Fach) ab, das für die erste Seite eines Abschnitts verwendet werden soll, oder legt dieses fest. Der Wert ist spezifisch für die Implementierung (Drucker).
FooterDistance { get; set; }Gibt den Abstand (in Punkt) zwischen der Fußzeile und dem unteren Rand der Seite zurück oder legt diesen fest.
FootnoteOptions { get; }Bietet Optionen zur Steuerung der Nummerierung und Positionierung von Fußnoten in diesem Abschnitt.
Gutter { get; set; }Ruft die Menge an zusätzlichem Platz ab, der dem 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 Rand der Seite zurück oder legt diesen fest.
HeadingLevelForChapter { get; set; }Ruft den Stil der Überschriftenebene ab, der auf die Kapiteltitel im Dokument angewendet wird, oder legt diesen fest.
LayoutMode { get; set; }Ruft den Layoutmodus dieses Abschnitts ab oder legt diesen fest.
LeftMargin { get; set; }Gibt den Abstand (in Punkt) zwischen dem linken Rand der Seite und der linken Grenze des Textkörpers 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 dem rechten Rand der Zeilennummern und dem linken Rand des Dokuments ab oder legt diesen fest.
LineNumberRestartMode { get; set; }Ruft ab oder legt fest, wie die Zeilennummerierung ausgeführt wird, d. h. ob sie am Anfang einer neuen Seite oder eines neuen Abschnitts neu beginnt oder fortlaufend ausgeführt wird.
LinesPerPage { get; set; }Ruft die Anzahl der Zeilen pro Seite im Dokumentraster ab oder legt diese fest.
LineStartingNumber { get; set; }Ruft die Startzeilennummer ab oder legt sie fest.
Margins { get; set; }Gibt die Voreinstellung zurück oder legt sie festMargins 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; }True, wenn das Dokument unterschiedliche Kopf- und Fußzeilen für ungeradzahlige und gerade nummerierte Seiten hat.
Orientation { get; set; }Gibt die Ausrichtung der Seite zurück oder legt sie fest.
OtherPagesTray { get; set; }Ruft das Papierfach (Ablagefach) ab, das für alle außer der ersten Seite eines Abschnitts verwendet werden soll, oder legt es fest. Der Wert ist Implementierungs-(Drucker-)spezifisch.
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 erste Seitenzahl des Abschnitts ab oder legt diese fest.
PageWidth { get; set; }Gibt die Breite der Seite in Punkten zurück oder legt sie fest.
PaperSize { get; set; }Gibt das Papierformat zurück oder legt es fest.
RestartPageNumbering { get; set; }True, wenn die Seitennummerierung am Anfang des Abschnitts neu beginnt.
RightMargin { get; set; }Gibt den Abstand (in Punkt) zwischen dem rechten Rand der Seite und der rechten Grenze des Textkörpers zurück oder legt ihn fest.
RtlGutter { get; set; }Ruft ab oder legt fest, ob Microsoft Word für den Abschnitt Zwischenstege basierend auf einer Rechts-nach-Links-Sprache oder einer Links-nach-rechts-Sprache verwendet.
SectionStart { get; set; }Gibt den Typ des Abschnittsumbruchs für das angegebene Objekt zurück oder legt diesen fest.
SheetsPerBooklet { get; set; }Gibt die Anzahl der Seiten zurück, die in jede Broschüre aufgenommen werden sollen, oder legt sie fest.
SuppressEndnotes { get; set; }True, wenn Endnoten am Ende des nächsten Abschnitts gedruckt werden, der keine Endnoten unterdrückt. Unterdrückte Endnoten werden vor den Endnoten in diesem Abschnitt gedruckt.
TextColumns { get; }Gibt eine Sammlung zurück, die den Satz von Textspalten darstellt.
TextOrientation { get; set; }Ermöglicht die AngabeTextOrientation für die gesamte Seite. Der Standardwert istHorizontal
TopMargin { get; set; }Gibt den Abstand (in Punkt) zwischen dem oberen Rand der Seite und der oberen Grenze des Textkörpers zurück oder legt ihn fest.
VerticalAlignment { get; set; }Gibt die vertikale Ausrichtung des Texts auf jeder Seite in einem Dokument oder Abschnitt zurück oder legt diese 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 Seiteneinrichtungseinstellungen auf Abschnitte in einem Dokument angewendet und wiederhergestellt werden.

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 Document Builder beginnen,
// Es erbt die aktuellen Seiteneinrichtungseigenschaften des Builders.
builder.InsertBreak(BreakType.SectionBreakNewPage);

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

// Mit der Methode „ClearFormatting“ können wir die Seiteneinrichtungseigenschaften 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