Style — Aspose.Cells FOSS for Python API Reference
ImageRenderOptions Style クラスとそのコンパニオン型は、aspose-cells-foss のセルに適用されるすべての視覚的および保護的な書式設定を制御します。A Style オブジェクトはセルから以下を使用して取得されます cell.get_style() そして次を使用して再適用されます cell.apply_style(style).
ImageRenderOptions: aspose.cells_foss
from aspose.cells_foss import Style, Font, Fill, Border, Borders, Alignment, NumberFormat, ProtectionImageRenderOptions
ImageRenderOptions
Style()デフォルトのものを作成します Style 明示的な書式設定が適用されていない状態で.
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
font | Font | ImageRenderOptions | フォント設定(名前、サイズ、色、太字、斜体、下線、取り消し線)。. |
fill | Fill | ImageRenderOptions | セルの塗りつぶし/背景設定(パターン、前景色、背景色)。. |
borders | Borders | ImageRenderOptions | セルのすべての罫線設定(上、下、左、右、斜め)。. |
alignment | Alignment | ImageRenderOptions | テキスト配置設定(水平、垂直、折り返し、インデント、回転)。. |
number_format | str | 読み取り/書き込み | アクティブな数値書式コード文字列(例:)., "#,##0.00"). |
protection | Protection | ImageRenderOptions | セル保護設定(ロック、数式非表示)。. |
ImageRenderOptions
コピー
style.copy() -> Styleこのスタイルオブジェクトのディープコピーを返します。.
set_fill_color
style.set_fill_color(color: str)単色塗りつぶしの背景色を設定します。. color は RRGGBB の16進文字列です(例:., "FFFF00" 黄色の場合)。.
set_fill_pattern
style.set_fill_pattern(pattern_type: str, fg_color: str = 'FFFFFFFF', bg_color: str = 'FFFFFFFF')パターン塗りつぶしを設定します。. pattern_type 値には以下が含まれます 'solid', 'darkGray', 'mediumGray', 'lightGray', 'gray125', 'gray0625', 'darkHorizontal', 'darkVertical', 'darkDown', 'darkUp', 'darkGrid', 'darkTrellis', 'lightHorizontal', 'lightVertical', 'lightDown', 'lightUp', 'lightGrid', 'lightTrellis'.
set_no_fill
style.set_no_fill()塗りつぶしをすべてクリアし、セルの背景を透明(塗りつぶしなし)に設定します。.
set_border_color
style.set_border_color(side: str, color: str)単一の罫線側の色を設定します。. side 次のいずれかである必要があります 'top', 'bottom', 'left', 'right', 'diagonal'. color は RRGGBB の16進文字列です。.
set_border_style
style.set_border_style(side: str, style: str)罫線側の線種を設定します。. style 値:: 'none', 'thin', 'medium', 'thick', 'dashed', 'dotted', 'double'.
set_border_weight
style.set_border_weight(side: str, weight: int)ボーダー側の線の太さ(厚さ)を整数で設定します。.
set_border
style.set_border(side: str, line_style='none', color='FF000000', weight=1)1 回の呼び出しで単一のボーダー側の線スタイル、色、太さを設定する便利メソッドです。.
set_diagonal_border
style.set_diagonal_border(line_style='none', color='FF000000', weight=1, up=False, down=False)対角線の罫線を設定します。渡す up=True 上向きの対角線の場合、, down=True 下向きの対角線の場合、または両方で十字を描画します。.
set_horizontal_alignment
style.set_horizontal_alignment(alignment: str)水平テキスト配置を設定します。値: 'general', 'left', 'center', 'right', 'fill', 'justify', 'centerContinuous', 'distributed'.
set_vertical_alignment
style.set_vertical_alignment(alignment: str)垂直テキスト配置を設定します。値: 'top', 'center', 'bottom', 'justify', 'distributed'.
set_text_wrap
style.set_text_wrap(wrap=True)セル内でのテキスト折り返しを有効または無効にします。.
set_shrink_to_fit
style.set_shrink_to_fit(shrink=True)縮小適合を有効または無効にします。有効にすると、テキストがセル幅に合わせて縮小されます。.
set_indent
style.set_indent(indent: int)インデントレベルを設定します(0〜15)。.
set_text_rotation
style.set_text_rotation(rotation: int)テキストの回転角度を度単位で設定します。有効な値は 0–180(0°から反時計回り)または 255(縦書きで上から下へ積み重ね)です。.
set_reading_order
style.set_reading_order(order: int)読み取り順序を設定します。. 0 = コンテキスト依存、, 1 = 左から右、, 2 = 右から左。.
set_number_format
style.set_number_format(format_code: str)カスタム数値書式文字列を適用します(例:., "DD/MM/YYYY", "#,##0.00 [$€-407]").
set_builtin_number_format
style.set_builtin_number_format(format_id: int)Excel の組み込み数値書式を整数 ID で適用します(例:)., 9 = "0%", 14 = "m/d/yy").
set_locked
style.set_locked(locked=True)セルをロック状態にします。シート保護が有効な場合、ロックされたセルは編集できません。.
set_formula_hidden
style.set_formula_hidden(hidden=True)シート保護が有効なとき、数式バーから数式を非表示にします。.
ImageRenderOptions
ImageRenderOptions
Font(name='Calibri', size=11, color='FF000000', bold=False, italic=False, underline=False, strikethrough=False)ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
name | str | フォントファミリ名(例:., "Calibri", "Arial"). |
size | `int | float` |
color | str | RRGGBB 16進文字列としてのフォントカラー(例:., "FF0000" 赤の場合)。. |
bold | bool | True 太字のウェイトを適用する。. |
italic | bool | True イタリックスタイルを適用する。. |
underline | bool | True 単一の下線を適用する。. |
strikethrough | bool | True 取り消し線を適用する。. |
ImageRenderOptions
ImageRenderOptions
Fill(pattern_type='none', foreground_color='FFFFFFFF', background_color='FFFFFFFF')ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
pattern_type | str | 塗りつぶしパターンタイプ(例:., 'solid', 'none', 'darkGray'). |
foreground_color | str | 前景色を RRGGBB 16進文字列で指定。. |
background_color | str | 背景色を RRGGBB 16進文字列で指定。. |
ImageRenderOptions
set_solid_fill
fill.set_solid_fill(color: str)指定された RRGGBB カラーで単色塗りつぶしを適用します。.
set_gradient_fill
fill.set_gradient_fill(start_color: str, end_color: str)2 色のグラデーション塗りつぶしを適用します。.
set_pattern_fill
fill.set_pattern_fill(pattern_type: str, fg_color: str, bg_color: str)前景色と背景色を明示的に指定したパターン塗りつぶしを適用します。.
set_no_fill
fill.set_no_fill()セルからすべての塗りつぶしを削除します。.
ImageRenderOptions
ImageRenderOptions
Border(line_style='none', color='FF000000', weight=1)ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
line_style | str | 枠線スタイル:: 'none', 'thin', 'medium', 'thick', 'dashed', 'dotted', 'double'. |
color | str | 枠線の色はRRGGBBの16進数で指定。. |
weight | int | 枠線の太さ(厚さ)は整数で指定。. |
ImageRenderOptions
ImageRenderOptions
Borders()4 つのセル枠線と対角線枠線すべてを含むコンテナです。.
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
top | Border | 上枠線設定。. |
bottom | Border | 下枠線設定。. |
left | Border | 左枠線設定。. |
right | Border | 右枠線設定。. |
diagonal | Border | 斜め枠線設定。. |
diagonal_up | bool | True 上向きの斜め線を描画する。. |
diagonal_down | bool | True 下向きの斜め線を描画する。. |
ImageRenderOptions
ImageRenderOptions
Alignment(horizontal='general', vertical='bottom', wrap_text=False, indent=0, text_rotation=0, shrink_to_fit=False)ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
horizontal | str | 水平揃え:: 'general', 'left', 'center', 'right', 'fill', 'justify', 'centerContinuous', 'distributed'. |
vertical | str | 垂直方向の配置: 'top', 'center', 'bottom', 'justify', 'distributed'. |
wrap_text | bool | True セル内でテキストを折り返す。. |
indent | int | インデントレベル (0–15)。. |
text_rotation | int | テキストの回転角度(0–180、またはスタック表示の場合は255)。. |
shrink_to_fit | bool | True セルに合わせてテキストを縮小する。. |
NumberFormat
NumberFormat はユーティリティクラスで、静的メソッドのみを持ちます。直接インスタンス化されません。.
静的メソッド
get_builtin_format
NumberFormat.get_builtin_format(format_id: int) -> str指定された組み込みフォーマットIDのフォーマットコード文字列を返します(例:., NumberFormat.get_builtin_format(9) 返す "0%").
is_builtin_format
NumberFormat.is_builtin_format(format_code: str) -> boolImageRenderOptions True 指定されたフォーマットコードが既知の組み込みExcelフォーマットと一致する場合。.
lookup_builtin_format
NumberFormat.lookup_builtin_format(format_code: str) -> int | Noneフォーマットコード文字列に対する組み込みフォーマットIDを返します。あるいは None コードが組み込みフォーマットでない場合。.
ImageRenderOptions
ImageRenderOptions
Protection(locked=True, hidden=False)ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
locked | bool | True ワークシート保護がオンになっているとき(デフォルト)、セルがロックされていることを意味します。. |
hidden | bool | True ワークシート保護がオンになっているとき、セル内の任意の数式が数式バーに非表示になることを意味します。. |
ImageRenderOptions
以下の例は、ヘッダーセルを太字の赤文字、黄色の背景、そして全辺に細い黒枠線で装飾します。.
from aspose.cells_foss import Workbook
wb = Workbook()
ws = wb.worksheets[0]
ws.cells["A1"].put_value("Total Revenue")
style = ws.cells["A1"].get_style()
# Bold red font
style.font.bold = True
style.font.color = "FF0000" # red
style.font.size = 13
# Yellow solid fill
style.set_fill_color("FFFF00")
# Thin black border on all four sides
for side in ("top", "bottom", "left", "right"):
style.set_border(side, line_style="thin", color="000000", weight=1)
# Center the text
style.set_horizontal_alignment("center")
ws.cells["A1"].apply_style(style)
wb.save("styled.xlsx")