罫線設定
セルにボーダーを追加する
Microsoft Excelでは、セルに枠線を追加してセルの書式設定を行えます。枠線の種類は追加場所によって異なります。例えば、上枠線はセルのトップ位置に追加されます。ユーザーは線のスタイルや色も変更可能です。
Aspose.Cells for Node.js via C++を用いて、開発者はExcelと同じ柔軟な方法で枠線を追加し、その見た目をカスタマイズできます。
セルにボーダーを追加する
Aspose.Cellsは、Microsoft Excelファイルを表すクラスWorkbookを提供します。WorkbookクラスにはExcelファイル内の各ワークシートにアクセスできるworksheetsコレクションが含まれます。ワークシートはWorksheetクラスで表されます。Worksheetクラスはcellsコレクションを提供します。cellsコレクション内の各アイテムはCellクラスのオブジェクトです。
Aspose.Cellsは、getStyleメソッドをCellクラスに提供します。このsetStyleメソッドはセルの書式設定を行うために使用されます。Styleクラスはセルに枠線を追加するためのプロパティを提供します。
セルに罫線を追加
開発者は、Styleオブジェクトのbordersコレクションを使ってセルに枠線を追加できます。枠線のタイプはインデックスとしてbordersコレクションに渡します。すべての枠線タイプは事前に定義されたBorderType列挙型に含まれています。
境界の列挙
| 境界タイプ | 説明 |
|---|---|
| BottomBorder | 下部の境界線 |
| DiagonalDown | 左上から右下への対角線 |
| DiagonalUp | 左下から右上への対角線 |
| LeftBorder | 左側の境界線 |
| RightBorder | 右側の境界線 |
| TopBorder | 上部の境界線 |
bordersコレクションはすべての枠線を格納します。bordersコレクション内の各枠線はBorderオブジェクトで表され、二つのプロパティsetColorとsetLineStyleを持ち、枠線の線の色とスタイルをそれぞれ設定できます。
枠線の線の色を設定するには、Color列挙型（Node.jsの一部）を使って色を選び、Borderオブジェクトのcolorプロパティに割り当てます。
枠線のラインスタイルは、CellBorderType列挙型からスタイルを選択して設定します。
CellBorderType列挙体
| 線のスタイル | 説明 |
|---|---|
| DashDot | 細い点線のような線 |
| DashDotDot | 細い破線点線のような線 |
| Dashed | 破線のような線 |
| Dotted | 点線のような線 |
| Double | 二重線 |
| Hair | 細い線 |
| MediumDashDot | 中くらいの点線のような線 |
| MediumDashDotDot | 中くらいの破線点線のような線 |
| MediumDashed | 中くらいの破線のような線 |
| None | 線なし |
| Medium | 中くらいの線 |
| SlantedDashDot | 対角の中くらいの点線のような線 |
| Thick | 太い線 |
| Thin | 細い線 |
| 線スタイルを一つ選び、それをBorderオブジェクトのlineStyleプロパティに割り当てます。 |
セルの範囲に境界線を追加する
1つのセルだけでなく、範囲に対して枠線を追加することも可能です。そのためには、最初にcellsコレクションのcreateRangeメソッドを呼び出し、セル範囲を作成します。引数は以下の通りです：
- 最初の行、範囲の最初の行。
- 最初の列、範囲の最初の列を表す。
- 行数、範囲内の行数。
- 列数、範囲内の列数。
createRangeメソッドは、指定されたセル範囲を含むRangeオブジェクトを返します。Rangeオブジェクトは、範囲に枠線を追加するための引数を取るsetOutlineBorderメソッドを提供します：
- 枠線タイプ：BorderType列挙型から選ばれる枠線タイプ。
- ラインスタイル：枠線のラインスタイル。CellBorderType列挙型から選択。
- 色、Color 列挙型から選択した線の色。