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のテキストアライメントでは、セル内のコンテンツの配置を包括的にコントロールすることができます。 この機能は、視覚的な一貫性を維持することが重要な異なるフォーマットにデータをエクスポートする場合に特に重要です。 整列システムは、フォントスタイルのような他の書式設定機能と連動して、プロフェッショナルな外観のスプレッドシートを作成します。

以下のイラストでIronXLが提供する配置オプションの全範囲を発見してください:

.

HorizontalAlignment 列挙

• General: 一般的な整列方式。 テキストデータは左寄せです。 数字、日付、時刻は右寄せです。 ブール型が中心です。 配置の変更はデータ型には影響しません。 これは、特定のアライメントが設定されていない場合のデフォルトのアライメントです。
• Left: 右から左モードでも左揃えの水平配置。 セルのコンテンツを左端に配置します。 インデント量が指定されている場合、セルのコンテンツは指定された文字スペース数だけ左からインデントされます。
• 中央：水平方向の中央揃え。 テキストはセルの中央に配置されます。 これは一般的にヘッダーやタイトルに使用されます。
• Right：右寄せの水平アライメント。 セルの内容は、Right-to-Leftモードでも、セルの右端に整列されます。 これは通常、数値データのプレゼンテーションに使用されます。
• Fill：セルの値が幅いっぱいに表示されます。 右側の隣接セルが同じ塗りつぶし配置を持つ場合、それらも埋められます。 追加のルール:
  • 部分値ではなく、全体値のみ追加できます。
  • 塗りつぶされた値に対して"最も適した"幅に列は広がりません。
  • 値の追加がセルの左/右端の境界を超える場合、追加されません。
  • セルの表示値が埋められますが、基本的な生値ではありません。
• Justify: 左右揃えの水平整列。 セルに折り返しテキストを適用し、各行の最初の単語を左端、最後の単語をセルの右端に整列（最終行を除く）。 これは、段落を含むテキストの多いセルに特に有効です。
• CenterSelection：複数のセルにわたって、左端のセルの内容を水平方向に中央に配置します。 セルを実際には結合せずに、ビジュアル的には結合されたように見えます。 このオプションを使用することで、結合されたセルから生じる可能性のある問題を防ぐことができます。
• Distributed: セル内の各行の各"単語"がセル幅全体に均等に分布し、右と左の余白が均等にされます。 インデント値が適用される場合、セルの左右はインデント値分パディングされます。

VerticalAlignment 列挙

• None: デフォルトのアライメントで、通常はボトムアライメントになります。
• Top: セルの上部にコンテンツを配置。 コンテンツの高さが異なるセルに便利です。
• Center: セル内で垂直にコンテンツを中央揃え。 これは、特に水平方向のセンタリングと組み合わせることで、バランスの取れた外観を作り出します。
• Bottom: セルの底部にコンテンツを配置。 これは、ほとんどの表計算アプリケーションの標準的な動作です。
• Justify: 上下の余白が均等なセルの高さ全体にラインテキストを均等に配置。 横方向の正当化に似ており、テキストを折り返し、行間のスペースを調整して行全体の高さを占める。
• Distributed: 各行の各"単語"がセルの高さ全体に均等に分布し、横方向の文字の上と下の余白が均等にされます。 テキストの縦書き方向では、分散横組みとまったく同じように動作し、テキストの行を上から下へ均等に配置します。

アライメント設定を扱うときは、他のセルプロパティとの相互作用を考慮してください。 たとえば、行と列のサイズを自動調整するとき、整列設定は、コンテンツが自動的にサイズ調整されたセル内にどのように収まるかに影響します。 同様に、数式を扱う場合、適切な位置合わせを行うことで、スプレッドシートの計算をより読みやすく、プロフェッショナルなものにすることができます。