塗りつぶし設定

色と背景パターン

Microsoft Excel では、セルの前景色 (アウトライン) と背景 (塗りつぶし) の色と背景パターンを設定できます。

Aspose.Cells もこれらの機能を柔軟にサポートします。このトピックでは、Aspose.Cells を使用してこれらの機能の使用方法を学習します。

色と背景パターンの設定

Aspose.Cells はクラスを提供し、ワークブックMicrosoft Excel ファイルを表します。のワークブッククラスにはワークシートExcel ファイル内の各ワークシートにアクセスできるコレクション。ワークシートは、ワークシートクラス。のワークシートクラスはCellsコレクション。の各項目Cellsコレクションはのオブジェクトを表しますCellクラス。

のCellを持っていますGetStyleとスタイルの設定セルの書式設定を取得および設定するために使用されるメソッド。のスタイルクラスは、セルの前景色と背景色を設定するためのプロパティを提供します。 Aspose.Cells は背景の種類以下に示す事前定義されたタイプの背景パターンのセットを含む列挙。

背景パターン 説明
斜めクロスハッチ 斜めのクロスハッチ パターンを表します
斜めストライプ 斜めの縞模様を表現
グレー6 6.25% グレー パターンを表します
グレー12 12.5% グレー パターンを表します
グレイ25 25% グレー パターンを表します
グレイ50 50% グレー パターンを表します
グレイ75 75% グレー パターンを表します
横縞 横縞模様を表現
なし 背景なしを表します
逆対角ストライプ 逆斜め縞模様を表す
個体 ソリッドパターンを表します
太い対角線のクロスハッチ 太い斜めのクロスハッチ パターンを表します
薄い対角線のクロスハッチ 細い斜めのクロスハッチ パターンを表します
細い斜めストライプ 細い斜めの縞模様を表現
薄い水平クロスハッチ 薄い水平のクロスハッチ パターンを表します
薄い横縞 細い横縞模様を表現
薄い逆対角線ストライプ 細い逆斜めストライプパターンを表現
細い縦縞 細い縦縞模様を表現
縦ストライプ 縦縞模様を表現

以下の例では、A1 セルの前景色が設定されていますが、A2 は縦縞の背景パターンで前景色と背景色の両方を持つように構成されています。

// 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();
// Adding a new worksheet to the Workbook object
int i = workbook.Worksheets.Add();
// Obtaining the reference of the newly added worksheet by passing its sheet index
Worksheet worksheet = workbook.Worksheets[i];
// Define a Style and get the A1 cell style
Style style = worksheet.Cells["A1"].GetStyle();
// Setting the foreground color to yellow
style.ForegroundColor = Color.Yellow;
// Setting the background pattern to vertical stripe
style.Pattern = BackgroundType.VerticalStripe;
// Apply the style to A1 cell
worksheet.Cells["A1"].SetStyle(style);
// Get the A2 cell style
style = worksheet.Cells["A2"].GetStyle();
// Setting the foreground color to blue
style.ForegroundColor = Color.Blue;
// Setting the background color to yellow
style.BackgroundColor = Color.Yellow;
// Setting the background pattern to vertical stripe
style.Pattern = BackgroundType.VerticalStripe;
// Apply the style to A2 cell
worksheet.Cells["A2"].SetStyle(style);
// Saving the Excel file
workbook.Save(dataDir + "book1.out.xls", SaveFormat.Excel97To2003);
view raw Examples-CSharp-Formatting-ColorsAndBackground-1.cs hosted with ❤ by GitHub

知っておくべき重要事項

グラデーション塗りつぶし効果の適用

目的のグラデーション塗りつぶし効果をセルに適用するには、スタイルオブジェクトのSetTwoColorGradientそれに応じた方法。

// 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);
// Instantiate a new Workbook
Workbook workbook = new Workbook();
// Get the first worksheet (default) in the workbook
Worksheet worksheet = workbook.Worksheets[0];
// Input a value into B3 cell
worksheet.Cells[2, 1].PutValue("test");
// Get the Style of the cell
Style style = worksheet.Cells["B3"].GetStyle();
// Set Gradient pattern on
style.IsGradient = true;
// Specify two color gradient fill effects
style.SetTwoColorGradient(Color.FromArgb(255, 255, 255), Color.FromArgb(79, 129, 189), GradientStyleType.Horizontal, 1);
// Set the color of the text in the cell
style.Font.Color = Color.Red;
// Specify horizontal and vertical alignment settings
style.HorizontalAlignment = TextAlignmentType.Center;
style.VerticalAlignment = TextAlignmentType.Center;
// Apply the style to the cell
worksheet.Cells["B3"].SetStyle(style);
// Set the third row height in pixels
worksheet.Cells.SetRowHeightPixel(2, 53);
// Merge the range of cells (B3:C3)
worksheet.Cells.Merge(2, 1, 1, 2);
// Save the Excel file
workbook.Save(dataDir + "output.xlsx");
view raw Examples-CSharp-Formatting-ApproachesToFormatData-ApplyingGradientFillEffects-1.cs hosted with ❤ by GitHub

色とパレット

パレットは、画像の作成に使用できる色の数です。プレゼンテーションで標準化されたパレットを使用すると、ユーザーは一貫した外観を作成できます。各 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");
view raw Examples-CSharp-Formatting-ColorsAndPalette-1.cs hosted with ❤ by GitHub
ボーダー設定 Excel および ODS ファイルの条件付き書式を設定します。