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

todo:image_alt_text

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

todo:image_alt_text

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

todo:image_alt_text

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

todo:image_alt_text

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

todo:image_alt_text

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

todo:image_alt_text

Importante saber

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

todo:image_alt_text

Temas avanzados