塗りつぶし設定
色と背景パターン
Microsoft Excel では、セルの前景(輪郭)と背景(塗りつぶし)の色、および背景パターンを設定できます。
Aspose.Cells for Python via .NETは、これらの機能も柔軟にサポートしています。このトピックでは、Aspose.Cellsを使用してこれらの機能を使う方法を学びます。
色と背景パターンの設定
Aspose.Cells for Python via .NETは、Microsoft Excelファイルを表すクラスWorkbookを提供します。Workbookクラスには、Excelファイル内の各ワークシートにアクセスできるworksheetsコレクションが含まれています。ワークシートはWorksheetクラスで表されます。WorksheetクラスはCellsコレクションを提供します。Cellsコレクションの各アイテムはCellクラスのオブジェクトを表します。
Cellはセルの書式設定を取得・設定するためのget_styleとset_styleメソッドを持っています。Styleクラスはセルの前景色と背景色を設定するプロパティを提供します。Aspose.Cells for Python via .NETは、以下に示す背景パターンの事前定義されたタイプを含むBackgroundType列挙体を提供します。
背景パターン | 説明 |
---|---|
DIAGONAL_CROSSHATCH | 斜交格子パターンを表します |
DIAGONAL_STRIPE | 斜線ストライプパターンを表します |
GRAY6 | 6.25%のグレーパターンを表します |
GRAY12 | 12.5%のグレーパターンを表します |
GRAY25 | 25%のグレーパターンを表します |
GRAY50 | 50%のグレーパターンを表します |
GRAY75 | 75%のグレーパターンを表します |
HORIZONTAL_STRIPE | 水平ストライプパターンを表します |
NONE | 背景なしを表します |
REVERSE_DIAGONAL_STRIPE | 逆斜線ストライプパターンを表します |
SOLID | 単色パターンを表します |
THICK_DIAGONAL_CROSSHATCH | 太い斜交格子パターンを表します |
THIN_DIAGONAL_CROSSHATCH | 細い斜交格子パターンを表します |
THIN_DIAGONAL_STRIPE | 細い斜線ストライプパターンを表します |
THIN_HORIZONTAL_CROSSHATCH | 細い横格子パターンを表します |
THIN_HORIZONTAL_STRIPE | 細い横ストライプパターンを表します |
THIN_REVERSE_DIAGONAL_STRIPE | 細い逆斜線ストライプパターンを表します |
THIN_VERTICAL_STRIPE | 細い縦ストライプパターンを表します |
VERTICAL_STRIPE | 縦ストライプパターンを表します |
以下の例では、A1セルの前景色が設定されていますが、A2は前景色と背景色の両方を垂直ストライプの背景パターンで構成するように設定されています。
重要なこと
- セルの前景色または背景色を設定するには、Style オブジェクトの foreground_color または background_color プロパティを使用します。どちらのプロパティも、Style オブジェクトの pattern プロパティが構成されている場合のみ効果があります。
- foreground_color プロパティはセルのシェード色を設定します。 patternプロパティは、前景色または背景色に使用される背景パターンの種類を指定します。Aspose.Cells for Python via .NETは、BackgroundTypeという列挙体を提供し、一連の事前定義された背景パターンを含みます。
- BackgroundType 列挙体から BackgroundType.None 値を選択すると、前景色は適用されません。 同様に、BackgroundType.None または BackgroundType.Solid 値を選択すると、背景色は適用されません。
- セルのシェード/塗りつぶし色を取得する場合、Style.pattern が BackgroundType.None であれば、Style.foreground_color は Color.Empty を返します。
グラデーション塗りつぶし効果の適用
セルに希望のグラデーション塗りつぶし効果を適用するには、Style オブジェクトの set_two_color_gradient メソッドを使用してください。
色とパレット
パレットとは、画像を作成するために使用可能な色の数です。プレゼンテーションで標準化されたパレットを使用することで、ユーザーは一貫した外観を作成できます。各 Microsoft Excel (97-2003) ファイルには、セル、フォント、グリッド線、グラフィックオブジェクト、塗りつぶし、およびグラフの線に適用できる 56 色のパレットがあります。
Aspose.Cells for Python via .NETを使用すれば、既存のパレットの色だけでなく、カスタムカラーも使用できます。カスタムカラーを使う前に、最初にパレットに追加してください。
このトピックでは、パレットにカスタム色を追加する方法について説明します。
パレットにカスタム色を追加
Aspose.Cells for Python via .NETは、Microsoft Excelの56色パレットをサポートしています。パレットに定義されていないカスタムカラーを使用するには、その色をパレットに追加してください。
Aspose.Cells for Python via .NETは、Microsoft Excelファイルを表すクラスWorkbookを提供します。Workbookクラスには、次のパラメータを受け取ってパレットを変更するカスタムカラーを追加するためのchange_paletteメソッドがあります:
- カスタムカラー、追加するカスタムカラー。 カスタムカラーが置き換えるパレット内の色のインデックスです。0〜55の間である必要があります。
以下の例では、カスタムカラー(Orchid)をパレットに追加し、フォントに適用する前に追加します。