Configuración de borde

Adición de bordes a Cells

Microsoft Excel permite a los usuarios formatear celdas agregando bordes. El tipo de borde depende de dónde se agregue. Por ejemplo, un borde superior es uno que se agrega a la posición superior de una celda. Los usuarios también pueden modificar el estilo y el color de las líneas de los bordes.

Con Aspose.Cells, los desarrolladores pueden agregar bordes y personalizar su apariencia de la misma forma flexible que en Microsoft Excel.

Adición de bordes a Cells

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 laCells recopilación. Cada artículo en elCells colección representa un objeto de laCellclase.

Aspose.Cells proporciona elObtenerEstilométodo en elCellclase. ÉlEstablecerEstiloEl método se utiliza para establecer el estilo de formato de una celda. ÉlEstiloLa clase proporciona propiedades para agregar bordes a las celdas.

Adición de bordes a un Cell

Los desarrolladores pueden agregar bordes a una celda usando elEstilo objetosFronteras recopilación. El tipo de borde se pasa como un índice alFronteras recopilación. Todos los tipos de borde están predefinidos en elTipo de borde enumeración.

enumeración de fronteras

Tipos de borde	Descripción
Borde inferior	Una línea de borde inferior
DiagonalAbajo	Una línea diagonal desde la parte superior izquierda hasta la parte inferior derecha
DiagonalArriba	Una línea diagonal desde abajo a la izquierda hasta arriba a la derecha
Borde izquierdo	Una línea de borde izquierda
borde derecho	Una línea de borde derecho
Borde superior	Una línea de borde superior

ÉlFronterastiendas de colección todas las fronteras. Cada borde en elFronteras colección está representada por unFrontera objeto que proporciona dos propiedades,Color yLineStylepara establecer el color y el estilo de línea de un borde, respectivamente.

Para establecer el color de línea de un borde, seleccione un color usando la enumeración Color (parte del Marco .NET) y asígnelo a la propiedad Color del objeto Borde.

El estilo de línea del borde se establece seleccionando un estilo de línea de laTipo de borde de celdaenumeración.

Enumeración CellBorderType

Estilos de línea	Descripción
Guion punto	Línea delgada de puntos y guiones
guiónpuntopunto	Línea delgada de puntos y guiones
punteado	Linea discontinua
Punteado	Linea punteada
Doble	Doble linea
Pelo	Línea de pelo
Medio Guión Punto	Línea de puntos y guiones medianos
Medio Guión Punto Punto	Línea mediana de puntos y guiones
medio punteado	Línea discontinua mediana
Ninguno	No hay línea
Medio	línea media
InclinadoGuiónPunto	Línea de puntos y guiones medianos inclinados
Grueso	línea gruesa
Delgado	Linea fina
Seleccione uno de los estilos de línea y luego asígnelo alFrontera objetosLineStyle propiedad.

	// 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();

	// Obtaining the reference of the first (default) worksheet by passing its sheet index
	Worksheet worksheet = workbook.Worksheets[0];

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

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

	// Create a style object
	Style style = cell.GetStyle();

	// Setting the line style of the top border
	style.Borders[BorderType.TopBorder].LineStyle = CellBorderType.Thick;

	// Setting the color of the top border
	style.Borders[BorderType.TopBorder].Color = Color.Black;

	// Setting the line style of the bottom border
	style.Borders[BorderType.BottomBorder].LineStyle = CellBorderType.Thick;

	// Setting the color of the bottom border
	style.Borders[BorderType.BottomBorder].Color = Color.Black;

	// Setting the line style of the left border
	style.Borders[BorderType.LeftBorder].LineStyle = CellBorderType.Thick;

	// Setting the color of the left border
	style.Borders[BorderType.LeftBorder].Color = Color.Black;

	// Setting the line style of the right border
	style.Borders[BorderType.RightBorder].LineStyle = CellBorderType.Thick;

	// Setting the color of the right border
	style.Borders[BorderType.RightBorder].Color = Color.Black;

	// Apply the border styles to the cell
	cell.SetStyle(style);

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

view raw Examples-CSharp-Formatting-Borders-AddingBordersToCells-1.cs hosted with ❤ by GitHub

Debe configurar el estilo de línea y el color al mismo tiempo. Las dos líneas de borde diagonales deben tener el mismo estilo y color de línea.

Adición de bordes a un rango de Cells

También es posible agregar bordes a un rango de celdas en lugar de solo a una sola celda. Para hacerlo, primero, cree un rango de celdas llamando alCells colecciónCrearRango método. Toma los siguientes parámetros:

Primera fila, la primera fila del rango.
Primera columna, representa 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.

ÉlCrearRango método devuelve unRango objeto, que contiene el rango especificado de celdas. ÉlRango objeto proporciona unEstablecerEsquemaBorde método que toma los siguientes parámetros para agregar un borde al rango de celdas:

Tipo de borde , el tipo de borde, seleccionado de laTipo de bordeenumeración.
Estilo de línea , el estilo de línea de borde, seleccionado de laTipo de borde de celdaenumeración.
Color, el color de la línea, seleccionado de la enumeración Color.

	// 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();

	// Obtaining the reference of the first (default) worksheet by passing its sheet index
	Worksheet worksheet = workbook.Worksheets[0];

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

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

	// Creating a range of cells starting from "A1" cell to 3rd column in a row
	Range range = worksheet.Cells.CreateRange(0, 0, 1, 3);

	// Adding a thick top border with blue line
	range.SetOutlineBorder(BorderType.TopBorder, CellBorderType.Thick, Color.Blue);

	// Adding a thick bottom border with blue line
	range.SetOutlineBorder(BorderType.BottomBorder, CellBorderType.Thick, Color.Blue);

	// Adding a thick left border with blue line
	range.SetOutlineBorder(BorderType.LeftBorder, CellBorderType.Thick, Color.Blue);

	// Adding a thick right border with blue line
	range.SetOutlineBorder(BorderType.RightBorder, CellBorderType.Thick, Color.Blue);

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

view raw Examples-CSharp-Formatting-Borders-AddingBorderstoRange-1.cs hosted with ❤ by GitHub

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");

view raw Examples-CSharp-Formatting-ColorsAndPalette-1.cs hosted with ❤ by GitHub

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).

Configuración de fuentes Ajustes de relleno