Cómo establecer el borde y la alineación de celdas en C# con IronXL

En total, hay seis posiciones de línea de borde, cada una ofreciendo una variedad de patrones o tipos. Estas posiciones incluyen superior, derecha, inferior, izquierda, así como líneas diagonales avanzando, retrocediendo y ambos. Este completo conjunto de opciones le permite crear diseños visuales complejos similares a los que podría conseguir cuando trabaja con celdas combinadas, pero con más flexibilidad.

Cuando trabaje con bordes diagonales, comprenda cómo interactúan con el contenido de la celda y los ajustes de alineación. Los bordes diagonales pueden resultar especialmente útiles para crear secciones de encabezado o separadores visuales en tus informes Excel.

:path=/static-assets/excel/content-code-examples/how-to/border-alignment-set-border-line.cs

using IronXL;
using IronXL.Styles;

WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;

workSheet["B2"].StringValue = "Top";
workSheet["B4"].StringValue = "Forward";

// Set top border line
workSheet["B2"].Style.TopBorder.Type = BorderType.Thick;

// Set diagonal border line
workSheet["B4"].Style.DiagonalBorder.Type = BorderType.Thick;
// Set diagonal border direction
workSheet["B4"].Style.DiagonalBorderDirection = DiagonalBorderDirection.Forward;

workBook.SaveAs("borderLines.xlsx");

Imports IronXL
Imports IronXL.Styles

Private workBook As WorkBook = WorkBook.Create()
Private workSheet As WorkSheet = workBook.DefaultWorkSheet

Private workSheet("B2").StringValue = "Top"
Private workSheet("B4").StringValue = "Forward"

' Set top border line
Private workSheet("B2").Style.TopBorder.Type = BorderType.Thick

' Set diagonal border line
Private workSheet("B4").Style.DiagonalBorder.Type = BorderType.Thick
' Set diagonal border direction
Private workSheet("B4").Style.DiagonalBorderDirection = DiagonalBorderDirection.Forward

workBook.SaveAs("borderLines.xlsx")

Para escenarios de bordes más complejos, considere la posibilidad de crear una función reutilizable que aplique un estilo de borde coherente en varias celdas o rangos:

void ApplyUniformBorder(WorkSheet sheet, string range, BorderType borderType, Color borderColor)
{
    var cells = sheet[range];

    // Apply borders to all sides
    cells.Style.TopBorder.Type = borderType;
    cells.Style.RightBorder.Type = borderType;
    cells.Style.BottomBorder.Type = borderType;
    cells.Style.LeftBorder.Type = borderType;

    // Apply color to all borders
    cells.Style.TopBorder.SetColor(borderColor);
    cells.Style.RightBorder.SetColor(borderColor);
    cells.Style.BottomBorder.SetColor(borderColor);
    cells.Style.LeftBorder.SetColor(borderColor);
}

// Usage example
ApplyUniformBorder(workSheet, "A1:D4", BorderType.Thin, Color.Black);

void ApplyUniformBorder(WorkSheet sheet, string range, BorderType borderType, Color borderColor)
{
    var cells = sheet[range];

    // Apply borders to all sides
    cells.Style.TopBorder.Type = borderType;
    cells.Style.RightBorder.Type = borderType;
    cells.Style.BottomBorder.Type = borderType;
    cells.Style.LeftBorder.Type = borderType;

    // Apply color to all borders
    cells.Style.TopBorder.SetColor(borderColor);
    cells.Style.RightBorder.SetColor(borderColor);
    cells.Style.BottomBorder.SetColor(borderColor);
    cells.Style.LeftBorder.SetColor(borderColor);
}

// Usage example
ApplyUniformBorder(workSheet, "A1:D4", BorderType.Thin, Color.Black);

IRON VB CONVERTER ERROR developers@ironsoftware.com

Líneas fronterizas

Patrones de borde

La alineación de texto en IronXL proporciona un control exhaustivo sobre cómo se coloca el contenido dentro de las celdas. Esta característica es especialmente importante a la hora de exportar datos a diferentes formatos, donde mantener la coherencia visual es crucial. El sistema de alineación funciona junto con otras funciones de formato como estilos de fuente para crear hojas de cálculo de aspecto profesional.

Descubre la gama completa de opciones de alineación que ofrece IronXL en la ilustración a continuación:

Enumeración de alineación horizontal

• General: Alineación horizontal general. Los datos de texto se alinean a la izquierda. Los números, las fechas y las horas están alineados a la derecha. Se centran en los tipos booleanos. Cambiar la alineación no afecta el tipo de datos. Esta es la alineación por defecto cuando no se establece una alineación específica.
• Left: Alineación horizontal a la izquierda, incluso en modo de derecha a izquierda. Alinea los contenidos al borde izquierdo de la celda. Si se especifica una cantidad de sangría, el contenido de la celda se sangra desde la izquierda por el número especificado de espacios de caracteres.
• Centro: Alineación horizontal centrada. El texto está centrado en la celda. Se suele utilizar para cabeceras y títulos.
• Derecha: Alineación horizontal a la derecha. El contenido de las celdas se alinea en el borde derecho de la celda, incluso en el modo de derecha a izquierda. Se suele utilizar para la presentación de datos numéricos.
• Relleno: El valor de la celda se rellena en todo el ancho. Si las celdas adyacentes a la derecha también tienen la misma alineación de relleno, también se llenarán. Reglas adicionales:
  • Solo se pueden agregar valores completos, no valores parciales.
  • La columna no se ampliará para 'ajustarse mejor' al valor llenado.
  • Si agregar una ocurrencia adicional del valor excede el límite del borde izquierdo/derecho de la celda, no se agregará.
  • El valor de visualización de la celda se llena, no el número bruto subyacente.
• Justify: Alineación horizontal justificada (ajustada a la izquierda y derecha). Aplica el ajuste de texto a la celda y asegura que cada línea alinee la primera palabra con el borde izquierdo y la última palabra con el borde derecho de la celda (excepto la última línea). Esto es especialmente útil para celdas con mucho texto que contengan párrafos.
• CenterSelection: Centra horizontalmente el contenido de la celda más a la izquierda hacia el centro a través de múltiples celdas. Visualmente, parece similar a combinar celdas, pero sin realmente combinarlas. Usar esta opción ayuda a evitar problemas potenciales que pueden surgir de celdas combinadas.
• Distributed: Cada 'palabra' en cada línea de texto dentro de la celda se distribuye uniformemente a lo largo del ancho de la celda, con márgenes al ras a la derecha e izquierda. Si hay un valor de sangría para aplicar, tanto los lados izquierdo como derecho de la celda están acolchados por el valor de sangría.

Enumeración de alineación vertical

• None: La alineación por defecto, que suele dar como resultado un comportamiento de alineación inferior.
• Top: Alinea el contenido en la parte superior de la celda. Útil para celdas con diferentes alturas de contenido.
• Center: Centra verticalmente el contenido dentro de la celda. Esto crea una apariencia equilibrada, especialmente cuando se combina con el centrado horizontal.
• Bottom: Alinea el contenido en la parte inferior de la celda. Este es el comportamiento estándar para la mayoría de las aplicaciones de hojas de cálculo.
• Justify: Distribuye las líneas de texto uniformemente a lo largo de la altura de la celda, con márgenes al ras arriba y abajo. Funciona de manera similar a la justificación horizontal, envolviendo el texto y ajustando los espacios entre líneas para ocupar toda la altura de la fila.
• Distributed: Distribuye cada 'palabra' en cada línea de texto uniformemente a lo largo de la altura de la celda, con márgenes al ras arriba y abajo en la dirección del texto horizontal. En la dirección vertical del texto, se comporta exactamente igual que la alineación horizontal distribuida, distribuyendo uniformemente las líneas de texto de arriba a abajo.

Cuando trabaje con ajustes de alineación, tenga en cuenta cómo interactúan con otras propiedades de la celda. Por ejemplo, cuando automatiza filas y columnas, la configuración de la alineación afectará al modo en que el contenido se ajusta a las celdas de tamaño automático. Del mismo modo, cuando trabaje con fórmulas, una alineación adecuada puede hacer que sus cálculos de hoja de cálculo sean más legibles y profesionales.