ボーダー設定
Cells に罫線を追加する
Microsoft Excel では、ユーザーは罫線を追加してセルの書式を設定できます。境界線の種類は、追加する場所によって異なります。たとえば、上罫線は、セルの上端に追加される罫線です。ユーザーは、境界線のスタイルと色を変更することもできます。
Aspose.Cells を使用すると、開発者は Microsoft Excel と同じように柔軟な方法で境界線を追加し、外観をカスタマイズできます。
Cells に罫線を追加する
Aspose.Cells はクラスを提供し、ワークブックMicrosoft Excel ファイルを表します。のワークブッククラスにはワークシートExcel ファイル内の各ワークシートにアクセスできるコレクション。ワークシートは、ワークシートクラス。のワークシートクラスが提供するCellsコレクション。の各項目Cellsコレクションはのオブジェクトを表しますCellクラス。
Aspose.Cells はGetStyleのメソッドCellクラス。のスタイルの設定メソッドは、セルの書式設定スタイルを設定するために使用されます。のスタイルクラスは、セルに境界線を追加するためのプロパティを提供します。
Cell にボーダーを追加する
開発者は、スタイルオブジェクトの国境コレクション。ボーダー タイプはインデックスとして渡されます。国境コレクション。すべての境界線の種類は、ボーダータイプ列挙。
ボーダー列挙
| 境界線の種類 | 説明 |
|---|---|
| BottomBorder | 下の境界線 |
| 斜め下 | 左上から右下への対角線 |
| 斜め上 | 左下から右上への対角線 |
| 左ボーダー | 左の境界線 |
| 右ボーダー | 右の境界線 |
| 上枠 | 上の境界線 |
の国境コレクションにはすべての境界線が格納されます。の各境界線国境コレクションは国境 つのプロパティを提供するオブジェクト、色と線種ボーダーの線の色とスタイルをそれぞれ設定します。
境界線の色を設定するには、Color 列挙体 (.NET フレームワークの一部) を使用して色を選択し、それを Border オブジェクトの Color プロパティに割り当てます。
ボーダーの線のスタイルは、CellBorderType列挙。
CellBorderType 列挙体
| 線種 | 説明 |
|---|---|
| ダッシュドット | 細い一点鎖線 |
| ダッシュドットドット | 細い一点鎖線 |
| 破線 | 破線 |
| 点在 | 点線 |
| ダブル | 二重線 |
| 髪 | 生え際 |
| 中破線 | 中一点鎖線 |
| ミディアムダッシュドットドット | 中一点鎖線 |
| 中破線 | 中破線 |
| なし | 行なし |
| 中くらい | ミディアムライン |
| 斜めダッシュドット | 斜め中一点鎖線 |
| 厚い | 太線 |
| 薄い | 細い線 |
| ライン スタイルの 1 つを選択し、それを国境オブジェクトの線種財産。 |
| // For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
| // The path to the documents directory. | |
| string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); | |
| // Create directory if it is not already present. | |
| bool IsExists = System.IO.Directory.Exists(dataDir); | |
| if (!IsExists) | |
| System.IO.Directory.CreateDirectory(dataDir); | |
| // Instantiating a Workbook object | |
| Workbook workbook = new Workbook(); | |
| // Obtaining the reference of the first (default) worksheet by passing its sheet index | |
| Worksheet worksheet = workbook.Worksheets[0]; | |
| // Accessing the "A1" cell from the worksheet | |
| Aspose.Cells.Cell cell = worksheet.Cells["A1"]; | |
| // Adding some value to the "A1" cell | |
| cell.PutValue("Visit Aspose!"); | |
| // Create a style object | |
| Style style = cell.GetStyle(); | |
| // Setting the line style of the top border | |
| style.Borders[BorderType.TopBorder].LineStyle = CellBorderType.Thick; | |
| // Setting the color of the top border | |
| style.Borders[BorderType.TopBorder].Color = Color.Black; | |
| // Setting the line style of the bottom border | |
| style.Borders[BorderType.BottomBorder].LineStyle = CellBorderType.Thick; | |
| // Setting the color of the bottom border | |
| style.Borders[BorderType.BottomBorder].Color = Color.Black; | |
| // Setting the line style of the left border | |
| style.Borders[BorderType.LeftBorder].LineStyle = CellBorderType.Thick; | |
| // Setting the color of the left border | |
| style.Borders[BorderType.LeftBorder].Color = Color.Black; | |
| // Setting the line style of the right border | |
| style.Borders[BorderType.RightBorder].LineStyle = CellBorderType.Thick; | |
| // Setting the color of the right border | |
| style.Borders[BorderType.RightBorder].Color = Color.Black; | |
| // Apply the border styles to the cell | |
| cell.SetStyle(style); | |
| // Saving the Excel file | |
| workbook.Save(dataDir + "book1.out.xls"); |
Cells の範囲に境界線を追加する
単一のセルだけでなく、セルの範囲に罫線を追加することもできます。これを行うには、まず、を呼び出してセルの範囲を作成します。Cellsコレクションの作成範囲方法。次のパラメータを取ります。
- 最初の行、範囲の最初の行。
- 最初の列は、範囲の最初の列を表します。
- 行数、範囲内の行数。
- 列数、範囲内の列数。
の作成範囲メソッドは範囲指定されたセル範囲を含むオブジェクト。の範囲オブジェクトはSetOutlineBorder次のパラメーターを使用して、セル範囲に境界線を追加するメソッド:
- ボーダータイプから選択された境界線タイプボーダータイプ列挙。
- 線種から選択された境界線のスタイルCellBorderType列挙。
- 色Color 列挙体から選択された線の色。
| // For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
| // The path to the documents directory. | |
| string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); | |
| // Create directory if it is not already present. | |
| bool IsExists = System.IO.Directory.Exists(dataDir); | |
| if (!IsExists) | |
| System.IO.Directory.CreateDirectory(dataDir); | |
| // Instantiating a Workbook object | |
| Workbook workbook = new Workbook(); | |
| // Obtaining the reference of the first (default) worksheet by passing its sheet index | |
| Worksheet worksheet = workbook.Worksheets[0]; | |
| // Accessing the "A1" cell from the worksheet | |
| Cell cell = worksheet.Cells["A1"]; | |
| // Adding some value to the "A1" cell | |
| cell.PutValue("Hello World From Aspose"); | |
| // Creating a range of cells starting from "A1" cell to 3rd column in a row | |
| Range range = worksheet.Cells.CreateRange(0, 0, 1, 3); | |
| // Adding a thick top border with blue line | |
| range.SetOutlineBorder(BorderType.TopBorder, CellBorderType.Thick, Color.Blue); | |
| // Adding a thick bottom border with blue line | |
| range.SetOutlineBorder(BorderType.BottomBorder, CellBorderType.Thick, Color.Blue); | |
| // Adding a thick left border with blue line | |
| range.SetOutlineBorder(BorderType.LeftBorder, CellBorderType.Thick, Color.Blue); | |
| // Adding a thick right border with blue line | |
| range.SetOutlineBorder(BorderType.RightBorder, CellBorderType.Thick, Color.Blue); | |
| // Saving the Excel file | |
| workbook.Save(dataDir + "book1.out.xls"); |
色とパレット
パレットは、画像の作成に使用できる色の数です。プレゼンテーションで標準化されたパレットを使用すると、ユーザーは一貫した外観を作成できます。各 Microsoft Excel (97-2003) ファイルには、グラフのセル、フォント、グリッド線、グラフィック オブジェクト、塗りつぶし、線に適用できる 56 色のパレットがあります。
Aspose.Cells では、パレットの既存の色だけでなく、カスタム カラーも使用できます。カスタム カラーを使用する前に、まずパレットに追加します。
このトピックでは、カスタム カラーをパレットに追加する方法について説明します。
パレットへのカスタム カラーの追加
Aspose.Cells は Microsoft Excel の 56 色パレットをサポートします。パレットで定義されていないカスタム カラーを使用するには、そのカラーをパレットに追加します。
Aspose.Cells はクラスを提供し、ワークブック、Microsoft Excel ファイルを表します。のワークブッククラスはチェンジパレット次のパラメーターを使用してカスタム カラーを追加し、パレットを変更するメソッド:
- カスタム カラー、追加するカスタム カラー。
- インデックス、カスタム色が置き換えるパレット内の色のインデックス。 0 から 55 の間である必要があります。
次の例では、カスタム カラー (Orchid) をフォントに適用する前にパレットに追加しています。
| // Instantiating an Workbook object | |
| Workbook workbook = new Workbook(); | |
| //Checks if a color is in the palette for the spreadsheet. | |
| Console.WriteLine(workbook.IsColorInPalette(Color.Orchid)); | |
| // Adding Orchid color to the palette at 55th index | |
| workbook.ChangePalette(Color.Orchid, 55); | |
| Console.WriteLine(workbook.IsColorInPalette(Color.Orchid)); | |
| // Adding a new worksheet to the Excel object | |
| int i = workbook.Worksheets.Add(); | |
| // Obtaining the reference of the newly added worksheet by passing its sheet index | |
| Worksheet worksheet = workbook.Worksheets[i]; | |
| // Accessing the "A1" cell from the worksheet | |
| Cell cell = worksheet.Cells["A1"]; | |
| // Adding some value to the "A1" cell | |
| cell.PutValue("Hello Aspose!"); | |
| // Defining new Style object | |
| Style styleObject = workbook.CreateStyle(); | |
| // Setting the Orchid (custom) color to the font | |
| styleObject.Font.Color = workbook.Colors[55]; | |
| // Applying the style to the cell | |
| cell.SetStyle(styleObject); | |
| // Saving the Excel file | |
| workbook.Save("out.xlsx"); |