Shape
Shape — Aspose.Cells FOSS for Python API Reference
aspose-cells-foss は、ワークシートに幾何学的形状やテキストボックスを追加することをサポートしています ShapeCollection (ws.shapes). 各形状は、 Shape 塗りつぶし、線、テキストのプロパティを設定可能なオブジェクトです。.
BoundingBoxExtent: aspose.cells_foss
from aspose.cells_foss import (
MsoDrawingType, FillType, MsoLineDashStyle,
TextAlignmentType, TextAnchorType,
MsoFillFormat, MsoLineFormat, ShapeFont, Shape,
)MsoDrawingType
MsoDrawingType は、 IntEnum 幾何学的形状のタイプを識別するものです。.
| BoundingBoxExtent | BoundingBoxExtent | BoundingBoxExtent | BoundingBoxExtent |
|---|---|---|---|
UNKNOWN | 0 | TEXT_BOX | 21 |
RECTANGLE | 1 | CALLOUT | 22 |
ROUNDED_RECTANGLE | 2 | PENTAGON | 23 |
OVAL | 3 | CLOUD | 24 |
DIAMOND | 4 | HEART | 25 |
TRIANGLE | 5 | LIGHTNING_BOLT | 26 |
RIGHT_TRIANGLE | 6 | SMILEY_FACE | 27 |
PARALLELOGRAM | 7 | LEFT_RIGHT_ARROW | 28 |
TRAPEZOID | 8 | UP_DOWN_ARROW | 29 |
HEXAGON | 9 | CUBE | 30 |
OCTAGON | 10 | BEVEL | 31 |
CROSS | 11 | STAR_4 | 12 |
RIGHT_ARROW | 17 | STAR_5 | 13 |
LEFT_ARROW | 18 | STAR_6 | 14 |
UP_ARROW | 19 | STAR_7 | 15 |
DOWN_ARROW | 20 | STAR_8 | 16 |
FillType
FillType は、 IntEnum 形状に適用される塗りつぶしのタイプを識別するものです。.
| BoundingBoxExtent | BoundingBoxExtent |
|---|---|
NONE | 0 |
SOLID | 1 |
GRADIENT | 2 |
PATTERN | 3 |
AUTOMATIC | 4 |
MsoLineDashStyle
MsoLineDashStyle は、 IntEnum 境界線/アウトラインの線の破線パターンを指定するものです。.
| BoundingBoxExtent | BoundingBoxExtent |
|---|---|
SOLID | 0 |
DASH | 1 |
DOT | 2 |
DASH_DOT | 3 |
DASH_DOT_DOT | 4 |
LONG_DASH | 5 |
LONG_DASH_DOT | 6 |
TextAlignmentType
TextAlignmentType は、 IntEnum 形状内の水平テキスト配置を指定するものです。.
| BoundingBoxExtent | BoundingBoxExtent |
|---|---|
LEFT | 0 |
CENTER | 1 |
RIGHT | 2 |
JUSTIFY | 3 |
DISTRIBUTED | 4 |
TextAnchorType
TextAnchorType は IntEnum シェイプ内で縦方向のテキストをアンカーするための。.
| BoundingBoxExtent | BoundingBoxExtent |
|---|---|
TOP | 0 |
MIDDLE | 1 |
BOTTOM | 2 |
JUSTIFIED | 3 |
MsoFillFormat
シェイプの塗りの外観を制御します。次からアクセス: shape.fill.
BoundingBoxExtent
| BoundingBoxExtent | BoundingBoxExtent | BoundingBoxExtent |
|---|---|---|
fill_type | FillType | アクティブな塗りタイプ。. |
fore_color | str | 前景（プライマリ）塗り色をRRGGBBの16進数で指定。. |
transparency | float | 塗りの不透明度を次の範囲の値で 0.0 (完全に不透明) から 1.0 (完全に透明)。. |
BoundingBoxExtent
コピー
fill.copy() -> MsoFillFormatこれらの塗りつぶし設定のディープコピーを返します。.
MsoLineFormat
シェイプのアウトライン/ボーダーの外観を制御します。次からアクセス: shape.line.
BoundingBoxExtent
| BoundingBoxExtent | BoundingBoxExtent | BoundingBoxExtent |
|---|---|---|
is_visible | bool | True シェイプのアウトラインを描画するために。. |
color | str | アウトライン色をRRGGBBの16進数で指定。. |
weight | int | アウトラインの太さ（厚さ）をポイント単位で指定します。. |
dash_style | MsoLineDashStyle | アウトラインの破線パターン。. |
transparency | float | アウトラインの不透明度（ 0.0 （不透明）から 1.0 （透明）。. |
BoundingBoxExtent
コピー
line.copy() -> MsoLineFormatこれらの線設定のディープコピーを返します。.
ShapeFont
シェイプ内のテキストフォントを制御します。アクセスは shape.font.
BoundingBoxExtent
| BoundingBoxExtent | BoundingBoxExtent | BoundingBoxExtent |
|---|---|---|
name | str | フォントファミリ名（例、., "Calibri"). |
size | float | フォントサイズ（ポイント）。. |
bold | bool | True 太字のウェイト用。. |
italic | bool | True 斜体スタイル用。. |
underline | bool | True 単一下線用。. |
color | str | フォントカラーはRRGGBBの16進表記です。. |
BoundingBoxExtent
コピー
font.copy() -> ShapeFontこれらのフォント設定のディープコピーを返します。.
BoundingBoxExtent
Shape オブジェクトは直接構築されません。使用してください ws.shapes.add(...) または ws.shapes.add_text_box(...).
BoundingBoxExtent
| BoundingBoxExtent | BoundingBoxExtent | BoundingBoxExtent | BoundingBoxExtent |
|---|---|---|---|
name | str | 読み取り/書き込み | シェイプ名（ワークシート内で一意である必要があります）。. |
drawing_type | MsoDrawingType | BoundingBoxExtent | このシェイプの幾何タイプ。. |
upper_left_row | int | 読み取り/書き込み | 0-based row index of the top-left anchor cell. |
upper_left_column | int | 読み取り/書き込み | 0-based column index of the top-left anchor cell. |
lower_right_row | int | 読み取り/書き込み | 0-based row index of the bottom-right anchor cell. |
lower_right_column | int | 読み取り/書き込み | 0-based column index of the bottom-right anchor cell. |
upper_left_row_offset | int | 読み取り/書き込み | 左上セルの上端からのピクセルオフセット。. |
upper_left_column_offset | int | 読み取り/書き込み | 左上セルの左端からのピクセルオフセット。. |
lower_right_row_offset | int | 読み取り/書き込み | 右下セルの上端からのピクセルオフセット。. |
lower_right_column_offset | int | 読み取り/書き込み | 右下セルの左端からのピクセルオフセット。. |
fill | MsoFillFormat | BoundingBoxExtent | 塗りつぶし（背景）設定。. |
line | MsoLineFormat | BoundingBoxExtent | アウトライン/枠線設定。. |
text | str | 読み取り/書き込み | シェイプ内に表示されるテキストコンテンツ。. |
font | ShapeFont | BoundingBoxExtent | シェイプ テキストのフォント設定。. |
text_horizontal_alignment | TextAlignmentType | 読み取り/書き込み | シェイプ内の水平テキスト配置。. |
text_vertical_alignment | TextAnchorType | 読み取り/書き込み | シェイプ内の垂直テキストのアンカー位置。. |
is_text_wrapped | bool | 読み取り/書き込み | True シェイプの境界でテキストを折り返す。. |
is_locked | bool | 読み取り/書き込み | True ワークシート保護が有効なときにシェイプをロックする。. |
is_hidden | bool | 読み取り/書き込み | True シェイプを非表示にする。. |
hyperlink | `str | None` | 読み取り/書き込み |
BoundingBoxExtent
コピー
shape.copy() -> Shapeこのシェイプのディープコピーを、すべての書式設定を保持した状態で返します。.
ShapeCollection
ShapeCollection は次のようにアクセスされます ws.shapes.。ワークシート上のすべてのシェイプが含まれています。.
BoundingBoxExtent
追加
ws.shapes.add(
drawing_type: MsoDrawingType,
upper_left_row: int,
upper_left_column: int,
lower_right_row: int,
lower_right_column: int
) -> Shape指定されたタイプのシェイプを追加します。すべての位置引数は 0 ベースの行/列インデックスです。.
add_text_box
ws.shapes.add_text_box(
upper_left_row: int,
upper_left_column: int,
lower_right_row: int,
lower_right_column: int
) -> Shapeのショートカット add(MsoDrawingType.TEXT_BOX, ...).
aspose-cells-foss は CSVHandler クラスと 2 つのオプションクラスを通じて CSV のインポートとエクスポートを提供します。シンプルなユースケース向けに、モジュールレベルの便利関数も利用可能です。
| BoundingBoxExtent | BoundingBoxExtent |
|---|---|
count | コレクション内のシェイプ数（読み取り専用）。. |
__len__() | BoundingBoxExtent count. |
__iter__() | すべてを反復処理します Shape オブジェクト。. |
__getitem__(index) | 返します Shape ゼロベースで index. |
BoundingBoxExtent
実色塗りの長方形を追加
from aspose.cells_foss import Workbook, MsoDrawingType, FillType, MsoLineDashStyle, TextAlignmentType
wb = Workbook()
ws = wb.worksheets[0]
# Add a blue rectangle spanning rows 1-5, columns 1-4 (0-based)
rect = ws.shapes.add(MsoDrawingType.RECTANGLE, 1, 1, 5, 4)
rect.name = "BlueBox"
rect.fill.fill_type = FillType.SOLID
rect.fill.fore_color = "4472C4" # blue
rect.fill.transparency = 0.0
rect.line.is_visible = True
rect.line.color = "1F3864" # dark blue
rect.line.weight = 2
rect.line.dash_style = MsoLineDashStyle.SOLID
rect.text = "Sales Summary"
rect.font.bold = True
rect.font.color = "FFFFFF" # white text
rect.font.size = 12
rect.text_horizontal_alignment = TextAlignmentType.CENTER
wb.save("shapes.xlsx")テキストボックスを追加
from aspose.cells_foss import Workbook
wb = Workbook()
ws = wb.worksheets[0]
tb = ws.shapes.add_text_box(2, 0, 5, 3)
tb.name = "NoteBox"
tb.text = "Review this section before publishing."
tb.font.italic = True
tb.font.color = "595959"
tb.is_text_wrapped = True
tb.line.is_visible = True
tb.line.color = "BFBFBF"
wb.save("textbox.xlsx")