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 usa un objeto de la clase Style que proporciona propiedades para configurar las opciones de fuente.
Añadir bordes a una celda
Agrega 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 borde 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 derecha inferior |
| DIAGONAL_UP | Una línea diagonal de abajo izquierda a arriba derecha |
| LEFT_BORDER | La línea de borde izquierda |
| RIGHT_BORDER | La línea de borde derecha |
| 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 línea, selecciona un color utilizando la enumeración Color y pásalo al parámetro setBorder 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 una línea delgada raya-punto |
| DASH_DOT_DOT | Representa una línea delgada raya-punto-punto |
| DASHED | Representa línea punteada |
| DOTTED | Representa línea de puntos |
| DOUBLE | Representa línea doble |
| HAIR | Representa línea fina |
| MEDIO_DOS PUNTOS | Representa línea mediana de guiones y puntos |
| MEDIO_DOS PUNTOS_PUNTO | Representa línea de guiones y puntos medio |
| MEDIO_GUIONES | Representa línea de guiones medianos |
| NONE | Representa ninguna línea |
| MEDIUM | Representa línea media |
| DIAGONAL_DALTADA | Representa línea diagonal inclinada de guiones largos |
| THICK | Representa línea gruesa |
| THIN | Representa línea fina |
| Seleccione uno de los estilos de línea anteriores y luego asígnele al método setBorder del objeto Estilo. |
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. Primero, cree un rango de celdas llamando al método createRange de la colección Cells, que acepta 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 Rango, que contiene el rango especificado. El objeto Rango proporciona un método setOutlineBorders que acepta 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 ofrece 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 usa para establecer el formato de una celda. Además, el objeto de la clase Style puede usarse para configurar las opciones 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 |
|---|---|
| CROSSHATCH_DIAGONAL | Representa un patrón de rayas diagonales cruzadas |
| RAYAS_DIAGONALES | Representa un patrón de rayas diagonales |
| GRIS_6 | Representa patrón gris de 6.25% |
| GRIS_12 | Representa patrón gris de 12.5% |
| GRIS_25 | Representa patrón gris de 25% |
| GRIS_50 | Representa patrón gris de 50% |
| GRIS_75 | Representa patrón gris de 75% |
| RAYAS_HORIZONTALES | Representa patrón de rayas horizontales |
| NONE | Representa sin fondo |
| RAYAS_DIAGONAL_INVERSA | Representa patrón de rayas diagonales inversas |
| SOLID | Representa un patrón sólido |
| CROSSHATCH_DIAGONAL_GRUESO | Representa patrón de rayas diagonales gruesas |
| CROSSHATCH_DIAGONAL_FINO | Representa patrón de rayas diagonales finas |
| RAYAS_DIAGONAL_FINAS | Representa patrón de rayas diagonales finas |
| CROSSHATCH_HORIZONTAL_FINAS | Representa patrón de cruce horizontal fino |
| RAYAS_HORIZONTALES_FINAS | Representa patrón de rayas horizontales finas |
| RAYAS_INVERTIDAS_DIAGONALES | Representa patrón de rayas diagonales invertidas finas |
| RAYAS_VERTICALES_FINAS | Representa patrón de rayas verticales finas |
| RAYAS_VERTICALES | Representa 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 el método characters que acepta 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