Ajustes de relleno

Colores y patrones de fondo

Microsoft Excel puede establecer los colores de primer plano (contorno) y de fondo (relleno) de las celdas y los patrones de fondo.

Aspose.Cells también es compatible con estas funciones de forma flexible. En este tema, aprendemos a usar estas funciones usando Aspose.Cells.

Configuración de colores y patrones de fondo

Aspose.Cells proporciona una clase,Libro de trabajo que representa un archivo de Excel Microsoft. ÉlLibro de trabajo la clase contiene unHojas de trabajo colección que permite el acceso a cada hoja de trabajo en el archivo de Excel. Una hoja de trabajo está representada por elHoja de cálculo clase. ÉlHoja de cálculo la clase proporciona unCells recopilación. Cada artículo en elCells colección representa un objeto de laCellclase.

ÉlCell tiene elObtenerEstilo yEstablecerEstilo métodos que se utilizan para obtener y establecer el formato de una celda. ÉlEstiloLa clase proporciona propiedades para establecer los colores de primer plano y de fondo de las celdas. Aspose.Cells proporciona unTipo de fondoenumeración que contiene un conjunto de tipos predefinidos de patrones de fondo que se dan a continuación.

Patrones de fondo	Descripción
Sombreado diagonal	Representa un patrón de sombreado diagonal
Raya Diagonal	Representa el patrón de rayas diagonales
gris6	Representa un 6,25 % de patrón gris
gris12	Representa un patrón gris del 12,5 %
gris25	Representa un 25 % de patrón gris
gris50	Representa un patrón gris del 50 %
gris75	Representa un patrón gris del 75 %
Franja horizontal	Representa el patrón de rayas horizontales
Ninguno	No representa antecedentes
Raya diagonal inversa	Representa el patrón de rayas diagonales inversas
Sólido	Representa un patrón sólido
GruesoDiagonalCrosshatch	Representa un patrón de sombreado diagonal grueso
ThinDiagonal Crossshatch	Representa un patrón de sombreado diagonal delgado
Raya Diagonal Delgada	Representa un patrón de rayas diagonales delgadas
FinoHorizontalSombreado	Representa un patrón de sombreado horizontal delgado
DelgadaHorizontalStripe	Representa un patrón de rayas horizontales delgadas
DelgadaReverseDiagonalStripe	Representa un patrón de rayas diagonales inversas delgadas
DelgadaVerticalStripe	Representa un patrón de rayas verticales delgadas
Franja vertical	Representa el patrón de rayas verticales

En el ejemplo a continuación, el color de primer plano de la celda A1 está configurado pero A2 está configurado para tener colores de primer plano y de fondo con un patrón de fondo de rayas verticales.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Create directory if it is not already present.
bool IsExists = System.IO.Directory.Exists(dataDir);
if (!IsExists)
    System.IO.Directory.CreateDirectory(dataDir);

// Instantiating a Workbook object
Workbook workbook = new Workbook();

// Adding a new worksheet to the Workbook object
int i = workbook.Worksheets.Add();

// Obtaining the reference of the newly added worksheet by passing its sheet index
Worksheet worksheet = workbook.Worksheets[i];

// Define a Style and get the A1 cell style
Style style = worksheet.Cells["A1"].GetStyle();

// Setting the foreground color to yellow
style.ForegroundColor = Color.Yellow;

// Setting the background pattern to vertical stripe
style.Pattern = BackgroundType.VerticalStripe;

// Apply the style to A1 cell
worksheet.Cells["A1"].SetStyle(style);

// Get the A2 cell style
style = worksheet.Cells["A2"].GetStyle();

// Setting the foreground color to blue
style.ForegroundColor = Color.Blue;

// Setting the background color to yellow
style.BackgroundColor = Color.Yellow;

// Setting the background pattern to vertical stripe
style.Pattern = BackgroundType.VerticalStripe;

// Apply the style to A2 cell
worksheet.Cells["A2"].SetStyle(style);

// Saving the Excel file
workbook.Save(dataDir + "book1.out.xls", SaveFormat.Excel97To2003);

Importante saber

• Para establecer el color frontal o de fondo de una celda, use elEstilo objetosColor de primer plano oColor de fondo propiedades. Ambas propiedades tendrán efecto sólo si elEstilo objetosPatrónla propiedad está configurada.
• ÉlColor de primer planoLa propiedad establece el color de sombra de la celda. ÉlPatrónLa propiedad especifica el tipo de patrón de fondo utilizado para el color de primer plano o de fondo. Aspose.Cells proporciona una enumeración,Tipo de fondoque contiene un conjunto de tipos predefinidos de patrones de fondo.
• Si seleccionaBackgroundType.Ninguno valor de laTipo de fondoenumeración, el color de primer plano no se aplica. Asimismo, el color de fondo no se aplica si selecciona elBackgroundType.Ninguno oBackgroundType.Solid valores.
• Al recuperar el sombreado/color de relleno de la celda, siEstilo.Patrón esBackgroundType.Ninguno, Estilo.Color de primer plano regresaráColor.Vacío.

Aplicación de efectos de relleno degradado

Para aplicar los efectos de relleno de degradado deseados a la celda, use elEstilo objetosEstablecerDosColorGradientemétodo en consecuencia.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Instantiate a new Workbook
Workbook workbook = new Workbook();
// Get the first worksheet (default) in the workbook
Worksheet worksheet = workbook.Worksheets[0];
// Input a value into B3 cell
worksheet.Cells[2, 1].PutValue("test");

// Get the Style of the cell
Style style = worksheet.Cells["B3"].GetStyle();
// Set Gradient pattern on
style.IsGradient = true;
// Specify two color gradient fill effects
style.SetTwoColorGradient(Color.FromArgb(255, 255, 255), Color.FromArgb(79, 129, 189), GradientStyleType.Horizontal, 1);
// Set the color of the text in the cell
style.Font.Color = Color.Red;
// Specify horizontal and vertical alignment settings
style.HorizontalAlignment = TextAlignmentType.Center;
style.VerticalAlignment = TextAlignmentType.Center;

// Apply the style to the cell
worksheet.Cells["B3"].SetStyle(style);

// Set the third row height in pixels
worksheet.Cells.SetRowHeightPixel(2, 53);

// Merge the range of cells (B3:C3)
worksheet.Cells.Merge(2, 1, 1, 2);

// Save the Excel file
workbook.Save(dataDir + "output.xlsx");

colores y paleta

Una paleta es el número de colores disponibles para usar en la creación de una imagen. El uso de una paleta estandarizada en una presentación le permite al usuario crear una apariencia consistente. Cada archivo 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.

Con Aspose.Cells es posible no solo usar los colores existentes de la paleta sino también colores personalizados. Antes de usar un color personalizado, agréguelo primero a la paleta.

Este tema trata sobre cómo agregar colores personalizados a la paleta.

Adición de colores personalizados a la paleta

Aspose.Cells es compatible con la paleta de 56 colores de Microsoft de Excel. Para usar un color personalizado que no está definido en la paleta, agregue el color a la paleta.

Aspose.Cells proporciona una clase,Libro de trabajo , que representa un archivo de Excel Microsoft. ÉlLibro de trabajo la clase proporciona unCambiarPaleta método que toma los siguientes parámetros para agregar un color personalizado para modificar la paleta:

• Color personalizado, el color personalizado que se agregará.
• Índice, el índice del color en la paleta que reemplazará el color personalizado. Debe estar entre 0-55.

El siguiente ejemplo agrega un color personalizado (Orquídea) a la paleta antes de aplicarlo en una fuente.

// Instantiating an Workbook object
Workbook workbook = new Workbook();

//Checks if a color is in the palette for the spreadsheet.
Console.WriteLine(workbook.IsColorInPalette(Color.Orchid));

// Adding Orchid color to the palette at 55th index
workbook.ChangePalette(Color.Orchid, 55);

Console.WriteLine(workbook.IsColorInPalette(Color.Orchid));            

// Adding a new worksheet to the Excel object
int i = workbook.Worksheets.Add();

// Obtaining the reference of the newly added worksheet by passing its sheet index
Worksheet worksheet = workbook.Worksheets[i];

// Accessing the "A1" cell from the worksheet
Cell cell = worksheet.Cells["A1"];

// Adding some value to the "A1" cell
cell.PutValue("Hello Aspose!");

// Defining new Style object
Style styleObject = workbook.CreateStyle();
// Setting the Orchid (custom) color to the font
styleObject.Font.Color = workbook.Colors[55];

// Applying the style to the cell
cell.SetStyle(styleObject);

// Saving the Excel file
workbook.Save("out.xlsx");

La paleta solo contiene 56 colores. Cuando agrega un color personalizado a la paleta, la paleta cambia y cualquier elemento en el archivo formateado con el color anterior cambia. Entonces, cuando cambie la paleta, tenga mucho cuidado. Además, esta es la limitación en el formato de archivo XLS (Excel 97 - 2003) solo porque no existe tal limitación para XLSX u otros formatos de archivo avanzados de MS Excel (2007/2010 o 2013).