Cells
Python
Shape

Shape

aspose-cells-foss atbalsta ģeometrisko formu un teksta lodziņu pievienošanu darblapām caur ShapeCollection (ws.shapes). Katra forma tiek pārstāvēta kā Shape objekts ar konfigurējamiem aizpildījuma, līnijas un teksta īpašībām.

ImageRenderOptions: aspose.cells_foss

from aspose.cells_foss import (
    MsoDrawingType, FillType, MsoLineDashStyle,
    TextAlignmentType, TextAnchorType,
    MsoFillFormat, MsoLineFormat, ShapeFont, Shape,
)

MsoDrawingType

MsoDrawingType ir IntEnum kas identificē ģeometriskās formas veidu.

NameTypeAccessDescription
upper_left_row``Read/WriteGets or sets the upper left row.
upper_left_column``Read/WriteGets or sets the upper left column.
lower_right_row``Read/WriteGets or sets the lower right row.
lower_right_column``Read/WriteGets or sets the lower right column.
upper_left_row_offset``Read/WriteGets or sets the upper left row offset.
upper_left_column_offset``Read/WriteGets or sets the upper left column offset.
lower_right_row_offset``Read/WriteGets or sets the lower right row offset.
lower_right_column_offset``Read/WriteGets or sets the lower right column offset.
name``ReadGets the name.
drawing_type``ReadGets the drawing type.
fill``ReadGets the fill.
line``ReadGets the line.
text``ReadGets the text.
font``ReadGets the font.
text_horizontal_alignment``ReadGets the text horizontal alignment.
text_vertical_alignment``ReadGets the text vertical alignment.
is_text_wrapped``ReadGets the is text wrapped.
is_locked``ReadGets the is locked.
is_hidden``ReadGets the is hidden.
placement``ReadGets the placement.
hyperlink``ReadGets the hyperlink.

FillType

FillType ir IntEnum kas identificē uz formas piemērotā aizpildījuma veidu.

SignatureDescription
__init__(drawing_type, upper_left_row, upper_left_column, lower_right_row, lower_right_column)
copy()Creates a duplicate of the shape object

MsoLineDashStyle

MsoLineDashStyle ir IntEnum kas nosaka robežas/kontūras līnijas pārtraukuma modeli.

TextAlignmentType

TextAlignmentType ir IntEnum kas nosaka horizontālo teksta līdzināšanu formas iekšienē.

TextAnchorType

TextAnchorType ir IntEnum kas nosaka vertikālo teksta piestiprināšanu formas iekšienē.

MsoFillFormat

Kontrolē formas aizpildījuma izskatu. Piekļūst caur shape.fill.

ImageRenderOptions

ImageRenderOptions

kopēt 

fill.copy() -> MsoFillFormat

Atgriež dziļu kopiju šiem aizpildījuma iestatījumiem.

MsoLineFormat

Kontrolē formas kontūras/robežas izskatu. Piekļūst caur shape.line.

ImageRenderOptions

ImageRenderOptions

kopēt 

line.copy() -> MsoLineFormat

Atgriež dziļu kopiju šiem līnijas iestatījumiem.

ShapeFont

Kontrolē teksta fontu formā. Piekļūst caur shape.font.

ImageRenderOptions

ImageRenderOptions

kopēt 

font.copy() -> ShapeFont

Atgriež dziļu kopiju šiem fonta iestatījumiem.

ImageRenderOptions

Shape objekti netiek konstruēti tieši. Izmantojiet ws.shapes.add(...) vai ws.shapes.add_text_box(...).

ImageRenderOptions

ImageRenderOptions

kopēt 

shape.copy() -> Shape

Atgriež dziļu kopiju šim objektam, saglabājot visu formatējumu.

ShapeCollection

ShapeCollection tiek piekļūts kā ws.shapes. Tas satur visas formas darblapā.

ImageRenderOptions

pievienot 

ws.shapes.add(
    drawing_type: MsoDrawingType,
    upper_left_row: int,
    upper_left_column: int,
    lower_right_row: int,
    lower_right_column: int
) -> Shape

Pievieno objektu norādītā tipa. Visi pozīcijas argumenti ir 0‑bāzes rindu/kolonnas indeksi.

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

Īsceļš uz add(MsoDrawingType.TEXT_BOX, ...).

Īpašības un iterācija

ImageRenderOptions

Pievienot taisnstūri ar viendabīgu aizpildījumu 

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")

Pievienot teksta lodziņu 

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")

Skatīt arī

 Latviešu