Como definir borda e alinhamento de célula em C# com IronXL

No total, há seis posições de linha de borda, cada uma oferecendo uma variedade de padrões ou tipos. Estas posições incluem topo, direita, fundo, esquerda, assim como linhas diagonais avançando, retrocedendo e ambas. Este conjunto abrangente de opções permite criar layouts visuais complexos semelhantes aos que você pode alcançar ao trabalhar com células mescladas, mas com mais flexibilidade.

Ao trabalhar com bordas diagonais, compreenda como elas interagem com o conteúdo e as configurações de alinhamento da célula. As bordas diagonais podem ser particularmente úteis para criar seções de cabeçalho ou separadores visuais em seus relatórios 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");

Para cenários de borda mais complexos, considere criar uma função reutilizável que aplique um estilo de borda consistente em várias células ou intervalos:

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

Linhas de Borda

Padrões de Bordas

O alinhamento de texto no IronXL proporciona controle abrangente sobre como o conteúdo é posicionado dentro das células. Este recurso é particularmente importante ao exportar dados para formatos diferentes, onde manter a consistência visual é crucial. O sistema de alinhamento funciona em conjunto com outros recursos de formatação como estilização de fonte para criar planilhas com aparência profissional.

Descubra a gama completa de opções de alinhamento oferecidas pelo IronXL na ilustração abaixo:

Enumeração HorizontalAlignment

• General: Alinhamento horizontal geral. Os dados de texto são alinhados à esquerda. Números, datas e horas são alinhados à direita. Tipos booleanos são centralizados. A alteração do alinhamento não afeta o tipo de dado. Este é o alinhamento padrão quando nenhum alinhamento específico é definido.
• Left: Alinhamento horizontal à esquerda, mesmo no modo da direita para a esquerda. Alinha o conteúdo na borda esquerda da célula. Se um valor de indentação for especificado, o conteúdo da célula é indentado a partir da esquerda pelo número especificado de espaços de caracteres.
• Center: Alinhamento horizontal centralizado. O texto é centralizado em toda a célula. Isso é comumente usado para cabeçalhos e títulos.
• Right: Alinhamento horizontal à direita. O conteúdo da célula é alinhado na borda direita da célula, mesmo em modo da direita para a esquerda. Isso é tipicamente usado para apresentação de dados numéricos.
• Fill: O valor da célula preenche toda a largura. Se as células adjacentes à direita também tiverem o mesmo alinhamento de preenchimento, elas também serão preenchidas. Regras adicionais:
  • Apenas valores inteiros podem ser adicionados, não valores parciais.
  • A coluna não será alargada para "ajuste ideal" do valor preenchido.
  • Se a adição de uma ocorrência adicional do valor exceder a borda esquerda/direita da célula, não será adicionada.
  • O valor exibido da célula é preenchido, não o número bruto subjacente.
• Justify: Alinhamento horizontal justificado (justificado à esquerda e à direita). Aplica quebra de texto à célula e garante que cada linha alinhe a primeira palavra com a borda esquerda e a última palavra com a borda direita da célula (exceto para a última linha). Isso é particularmente útil para células carregadas de texto contendo parágrafos.
• CenterSelection: Centraliza horizontalmente o conteúdo da célula mais à esquerda ao centro através de múltiplas células. Aparência visual semelhante à fusão de células, mas sem realmente fundi-las. Usar esta opção ajuda a evitar problemas potenciais que podem surgir de células mescladas.
• Distributed: Cada 'palavra' em cada linha de texto dentro da célula é distribuída uniformemente pela largura da célula, com margens direita e esquerda justificadas. Se houver um valor de indentação a aplicar, ambos os lados direito e esquerdo da célula são preenchidos pelo valor de indentação.

Enumeração VerticalAlignment

• None: O alinhamento padrão, que geralmente resulta em comportamento de alinhamento inferior.
• Top: Alinha o conteúdo no topo da célula. Útil para células com alturas de conteúdo variáveis.
• Center: Centraliza verticalmente o conteúdo dentro da célula. Isso cria uma aparência equilibrada, especialmente quando combinado com centralização horizontal.
• Bottom: Alinha o conteúdo na parte inferior da célula. Este é o comportamento padrão para a maioria dos aplicativos de planilha.
• Justify: Distribui as linhas de texto uniformemente pela altura da célula, com margens superior e inferior justificadas. Funciona de forma semelhante à justificação horizontal, quebrando o texto e ajustando os espaços entre as linhas para ocupar toda a altura da linha.
• Distributed: Distribui cada 'palavra' em cada linha de texto uniformemente pela altura da célula, com margens superior e inferior justificadas na direção horizontal do texto. Na direção vertical do texto, comporta-se exatamente como o alinhamento horizontal distribuído, distribuindo uniformemente as linhas de texto de cima a baixo.

Ao trabalhar com configurações de alinhamento, considere como elas interagem com outras propriedades da célula. Por exemplo, quando você ajusta automaticamente o tamanho das linhas e colunas, as configurações de alinhamento afetarão como o conteúdo se encaixa dentro das células dimensionadas automaticamente. Da mesma forma, ao trabalhar com fórmulas, o alinhamento adequado pode tornar seus cálculos de planilha mais legíveis e profissionais.