styles.fills【塗りつぶし】モジュール
メモ ( 概要 塗りつぶし (パターン)の指定方法 塗りつぶし (グラデーション)の指定方法 ) 定数 例
クラス:Fill【塗りつぶし (基底)】 GradientFill【塗りつぶし (パターン)】 PatternFill【塗りつぶし (グラデーション)】 Stop【グラデーション停止色】 StopList【グラデーション停止色リスト】
メモ
概要
- Cell【セル】の塗りつぶしに関連するモジュール
- Excelの [セルの書式設定]-[塗りつぶし]タブ に対応
- Excelの [セルの書式設定]-[塗りつぶし]タブ に対応
- モジュール内定義
- インポート
- 下記は、openpyxl.styles からインポート可
PatternFill【塗りつぶし (パターン)】クラス
GradientFill【塗りつぶし (グラデーション)】クラス
Fill【塗りつぶし (基底)】クラス
- 下記は、openpyxl.styles からインポート可
- 塗りつぶしの種類
- パターン:PatternFill【塗りつぶし (パターン)】
- グラデーション:GradientFill【塗りつぶし (グラデーション)】
- その他スタイルは、cell【セル】モジュール 参照 (個々の詳細は下記モジュール)
- styles.numbers【表示形式】 ・styles.alignment【配置】 ・styles.fonts【フォント】 ・styles.borders【罫線】 ・styles.protection【シート保護】
- テキスト色は、styles.fonts【フォント】参照
- 関連モジュール
塗りつぶし (パターン)の指定方法
〔 例 〕- PatternFill【塗りつぶし (パターン)】の作成
- patternType・fill_type【塗りつぶしパターンの種類】と下記の色を指定し作成 (色を省略すると白黒で作成)
- 塗りつぶし (なし):色指定なし
- 塗りつぶし (単色):fgcolor・start_color【パターンの色】を指定
- その他:fgcolor・start_color【パターンの色】と bgcolor・end_color【背景色】を指定
- 単一セルの指定
- Cell【セル】 の fill【塗りつぶし】プロパティ に PatternFill【塗りつぶし (パターン)】を指定
- 複数セルの指定
- 一括で指定できない為、該当セルに上記の単一セルの処理
- 結合セルの指定
- 左上セルに対して上記の単一セルの処理
塗りつぶし (グラデーション)の指定方法
〔 例 〕- GradientFill【塗りつぶし (グラデーション)】の作成
Excel 上の手動でできる設定に限定するには、 例:Excel 既定 参照- type【グラデーション タイプ】と stop【グラデーション停止色リスト】と下記を指定し作成
- 'linear'【線形グラデーション】:degree【グラデーション角度】を指定
- 'path'【範囲指定グラデーション】:各辺からのグラデーション範囲を指定 (degree【グラデーション角度】以外)
- 単一セルの指定
- Cell【セル】 の fill【塗りつぶし】プロパティ に GradientFill【塗りつぶし (グラデーション)】を指定
- 複数セルの指定
- 一括で指定できない為、該当セルに上記の単一セルの処理
- 結合セルの指定
- 左上セルに対して上記の単一セルの処理
外部リンク
- openpyxl (英語)
- ECMA-376:Office Open XML file formats (英語)
SpreadsheetML:Styles -- bgColor (Background Color)
- fgColor (Foreground Color)
- fill (Fill)
- fills (Fills)
- gradientFill (Gradient)
- patternFill (Pattern)
- stop (Gradient Stop)
定数
PatternFill【塗りつぶし (パターン)】クラス 参照
定数 | 値 | 備考 | ||
---|---|---|---|---|
塗りつぶしパターンの種類 patternType・fill_type | 説明 | パターンの色 fgcolor start_color | 背景色 bgcolor end_color | |
FILL_NONE | 'none' | 塗りつぶし (なし) | ||
FILL_SOLID | 'solid' | 塗りつぶし (単色) | ● | ( 条件付き書式※ ) |
FILL_PATTERN_DARKDOWN | 'darkDown' | 右下がり斜線 縞 | ● | ● |
FILL_PATTERN_DARKGRAY | 'darkGray' | 75% 灰色 | ● | ● |
FILL_PATTERN_DARKGRID | 'darkGrid' | 左下がり斜線 格子 | ● | ● |
FILL_PATTERN_DARKHORIZONTAL | 'darkHorizontal' | 横 縞 | ● | ● |
FILL_PATTERN_DARKTRELLIS | 'darkTrellis' | 極太線 左下がり斜線 格子 | ● | ● |
FILL_PATTERN_DARKUP | 'darkUp' | 左下がり斜線 縞 | ● | ● |
FILL_PATTERN_DARKVERTICAL | 'darkVertical' | 縦 縞 | ● | ● |
FILL_PATTERN_GRAY0625 | 'gray0625' | 6.25% 灰色 | ● | ● |
FILL_PATTERN_GRAY125 | 'gray125' | 12.5% 灰色 | ● | ● |
FILL_PATTERN_LIGHTDOWN | 'lightDown' | 実線 右下がり斜線 縞 | ● | ● |
FILL_PATTERN_LIGHTGRAY | 'lightGray' | 25% 灰色 | ● | ● |
FILL_PATTERN_LIGHTGRID | 'lightGrid' | 実線 横 格子 | ● | ● |
FILL_PATTERN_LIGHTHORIZONTAL | 'lightHorizontal' | 実線 横 縞 | ● | ● |
FILL_PATTERN_LIGHTTRELLIS | 'lightTrellis' | 実線 左下がり斜線 格子 | ● | ● |
FILL_PATTERN_LIGHTUP | 'lightUp' | 実線 左下がり斜線 縞 | ● | ● |
FILL_PATTERN_LIGHTVERTICAL | 'lightVertical' | 実線 縦 縞 | ● | ● |
FILL_PATTERN_MEDIUMGRAY | 'mediumGray' | 50% 灰色 | ● | ● |
※ 条件付き書式で使用する場合に指定
(詳細はformatting.rule【書式ルール】の注意事項 参照))
Fill【塗りつぶし (基底)】クラス
クラス定義
クラス | 備考 |
---|---|
親:openpyxl.descriptors.serialisable.Serialisable インポート:from openpyxl.styles import Fill (省略形) | |
class Fill( ) | 塗りつぶし (基底) |
プロパティ
プロパティ | 型 | 備考 |
---|---|---|
tagname | str | タグ名 ('fill') |
メソッド
クラスメソッド | 備考 |
---|---|
@classmethod from_tree( el) | el |
GradientFill【塗りつぶし (グラデーション)】クラス
クラス定義
クラス | 備考 |
---|---|
親:openpyxl.styles.fills.Fill インポート:from openpyxl.styles import GradientFill (省略形) | |
class GradientFill( type='linear', degree=0, left=0, right=0, top=0, bottom=0, stop=()) | 塗りつぶし (グラデーション) type ( 'linear' | 'path' )グラデーション タイプ degree (float)グラデーション角度 left (float)左辺からのグラデーション範囲 (0:左辺 ~ 1:右辺) right (float)右辺からのグラデーション範囲 (0:左辺 ~ 1:右辺) top (float)上辺からのグラデーション範囲 (0:上辺 ~ 1:下辺) bottom (float)下辺からのグラデーション範囲 (0:上辺 ~ 1:下辺) stop (リスト形式)グラデーション停止色リスト ※指定引数:type (グラデーション タイプ)とstop (グラデーション停止色リスト)と下記 'linear'【線形グラデーション】:degree (グラデーション角度)を指定 'path'【範囲指定グラデーション】:degree (グラデーション角度)以外を指定 |
プロパティ
プロパティ | 型 | 備考 |
---|---|---|
bottom | float | 下辺からのグラデーション範囲 (0:上辺 ~ 1:下辺) |
degree | float | グラデーション角度 (時計回り) 例 0:左から右 90:上から下 180:右から左 270:下から上 |
fill_type | str | type【グラデーション タイプ】のエイリアス |
left | float | 左辺からのグラデーション範囲 (0:左辺 ~ 1:右辺) |
right | float | 右辺からのグラデーション範囲 (0:左辺 ~ 1:右辺) |
stop | StopList | グラデーション停止色リスト |
tagname | str | タグ名 ("gradientFill") |
top | float | 上辺からのグラデーション範囲 (0:上辺 ~ 1:下辺) |
type | 'linear' 'path' | グラデーション タイプ 'linear':線形グラデーション 'path':範囲指定グラデーション |
メソッド
メソッド | 備考 |
---|---|
to_tree( tagname=None, namespace=None, idx=None) | tagname namespace idx |
PatternFill【塗りつぶし (パターン)】クラス
クラス定義
クラス | |
---|---|
親:openpyxl.styles.fills.Fill インポート:from openpyxl.styles import PatternFill (省略形) | |
class PatternFill( patternType=None, fgColor=Color(), bgColor=Color(), fill_type=None, start_color=None, end_color=None) | 塗りつぶし (パターン) patternType (str)パターンの種類 (fill_type)〔FILL_~【塗りつぶしパターンの種類】定数〕 fgColor (Color | str)パターンの色 (start_color / 省略:自動) bgColor (Color | str)背景色 (end_color / 省略:色なし) fill_type (str)パターンの種類 (優先)〔FILL_~【塗りつぶしパターンの種類】定数〕 start_color (Color | str)パターンの色 (優先) end_color (Color | str)背景色 (優先) |
プロパティ
プロパティ | 型 | 備考 |
---|---|---|
bgColor | Color | 背景色 |
end_color | Color | bgColor【背景色】のエイリアス |
fgColor | Color | パターンの色 |
fill_type | str | patternType【パターンの種類】のエイリアス |
patternType | str | パターンの種類 個別の色指定は FILL_~【塗りつぶしパターンの種類】定数 参照 |
start_color | Color | fgColor【パターンの色】のエイリアス |
tagname | str | タグ名 ("patternFill") |
メソッド
メソッド | 備考 |
---|---|
to_tree( tagname=None, idx=None) | tagname idx |
Stop【グラデーション停止色】クラス
クラス定義
クラス | |
---|---|
親:openpyxl.descriptors.serialisable.Serialisable | |
class Stop( color, position) | color position |
プロパティ
プロパティ | 型 | 備考 |
---|---|---|
color | Color | グラデーション停止色リスト |
position | float | |
tagname | str | タグ名 ('stop') |
StopList【グラデーション停止色リスト】クラス
クラス定義
クラス | |
---|---|
親:openpyxl.descriptors.sequence.Sequence | |
class StopList( name=None, **kw) | name kw |
プロパティ
プロパティ | 型 | 備考 |
---|---|---|
expected_type |