Jak ustawić obramowanie komórek i wyrównanie w C# za pomocą IronXL

W sumie jest sześć pozycji linii obramowań, z których każda oferuje różnorodne wzory lub typy. Pozycje te obejmują górę, prawą stronę, dół, lewą stronę, a także linie przekątne poruszające się do przodu, do tyłu i obie. Ten wszechstronny zestaw opcji pozwala na tworzenie złożonych układów wizualnych podobnych do tych, które można uzyskać podczas pracy z scalonymi komórkami, ale z większą elastycznością.

Pracując z przekątnymi obramowaniami, zrozum, jak oddziałują one z zawartością komórki i ustawieniami wyrównania. Przekątne obramowania mogą być szczególnie przydatne do tworzenia sekcji nagłówka lub wizualnych separatorów w swoich raportach 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")

W przypadku bardziej złożonych scenariuszy obramowań rozważ utworzenie funkcji do ponownego wykorzystania, która stosuje spójny styl obramowań w wielu komórkach lub zakresach:

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

Option Strict On



Sub ApplyUniformBorder(sheet As WorkSheet, range As String, borderType As BorderType, borderColor As Color)
    Dim 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)
End Sub

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

Linie obramowań

Wzory obramowań

Wyrównanie tekstu w IronXL zapewnia kompleksową kontrolę nad tym, jak zawartość jest pozycjonowana w komórkach. Ta funkcja jest szczególnie ważna przy eksportowaniu danych do różnych formatów, gdzie zachowanie spójności wizualnej jest kluczowe. System wyrównania działa w połączeniu z innymi funkcjami formatowania, takimi jak stylizacja czcionki, aby tworzyć arkusze kalkulacyjne o profesjonalnym wyglądzie.

Color Color

Enum HorizontalAlignment

• General: Wyrównanie poziome z ogólnym wyrównaniem. Dane tekstowe są wyrównane do lewej. Liczby, daty i godziny są wyrównane do prawej strony. Typy boolowskie są wyśrodkowane. Zmiana wyrównania nie ma wpływu na typ danych. Jest to domyślne wyrównanie, gdy nie ustawiono konkretnego wyrównania.
• Left: Wyrównanie poziome do lewej, nawet w trybie od prawej do lewej. Wyrównuje zawartość do lewej krawędzi komórki. Jeśli określono wartość wcięcia, zawartość komórki jest wcięta od lewej strony o określoną liczbę znaków spacji.
• Center: Wyrównanie pośrodku w poziomie. Tekst jest wyśrodkowany w komórce. Jest to powszechnie stosowane w nagłówkach i tytułach.
• Right: Wyrównanie poziome do prawej. Zawartość komórek jest wyrównana do prawej krawędzi komórki, nawet w trybie pisania od prawej do lewej. Jest to zazwyczaj używane do prezentacji danych liczbowych.
• Fill: Wartość komórki wypełnia całą szerokość. Jeśli sąsiednie komórki po prawej stronie mają to samo wyrównanie wypełnienia, również zostaną wypełnione. Dodatkowe zasady:
  • Można dodawać tylko wartości całkowite, a nie częściowe.
  • Kolumna nie zostanie poszerzona, aby "jak najlepiej dopasować" wprowadzoną wartość.
  • Jeśli dodanie kolejnego wystąpienia wartości spowoduje przekroczenie lewej lub prawej krawędzi komórki, nie zostanie ono dodane.
  • W komórce wyświetlana jest wartość, a nie podstawowa liczba surowa.
• Justify: Wyrównanie poziome (do lewej i prawej krawędzi). Zastosuj zawijanie tekstu w komórce i upewnij się, że w każdym wierszu pierwsze słowo jest wyrównane do lewej krawędzi, a ostatnie słowo do prawej krawędzi komórki (z wyjątkiem ostatniego wiersza). Jest to szczególnie przydatne w przypadku komórek zawierających dużo tekstu, w tym akapity.
• CenterSelection: Wyśrodkowuje poziomo zawartość komórki znajdującej się najbardziej po lewej stronie względem środka wielu komórek. Wizualnie wygląda to podobnie do scałania komórek, ale bez faktycznego ich scałania. Korzystanie z tej opcji pomaga zapobiegać potencjalnym problemom, które mogą wynikać ze scałania komórek.
• Distributed: Każde "słowo" w każdym wierszu tekstu wewnątrz komórki jest równomiernie rozłożone na całej szerokości komórki, z wyrównaniem do prawej i lewej krawędzi. Jeśli należy zastosować wartość wcięcia, zarówno lewa, jak i prawa strona komórki są wypełniane wartością wcięcia.

Wypisanie VerticalAlignment

• None: Domyślne wyrównanie, które zazwyczaj powoduje wyrównanie do dołu.
• Top: Wyrównuje zawartość do górnej krawędzi komórki. Przydatne w przypadku komórek o różnej wysokości zawartości.
• Center: Wyśrodkowuje zawartość komórki w pionie. Tworzy to spójny wygląd, zwłaszcza w połączeniu z wycentrowaniem w poziomie.
• Bottom: Wyrównuje zawartość do dolnej krawędzi komórki. Jest to standardowe zachowanie większości aplikacji do obsługi arkuszy kalkulacyjnych.
• Justify: Rozkłada wiersze tekstu równomiernie na całej wysokości komórki, z wyrównanymi górnymi i dolnymi marginesami. Działa podobnie jak wyrównanie poziome poprzez zawijanie tekstu i dostosowywanie odstępów między wierszami tak, aby zajmowały całą wysokość wiersza.
• Distributed: Rozkłada każde "słowo" w każdym wierszu tekstu równomiernie na całej wysokości komórki, z wyrównanymi górnymi i dolnymi marginesami w poziomie. W przypadku pionowego kierunku tekstu zachowuje się dokładnie tak samo jak wyrównanie poziome, równomiernie rozkładając wiersze tekstu od góry do dołu.

Podczas pracy z ustawieniami wyrównania należy wziąć pod uwagę ich interakcję z innymi właściwościami komórek. Na przykład, gdy automatycznie dostosowujesz rozmiar wierszy i kolumn, ustawienia wyrównania będą miały wpływ na to, jak zawartość zmieści się w komórkach o automatycznie dostosowanym rozmiarze. Podobnie, podczas pracy z formułami, odpowiednie wyrównanie może sprawić, że obliczenia w arkuszu kalkulacyjnym będą bardziej czytelne i profesjonalne.