PageSetup

PageSetup class

Representa las propiedades de configuración de página de una sección.

Para obtener más información, visite elTrabajar con secciones artículo de documentación.

public class PageSetup

Propiedades

NombreDescripción
Bidi { get; set; }Especifica que esta sección contiene texto bidireccional (scripts complejos).
BorderAlwaysInFront { get; set; }Especifica dónde se coloca el borde de la página en relación con los textos y objetos que se cruzan.
BorderAppliesTo { get; set; }Especifica en qué páginas se imprime el borde de la página.
BorderDistanceFrom { get; set; }Obtiene o establece un valor que indica si el borde de la página especificada se mide desde el borde de la página o desde el texto que rodea.
Borders { get; }Obtiene una colección de los bordes de la página.
BorderSurroundsFooter { get; set; }Especifica si el borde de la página incluye o excluye el pie de página.
BorderSurroundsHeader { get; set; }Especifica si el borde de la página incluye o excluye el encabezado.
BottomMargin { get; set; }Devuelve o establece la distancia (en puntos) entre el borde inferior de la página y el límite inferior del cuerpo del texto.
ChapterPageSeparator { get; set; }Obtiene o establece el carácter separador que aparece entre el número de capítulo y el número de página.
CharactersPerLine { get; set; }Obtiene o establece el número de caracteres por línea en la cuadrícula del documento.
DifferentFirstPageHeaderFooter { get; set; }Verdadero si se utiliza un encabezado o pie de página diferente en la primera página.
EndnoteOptions { get; }Proporciona opciones que controlan la numeración y la posición de las notas finales en esta sección.
FirstPageTray { get; set; }Obtiene o establece la bandeja de papel (bandeja) que se utilizará para la primera página de una sección. El valor es específico de la implementación (impresora).
FooterDistance { get; set; }Devuelve o establece la distancia (en puntos) entre el pie de página y la parte inferior de la página.
FootnoteOptions { get; }Proporciona opciones que controlan la numeración y la posición de las notas al pie en esta sección.
Gutter { get; set; }Obtiene o establece la cantidad de espacio adicional agregado al margen para la encuadernación del documento.
HeaderDistance { get; set; }Devuelve o establece la distancia (en puntos) entre el encabezado y la parte superior de la página.
HeadingLevelForChapter { get; set; }Obtiene o establece el estilo de nivel de encabezado que se aplica a los títulos de los capítulos en el documento.
LayoutMode { get; set; }Obtiene o establece el modo de diseño de esta sección.
LeftMargin { get; set; }Devuelve o establece la distancia (en puntos) entre el borde izquierdo de la página y el límite izquierdo del cuerpo del texto.
LineNumberCountBy { get; set; }Devuelve o establece el incremento numérico para los números de línea.
LineNumberDistanceFromText { get; set; }Obtiene o establece la distancia entre el borde derecho de los números de línea y el borde izquierdo del documento.
LineNumberRestartMode { get; set; }Obtiene o establece la forma en que se ejecuta la numeración de líneas, es decir, si comienza de nuevo al principio de una nueva página o sección o se ejecuta continuamente.
LinesPerPage { get; set; }Obtiene o establece el número de líneas por página en la cuadrícula del documento.
LineStartingNumber { get; set; }Obtiene o establece el número de línea inicial.
Margins { get; set; }Devuelve o establece valores preestablecidosMargins de la página.
MultiplePages { get; set; }Para documentos de varias páginas, obtiene o establece cómo se imprime o representa un documento para que pueda encuadernarse como un folleto.
OddAndEvenPagesHeaderFooter { get; set; }Verdadero si el documento tiene diferentes encabezados y pies de página para páginas pares e impares.
Orientation { get; set; }Devuelve o establece la orientación de la página.
OtherPagesTray { get; set; }Obtiene o establece la bandeja de papel (bandeja) que se utilizará para todas las páginas excepto la primera de una sección. El valor es específico de la implementación (impresora).
PageHeight { get; set; }Devuelve o establece la altura de la página en puntos.
PageNumberStyle { get; set; }Obtiene o establece el formato del número de página.
PageStartingNumber { get; set; }Obtiene o establece el número de página inicial de la sección.
PageWidth { get; set; }Devuelve o establece el ancho de la página en puntos.
PaperSize { get; set; }Devuelve o establece el tamaño del papel.
RestartPageNumbering { get; set; }Verdadero si la numeración de páginas se reinicia al principio de la sección.
RightMargin { get; set; }Devuelve o establece la distancia (en puntos) entre el borde derecho de la página y el límite derecho del cuerpo del texto.
RtlGutter { get; set; }Obtiene o establece si Microsoft Word usa medianiles para la sección en función de un idioma de derecha a izquierda o de izquierda a derecha.
SectionStart { get; set; }Devuelve o establece el tipo de salto de sección para el objeto especificado.
SheetsPerBooklet { get; set; }Devuelve o establece el número de páginas que se incluirán en cada folleto.
SuppressEndnotes { get; set; }Verdadero si las notas finales se imprimen al final de la siguiente sección que no suprime las notas finales. Las notas finales suprimidas se imprimen antes de las notas finales de esa sección.
TextColumns { get; }Devuelve una colección que representa el conjunto de columnas de texto.
TextOrientation { get; set; }Permite especificarTextOrientation para toda la página. El valor predeterminado esHorizontal
TopMargin { get; set; }Devuelve o establece la distancia (en puntos) entre el borde superior de la página y el límite superior del cuerpo del texto.
VerticalAlignment { get; set; }Devuelve o establece la alineación vertical del texto en cada página de un documento o sección.

Métodos

NombreDescripción
ClearFormatting()Restablece la configuración de página al tamaño, márgenes y orientación predeterminados del papel.

Observaciones

PageSetup El objeto contiene todos los atributos de configuración de página de una sección (margen izquierdo, margen inferior, tamaño de papel, etc.) como propiedades.

Ejemplos

Muestra cómo aplicar y revertir la configuración de configuración de página a secciones de un documento.

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

// Modifica las propiedades de configuración de la página para la sección actual del constructor y agrega texto.
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 comenzamos una nueva sección usando un generador de documentos,
// heredará las propiedades de configuración de página actual del constructor.
builder.InsertBreak(BreakType.SectionBreakNewPage);

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

// Podemos revertir las propiedades de configuración de la página a sus valores predeterminados usando el método "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");

Ver también