IronXL を使用した C# でのセルの境界線と配置の設定方法

合計で6つの境界線位置があり、それぞれが様々なパターンやタイプを提供します。これらの位置には、上、右、下、左に加え、前方、後方、および両方向へ伸びる斜めの線が含まれます。 この包括的なオプションセットを使用することで、セル結合を使用する場合と同様の複雑な視覚的レイアウトを作成できますが、より柔軟性が高くなります。

斜めの境界線を使用する際は、それらがセルの内容や配置設定とどのように相互作用するかを理解してください。 斜めの境界線は、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")

より複雑な境界線の処理が必要な場合は、複数のセルや範囲に一貫した境界線スタイルを適用する再利用可能な関数を作成することを検討してください：

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)

境界線

ボーダーパターン

IronXLのテキスト配置機能により、セル内でのコンテンツの配置方法を詳細に制御できます。 この機能は、視覚的な一貫性を維持することが極めて重要な、異なる形式へのデータエクスポートにおいて特に重要です。 この配置機能は、フォントスタイルなどの他の書式設定機能と連携して、Professionalな外観のスプレッドシートを作成します。

Color Color

HorizontalAlignment 列挙型

• General: 標準的な水平方向の配置。 テキストデータは左揃えです。 数値、日付、時刻は右揃えにします。 ブール型は中央揃えです。 配置を変更しても、データ型には影響しません。 これは、特定の配置が設定されていない場合のデフォルトの配置です。
• Left: 右から左（RTL）モードでも、左揃えの水平配置を維持します。 セルの左端にコンテンツを揃えます。 インデント量が指定されている場合、セルの内容は左側から指定された文字数分だけインデントされます。
• Center: 中央揃えの水平配置。 テキストはセル内で中央揃えになっています。 これは、ヘッダーやタイトルによく使用されます。
• Right: 右揃えの水平配置。 セルの内容は、右から左（RTL）モードであっても、セルの右端に揃えられます。 これは通常、数値データの表示に使用されます。
• Fill: セルの値が幅いっぱいに表示されます。 右隣のセルも同様の塗りつぶし設定になっている場合、それらのセルも塗りつぶされます。 追加のルール：
  • 追加できるのは値全体のみであり、部分的な値は追加できません。
  • 入力値に合わせて列幅が"最適化"されることはありません。
  • 値を追加した際に、セルの左右の端を超える場合は、追加されません。
  • セルに表示される値が入力されるものであり、その背後にある生の数値が入力されるわけではありません。
• Justify: 両端揃え（左右揃え）の水平配置。 セルにテキストの折り返しを適用し、各行の最初の単語がセルの左端に、最後の単語が右端に揃うようにします（最終行を除く）。 これは、段落を含むテキスト量の多いセルにおいて特に有用です。
• CenterSelection: 左端のセルの内容を、複数のセルにわたって水平方向に中央揃えにします。 見た目はセルの結合に似ていますが、実際には結合は行われません。 このオプションを使用することで、セルの結合に起因する潜在的な問題を未然に防ぐことができます。
• Distributed: セル内の各行のテキストは、左右の余白を揃え、セル幅全体に均等に配置されています。 インデント値を適用する場合、セルの左右両側にそのインデント値分の余白が追加されます。

VerticalAlignment 列挙型

• None: デフォルトの配置。通常、下揃えの挙動となります。
• Top: セルの上部にコンテンツを揃えます。 コンテンツの高さが異なるセルに便利です。
• Center: セル内のコンテンツを垂直方向に中央揃えにします。 これにより、特に水平中央揃えと組み合わせた際に、バランスの取れた外観が実現されます。
• Bottom: セルの下部にコンテンツを揃えます。 これは、ほとんどの表計算アプリケーションにおける標準的な動作です。
• Justify: テキスト行をセルの高さに均等に配置し、上下の余白を揃えます。 テキストを折り返し、行間のスペースを調整して行全体の高さを埋めることで、水平方向の揃えと同様に機能します。
• Distributed: テキストの各行にある"WORD"をセルの高さに均等に配置し、水平方向のテキストでは上下の余白を揃えます。 縦書きの場合、テキストは横書きの均等配置と全く同じように動作し、行が上から下へ均等に配置されます。

アラインメント設定を扱う際は、他のセルプロパティとの相互作用を考慮してください。 たとえば、行と列のサイズを自動調整する場合、配置設定によって、自動的にサイズ調整されたセル内にコンテンツがどのように収まるかが決まります。 同様に、数式を扱う際も、適切な配置を行うことで、スプレッドシート上の計算結果の可読性とProfessionalな印象を高めることができます。