Funciones de configuración de página
A veces, es necesario configurar la configuración de página para hojas de cálculo para controlar la impresión. Estas configuraciones ofrecen varias opciones.
Opciones de página
Las opciones de configuración de página son totalmente compatibles en Aspose.Cells. Este artículo explica cómo establecer opciones de página con Aspose.Cells.
Configurando Opciones de Página
Aspose.Cells proporciona una clase, Workbook, que representa un archivo de Microsoft Excel. La clase Workbook contiene una colección Worksheets que permite acceder a cada hoja de cálculo en el archivo de Excel. Una hoja de cálculo está representada por la clase Worksheet.
La clase Worksheet proporciona la propiedad PageSetup, que se utiliza para establecer opciones de configuración de página. De hecho, la propiedad PageSetup es un objeto de la clase PageSetup que hace posible configurar opciones de diseño de página para una hoja de cálculo impresa. La clase PageSetup proporciona varias propiedades que se utilizan para establecer opciones de configuración de página. Algunas de estas propiedades se discuten a continuación.
Orientación de Página
La orientación de página se puede establecer en vertical u horizontal usando el método setOrientation(PageOrientationType) de la clase PageSetup. El método setOrientation(PageOrientationType) toma la enumeración PageOrientationType como parámetro. A continuación se enumeran los miembros de la enumeración PageOrientationType.
| Tipos de Orientación de Página | Descripción |
|---|---|
| HORIZONTAL | Orientación horizontal |
| VERTICAL | Orientación vertical |
Factor de Escala
Es posible reducir o ampliar el tamaño de una hoja de cálculo ajustando el factor de escala con el método setZoom de la clase PageSetup.
Opciones Ajustar a Páginas
Para ajustar el contenido de la hoja de cálculo a un número específico de páginas, utiliza los métodos setFitToPagesTall y setFitToPagesWide de la clase PageSetup. También se utilizan estos métodos para escalar las hojas de cálculo.
Tamaño de papel
Establece el tamaño de papel al que se imprimirán las hojas de cálculo utilizando la propiedad PaperSize de la clase PageSetup. La propiedad PaperSize acepta uno de los valores predefinidos en la enumeración PaperSizeType, que se enumeran a continuación.
| Tipos de Tamaño de Papel | Descripción |
|---|---|
| Paper10x14 | 10 in. x 14 in. |
| Paper11x17 | 11 in. x 17 in. |
| PaperA3 | A3 (297 mm x 420 mm) |
| PaperA4 | A4 (210 mm x 297 mm) |
| PaperA4Small | A4 Small (210 mm x 297 mm) |
| PaperA5 | A5 (148 mm x 210 mm) |
| PaperB3 | B3 (13.9 x 19.7 inches) |
| PaperB4 | B4 (250 mm x 354 mm) |
| PaperB5 | B5 (182 mm x 257 mm) |
| PaperBusinessCard | Business Card (90 mm x 55 mm) |
| PaperCSheet | C size sheet |
| PaperDSheet | D size sheet |
| PaperEnvelope10 | Envelope #10 (4-1/8 in. x 9-1/2 in.) |
| PaperEnvelope11 | Envelope #11 (4-1/2 in. x 10-3/8 in.) |
| PaperEnvelope12 | Envelope #12 (4-1/2 in. x 11 in.) |
| PaperEnvelope14 | Envelope #14 (5 in. x 11-1/2 in.) |
| PaperEnvelope9 | Envelope #9 (3-7/8 in. x 8-7/8 in.) |
| PaperEnvelopeB4 | Envelope B4 (250 mm x 353 mm) |
| PaperEnvelopeB5 | Envelope B5 (176 mm x 250 mm) |
| PaperEnvelopeB6 | Envelope B6 (176 mm x 125 mm) |
| PaperEnvelopeC3 | Envelope C3 (324 mm x 458 mm) |
| PaperEnvelopeC4 | Envelope C4 (229 mm x 324 mm) |
| PaperEnvelopeC5 | Envelope C5 (162 mm x 229 mm) |
| PaperEnvelopeC6 | Envelope C6 (114 mm x 162 mm) |
| PaperEnvelopeC65 | Envelope C65 (114 mm x 229 mm) |
| PaperEnvelopeDL | Envelope DL (110 mm x 220 mm) |
| PaperEnvelopeItaly | Envelope Italy (110 mm x 230 mm) |
| PaperEnvelopeMonarch | Envelope Monarch (3-7/8 in. x 7-1/2 in.) |
| PaperEnvelopePersonal | Envelope (3-5/8 in. x 6-1/2 in.) |
| PaperESheet | E size sheet |
| PaperExecutive | Executive (7-1/2 in. x 10-1/2 in.) |
| PaperFanfoldLegalGerman | German Legal Fanfold (8-1/2 in. x 13 in.) |
| PaperFanfoldStdGerman | German Standard Fanfold (8-1/2 in. x 12 in.) |
| PaperFanfoldUS | U.S. Standard Fanfold (14-7/8 in. x 11 in.) |
| PaperFolio | Folio (8-1/2 in. x 13 in.) |
| PaperLedger | Ledger (17 in. x 11 in.) |
| PaperLegal | Legal (8-1/2 in. x 14 in.) |
| PaperLetter | Letter (8-1/2 in. x 11 in.) |
| PaperLetterSmall | Letter Small (8-1/2 in. x 11 in.) |
| PaperNote | Note (8-1/2 in. x 11 in.) |
| PaperQuarto | Quarto (215 mm x 275 mm) |
| PaperStatement | Statement (5-1/2 in. x 8-1/2 in.) |
| PaperTabloid | Tabloid (11 in. x 17 in.) |
Calidad de impresión
Establece la calidad de impresión de las hojas de cálculo que se imprimirán con el método setPrintQuality de la clase PageSetup. La unidad de medida de la calidad de impresión es puntos por pulgada (PPP).
Número de primera página
Inicia la numeración de las páginas de la hoja de cálculo utilizando el método setFirstPageNumber de la clase PageSetup. El método setFirstPageNumber establece el número de página de la primera página de la hoja de cálculo y las páginas siguientes se numeran en orden ascendente.
Configurando Márgenes
Aspose.Cells soporta completamente las opciones de configuración de página de Microsoft Excel. Los desarrolladores pueden necesitar configurar ajustes de configuración de página para hojas de cálculo para controlar el proceso de impresión. Este tema discute cómo usar Aspose.Cells para configurar márgenes de página.
Márgenes de página en Microsoft Excel
Aspose.Cells proporciona una clase, Workbook que representa un archivo de Microsoft Excel. La clase Workbook contiene la colección Worksheets que permite acceder a cada hoja de cálculo en un archivo de Excel. Una hoja de cálculo está representada por la clase Worksheet.
La clase Worksheet proporciona la propiedad PageSetup, que se utiliza para establecer opciones de configuración de página. El atributo PageSetup es un objeto de la clase PageSetup, lo que permite establecer diferentes opciones de diseño de página para una hoja de cálculo impresa. La clase PageSetup proporciona varias propiedades y métodos que se utilizan para establecer opciones de configuración de página.
Márgenes de Página
Establece los márgenes (izquierdo, derecho, superior, inferior) de una página con los miembros de la clase PageSetup. A continuación, se enumeran algunos de los métodos utilizados para especificar los márgenes de página:
Centrar en la Página
Es posible centrar algo en una página horizontal y verticalmente. La clase PageSetup dispone de miembros con este propósito: setCenterHorizontally y setCenterVertically.
Márgenes de Encabezado y Pie de Página
Establece márgenes de encabezado y pie de página con miembros de PageSetup tales como setHeaderMargin y setFooterMargin.
Configuración de encabezados y pies de página
Los encabezados y pies de página son secciones de texto e imágenes por encima del margen superior o por debajo del margen inferior de una página. También es posible agregar encabezados y pies de página a hojas de cálculo. Los encabezados y pies de página pueden utilizarse para mostrar cualquier tipo de información útil, como el número de página, nombre del autor, título del documento o fecha y hora. Los encabezados y pies de página también se gestionan utilizando el cuadro de diálogo Configuración de Página.
El cuadro de diálogo Configuración de Página
Aspose.Cells permite agregar encabezados y pies de página a las hojas de cálculo en tiempo de ejecución, pero se recomienda que los encabezados y pies de página se configuren manualmente en un archivo pre-diseñado para la impresión. Puedes utilizar Microsoft Excel como una herramienta gráfica para configurar fácilmente los encabezados y pies de página y así reducir el tiempo de desarrollo. Aspose.Cells puede importar el archivo y mantener estas configuraciones.
Para agregar encabezados y pies de página en tiempo de ejecución, Aspose.Cells proporciona clases especiales y algunos comandos de script para controlar el formato.
Comandos de Script
Los comandos de script son comandos especiales proporcionados por Aspose.Cells que permiten a los desarrolladores dar formato a los encabezados y pies de página.
| Comandos de Script | Descripción |
|---|---|
| &P | El número de página actual. |
| &G | Una imagen. |
| &N | El número total de páginas. |
| &D | La fecha actual. |
| &T | La hora actual. |
| &A | El nombre de la hoja de cálculo. |
| &F | El nombre del archivo sin la ruta. |
| &"<FontName>" | Un nombre de fuente. Por ejemplo: &“Arial” |
| &"<FontName>, <FontStyle>" | Un nombre de fuente con un estilo. Por ejemplo: &“Arial,Negrita” |
| &<FontSize> | Representa el tamaño de la fuente. Por ejemplo: “&14abc”. Sin embargo, si este comando va seguido de un número normal a imprimir en el encabezado, esto debe separarse con un carácter de espacio del tamaño de la fuente. Por ejemplo: “&14 123”. |
Establecer Encabezados y Pies de Página
La clase PageSetup proporciona el método setHeader para agregar un encabezado y setFooter para agregar un pie de página a una hoja de cálculo. El script se utiliza como argumento para todos los métodos mencionados anteriormente. Representa el script a usar para el encabezado o pie de página. Este script contiene comandos de script para formatear encabezados o pies de página.
Insertar un Gráfico en un Encabezado o Pie de Página
La clase PageSetup tiene los métodos setHeadPicture y setFooterPicture para agregar imágenes al encabezado y pie de página de una hoja de cálculo. Estos métodos reciben dos parámetros:
- Sección, la sección del encabezado o pie de página donde se colocará la imagen. Hay tres secciones: izquierda, centro y derecha, representadas por los valores numéricos 0, 1 y 2 respectivamente.
- Flujo de Entrada de Archivo, los datos gráficos. Los datos binarios deben ser escritos en el búfer de una matriz de bytes.
Después de ejecutar el código y abrir el archivo, verifica el encabezado de la hoja de cálculo en Microsoft Excel:
- En el menú Archivo, selecciona Configurar Página.
- En el cuadro de diálogo Configurar Página, selecciona la pestaña Encabezado/Pie de Página.
Insertar un gráfico en un encabezado/pie de página
Insertar un Gráfico solo en el Encabezado de la Primera Página
La clase PageSetup también tiene otros métodos útiles, como setPicture, setFirstPageHeader, setFirstPageFooter, para agregar imágenes al encabezado/pie de página de la primera página de una hoja de cálculo. La primera página es especial: es común querer que muestre información especial, por ejemplo, un logotipo de empresa.
Configuración de Opciones de Impresión
Los ajustes de configuración de página de Microsoft Excel proporcionan varias opciones de impresión (también conocidas como opciones de hoja) que permiten a los usuarios controlar cómo se imprimen las páginas de la hoja de cálculo. Estas opciones de impresión permiten a los usuarios:
- Seleccionar un área de impresión específica en una hoja de cálculo.
- Títulos de impresión.
- Líneas de cuadrícula de impresión.
- Imprimir encabezados de filas y columnas
- Lograr calidad de borrador.
- Comentarios de impresión.
- Errores de celda de impresión.
- Definir el orden de páginas.
Todas estas opciones de impresión se muestran a continuación.
Opciones de impresión (hoja)
Configuración de opciones de impresión y hoja
spose.Cells admite todas las opciones de impresión ofrecidas por Microsoft Excel y los desarrolladores pueden configurar fácilmente estas opciones para hojas de cálculo utilizando las propiedades ofrecidas por la clase PageSetup. Cómo se utilizan estas propiedades se discute a continuación con más detalle.
Establecer Área de Impresión
De forma predeterminada, solo el área de impresión incorpora todas las áreas de la hoja de trabajo que contienen datos. Los desarrolladores pueden establecer un área de impresión específica de la hoja de trabajo.
Para seleccionar un área de impresión específica, utilice la propiedad setPrintArea de la clase PageSetup. Asigne un rango de celdas que defina el área de impresión a esta propiedad.
Establecer Títulos de Impresión
Aspose.Cells le permite designar encabezados de fila y columna para repetir en todas las páginas de una hoja de cálculo impresa. Para hacerlo, utilice las propiedades setPrintTitleColumns y setPrintTitleRows de la clase PageSetup.
Las filas o columnas que se repetirán se definen pasando sus números de fila o columna. Por ejemplo, las filas se definen como $1:$2 y las columnas se definen como $A:$B.
Establecer Otras Opciones de Impresión
La clase PageSetup también proporciona varias otras propiedades para establecer opciones generales de impresión como sigue:
- setPrintGridlines, una propiedad booleana que define si imprimir las líneas de la cuadrícula o no imprimir.
- setPrintHeadings, una propiedad booleana que define si imprimir los encabezados de fila y columna o no imprimirlos.
- setBlackAndWhite, una propiedad booleana que define si imprimir la hoja de cálculo en modo blanco y negro o no.
- setPrintComments, define si mostrar los comentarios de impresión en la hoja de cálculo o al final de la hoja de cálculo.
- setPrintDraft, una propiedad booleana que define si imprimir la hoja de cálculo en calidad preliminar o no.
- setPrintErrors, define si imprimir los errores de celda tal como se muestran, en blanco, con un guion o como N/A.
Para establecer las propiedades PrintComments y PrintErrors, Aspose.Cells también proporciona dos enumeraciones, PrintCommentsType y PrintErrorsType, que contienen valores predefinidos para ser asignados a las propiedades setPrintComments y setPrintErrors respectivamente.
Los valores predefinidos en la enumeración PrintCommentsType se describen a continuación.
| Tipos de Imprimir Comentarios | Descripción |
|---|---|
| PRINT_IN_PLACE | Especifica imprimir comentarios tal como se muestran en la hoja de cálculo. |
| PRINT_NO_COMMENTS | Especifica no imprimir comentarios. |
| PRINT_SHEET_END | Especifica imprimir comentarios al final de la hoja de cálculo. |
Los valores predefinidos de la enumeración PrintErrorsType se describen a continuación.
| Tipos de Imprimir Errores | Descripción |
|---|---|
| PRINT_ERRORS_BLANK | Especifica no imprimir errores. |
| PRINT_ERRORS_DASH | Especifica imprimir errores como “–”. |
| PRINT_ERRORS_DISPLAYED | Especifica imprimir errores tal como se muestran. |
| PRINT_ERRORS_NA | Especifica imprimir errores como “#N/A”. |
Establecer Orden de Páginas
La clase PageSetup proporciona la propiedad setOrder que se utiliza para ordenar múltiples páginas de su hoja de cálculo para imprimir. Hay dos posibilidades de ordenar las páginas de la siguiente manera:
- Abajo y luego a la derecha imprime todas las páginas hacia abajo antes de imprimir cualquier página hacia la derecha.
- A la derecha y luego hacia abajo imprime las páginas de izquierda a derecha antes de imprimir cualquier página debajo.
Aspose.Cells proporciona una enumeración, PrintOrderType, que contiene todos los tipos de orden predefinidos para ser asignados al método setOrder.
Los valores predefinidos de la enumeración PrintOrderType se describen a continuación.
| Tipos de Orden de Impresión | Descripción |
|---|---|
| DOWN_THEN_OVER | Imprime hacia abajo, luego a la derecha. |
| OVER_THEN_DOWN | Imprime hacia la derecha, luego hacia abajo. |
Eliminar la configuración existente de PrinterSettings de las hojas de cálculo en el archivo de Excel
Por favor, consulte este artículo relacionado con este tema.
Temas avanzados
- Calcular Factor de Escalado de la Configuración de Página
- Copiar Configuraciones de Configuración de Página de la Hoja de Cálculo de Origen en la Hoja de Cálculo de Destino
- Determinar si el tamaño de papel de la hoja de cálculo es automático
- Obtener Ancho y Alto del Papel desde la Configuración de Página de la Hoja de Trabajo
- Implementar Tamaño de Papel Personalizado de la Hoja de Cálculo para el Renderizado
- Configuración de página y opciones de impresión
- Eliminar la configuración existente de PrinterSettings de las hojas de cálculo en el archivo de Excel