Formatos de las Celdas
Añadiendo Bordes a las Celdas
Microsoft Excel permite a los usuarios formatear celdas añadiendo bordes.
Configuración de bordes en Microsoft Excel
El tipo de borde depende de dónde se añada. Por ejemplo, un borde superior se añade en la posición superior de una celda. Los usuarios también pueden modificar el estilo de línea y el color de los bordes.
Con Aspose.Cells, los desarrolladores pueden añadir bordes y personalizar su apariencia de la misma forma flexible que en Microsoft Excel.
Añadiendo Bordes a las Celdas
Aspose.Cells proporciona una clase, Workbook que representa un archivo de Microsoft Excel. La clase Workbook contiene una WorksheetCollection 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 una colección de Cells. Cada ítem en la colección de Cells representa un objeto de la clase Cell.
Aspose.Cells proporciona el método setStyle en la clase Cell usado para establecer el estilo de formato de una celda. Además, se utiliza el objeto de la clase Style que proporciona propiedades para configurar la configuración de fuente.
Añadir bordes a una celda
Añadir bordes a una celda con el método setBorder del objeto Style. El tipo de borde se pasa como parámetro. Todos los tipos de bordes están predefinidos en la enumeración BorderType.
| Tipos de Bordes | Descripción |
|---|---|
| BOTTOM_BORDER | La línea de borde inferior |
| DIAGONAL_DOWN | Una línea diagonal de arriba izquierda a abajo derecha |
| DIAGONAL_UP | Una línea diagonal de abajo izquierda a arriba derecha |
| LEFT_BORDER | La línea de borde izquierdo |
| RIGHT_BORDER | La línea de borde derecho |
| TOP_BORDER | La línea de borde superior |
| HORIZONTAL | Solo para estilos dinámicos, como el formato condicional. |
| VERTICAL | Solo para estilo dinámico, como formato condicional. |
| Para establecer el color de la línea, seleccione un color utilizando la enumeración Color y páselo al parámetro Color del método setBorder del objeto Style. Los estilos de línea están predefinidos en la enumeración CellBorderType. |
| Estilos de Línea | Descripción |
|---|---|
| DASH_DOT | Representa línea de guion punteado fina |
| DASH_DOT_DOT | Representa línea de guion punto-punto-punteado fina |
| DASHED | Representa línea punteada |
| DOTTED | Representa línea de puntos |
| DOUBLE | Representa línea doble |
| HAIR | Representa línea fina |
| MEDIUM_DASH_DOT | Representa línea de guion punteado medio |
| MEDIUM_DASH_DOT_DOT | Representa línea de guion punto-punto-punteado medio |
| MEDIUM_DASHED | Representa línea de guion medio |
| NONE | Representa ninguna línea |
| MEDIUM | Representa línea media |
| SLANTED_DASH_DOT | Representa línea de guion punteado medio inclinado |
| THICK | Representa línea gruesa |
| THIN | Representa línea fina |
| Seleccione uno de los estilos de línea anteriores y luego asígnelo al método setBorder del objeto Style. |
A continuación se genera la siguiente salida al ejecutar el código a continuación.
Bordes aplicados en todos los lados de una celda
Agregar bordes a un rango de celdas
Es posible agregar bordes a un rango de celdas en lugar de solo a una celda individual. Primero, cree un rango de celdas llamando al método createRange de la colección Cells, que toma los siguientes parámetros:
- Primera fila, la primera fila del rango.
- Primer columna, la primera columna del rango.
- Número de filas, el número de filas en el rango.
- Número de columnas, el número de columnas en el rango.
El método createRange devuelve un objeto Range, que contiene el rango especificado. El objeto Range proporciona un método setOutlineBorders que toma los siguientes parámetros:
- Tipo de borde de celda, el estilo de la línea de borde, seleccionado de la enumeración CellBorderType.
- Color, el color de la línea de borde, seleccionado de la enumeración Color.
A continuación se genera la siguiente salida al ejecutar el código a continuación.
Bordes aplicados en un rango de celdas
Colores y paleta
Una paleta es el número de colores disponibles para utilizar en la creación de una imagen. El uso de una paleta estandarizada en una presentación permite al usuario crear un aspecto consistente. Cada archivo de Microsoft Excel (97-2003) tiene una paleta de 56 colores que se pueden aplicar a celdas, fuentes, líneas de cuadrícula, objetos gráficos, rellenos y líneas en un gráfico.
Configuraciones de paleta en Microsoft Excel
Con Aspose.Cells no solo es posible utilizar colores existentes, sino también colores personalizados. Antes de usar un color personalizado, agréguelo a la paleta. Este tema explica cómo agregar colores personalizados a la paleta.
Agregar colores personalizados a la paleta
Aspose.Cells también admite una paleta de 56 colores. Una paleta de colores estándar se muestra arriba. Si desea utilizar un color personalizado que no está definido en la paleta, deberá agregar ese color a la paleta antes de usarlo.
Aspose.Cells proporciona una clase, Workbook, que representa un archivo de Microsoft Excel. La clase proporciona el método changePalette que toma los siguientes parámetros para agregar un color personalizado y modificar la paleta:
- Color personalizado, el color personalizado que se agregará a la paleta.
- Índice, el índice del color que será reemplazado con el color personalizado. Debe estar entre 0 y 55.
El ejemplo a continuación agrega un color personalizado a la paleta antes de aplicarlo a una fuente.
Colores y patrones de fondo
Microsoft Excel puede establecer los colores de primer plano (contorno) y de fondo (relleno) de celdas y patrones de fondo, como se muestra a continuación.
Estableciendo colores y patrones de fondo en Microsoft Excel
Aspose.Cells también admite estas características de manera flexible. En este tema, aprenderemos a usar estas características utilizando Aspose.Cells.
Estableciendo Colores y Patrones de Fondo
Aspose.Cells proporciona una clase, Workbook, que representa un archivo de Microsoft Excel. La clase Workbook contiene un WorksheetCollection 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 una colección Cells. Cada elemento en la colección Cells representa un objeto de la clase Cell.
Aspose.Cells proporciona el método setStyle en la clase Cell que se utiliza para establecer el formato de una celda. También se puede utilizar el objeto de la clase Style para configurar la configuración de fuente.
La propiedad setForegroundColor establece el color de sombreado de la celda.
La propiedad setPattern especifica el patrón de fondo utilizado para el color de primer plano o de fondo. Aspose.Cells proporciona la enumeración BackgroundType que contiene un conjunto de tipos predefinidos de patrones de fondo.
| Tipo de Patrón | Descripción |
|---|---|
| DIAGONAL_CROSSHATCH | Representa un patrón de sombreado diagonal cruzado |
| DIAGONAL_STRIPE | Representa un patrón de raya diagonal |
| GRAY_6 | Representa un patrón de gris al 6.25% |
| GRAY_12 | Representa un patrón de gris al 12.5% |
| GRAY_25 | Representa un patrón de gris al 25% |
| GRAY_50 | Representa un patrón de gris al 50% |
| GRAY_75 | Representa un patrón de gris al 75% |
| HORIZONTAL_STRIPE | Representa un patrón de rayas horizontales |
| NONE | Representa sin fondo |
| REVERSE_DIAGONAL_STRIPE | Representa un patrón de rayas diagonales invertidas |
| SOLID | Representa un patrón sólido |
| THICK_DIAGONAL_CROSSHATCH | Representa un patrón de cuadrícula diagonal gruesa |
| THIN_DIAGONAL_CROSSHATCH | Representa un patrón de cuadrícula diagonal delgada |
| THIN_DIAGONAL_STRIPE | Representa un patrón de rayas diagonales delgadas |
| THIN_HORIZONTAL_CROSSHATCH | Representa un patrón de cuadrícula horizontal delgada |
| THIN_HORIZONTAL_STRIPE | Representa un patrón de rayas horizontales delgadas |
| THIN_REVERSE_DIAGONAL_STRIPE | Representa un patrón de rayas diagonales invertidas delgadas |
| THIN_VERTICAL_STRIPE | Representa un patrón de rayas verticales delgadas |
| VERTICAL_STRIPE | Representa un patrón de rayas verticales |
| En el ejemplo a continuación, el color de primer plano de la celda A1 está establecido pero A2 está configurada para tener tanto el color de primer plano como el color de fondo con un patrón de fondo de rayas verticales. |
La siguiente salida se genera al ejecutar el código.
Colores de primer plano y fondo aplicados en celdas con patrones de fondo
Importante saber
- Para configurar el color de primer plano o fondo de una celda, utilice las propiedades ForegroundColor o BackgroundColor del objeto Style. Ambas propiedades solo tendrán efecto si se configura la propiedad Pattern del objeto Style.
- La propiedad ForegroundColor establece el color de sombreado de la celda. La propiedad Pattern especifica el tipo de patrón de fondo utilizado para el color de primer plano o fondo. Aspose.Cells proporciona una enumeración, BackgroundType, que contiene un conjunto de tipos predefinidos de patrones de fondo.
- Si selecciona el valor BackgroundType.NONE de la enumeración BackgroundType, el color de primer plano no se aplica. Del mismo modo, el color de fondo no se aplica si selecciona los valores BackgroundType.NONE o BackgroundType.SOLID.
- Al recuperar el color de sombreado/relleno de una celda, si Style.Pattern es BackgroundType.NONE, Style.ForegroundColor devolverá Color.Empty.
Formato de caracteres seleccionados en una celda
El artículo Dealing with Font Settings explica cómo dar formato a las celdas, pero solo cómo dar formato al contenido de las celdas completas. ¿Qué ocurre si desea formatear solo algunos caracteres seleccionados?
Aspose.Cells admite esta función. Este tema explica cómo utilizar esta característica.
Formato de caracteres seleccionados
Aspose.Cells proporciona una clase, Workbook, que representa un archivo de Microsoft Excel. La clase Workbook contiene un WorksheetCollection 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 una colección Cells. Cada elemento en la colección Cells representa un objeto de la clase Cell.
La clase Cell proporciona un método characters que toma los siguientes parámetros para seleccionar un rango de caracteres en una celda:
- Índice de inicio, el índice del carácter desde el que se inicia la selección.
- Número de caracteres, el número de caracteres a seleccionar.
En el archivo de salida, en la celda A1, la palabra ‘Visitar’ está formateada con la fuente predeterminada pero ‘Aspose!’ está en negrita y azul.
Formato de caracteres seleccionados
Temas avanzados
- Configuración de alineación
- Formato condicional
- Formato de datos
- Temas y colores de Excel
- Tratamiento de configuraciones de fuente
- Dar formato a celdas de hoja de cálculo en un libro de trabajo
- Implementar el sistema de fechas 1904
- Combinar y descombinar celdas
- Configuración de números
- Preservar el prefijo de comilla simple del valor de la celda o rango
- Estilo y formato de datos