Shape — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss, çalışma sayfalarına geometrik şekiller ve metin kutuları eklemeyi destekler ShapeCollection (ws.shapes). Her şekil bir Shape nesnesi, yapılandırılabilir dolgu, çizgi ve metin özelliklerine sahiptir.

Enumerations: aspose.cells_foss

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

MsoDrawingType

MsoDrawingType bir IntEnum geometrik şekil tipini tanımlayan.

EnumerationsEnumerationsEnumerationsEnumerations
UNKNOWN0TEXT_BOX21
RECTANGLE1CALLOUT22
ROUNDED_RECTANGLE2PENTAGON23
OVAL3CLOUD24
DIAMOND4HEART25
TRIANGLE5LIGHTNING_BOLT26
RIGHT_TRIANGLE6SMILEY_FACE27
PARALLELOGRAM7LEFT_RIGHT_ARROW28
TRAPEZOID8UP_DOWN_ARROW29
HEXAGON9CUBE30
OCTAGON10BEVEL31
CROSS11STAR_412
RIGHT_ARROW17STAR_513
LEFT_ARROW18STAR_614
UP_ARROW19STAR_715
DOWN_ARROW20STAR_816

FillType

FillType bir IntEnum bir şekle uygulanan dolgu tipini tanımlayan.

EnumerationsEnumerations
NONE0
SOLID1
GRADIENT2
PATTERN3
AUTOMATIC4

MsoLineDashStyle

MsoLineDashStyle bir IntEnum kenar/çerçeve çizgi kesikli deseni için.

EnumerationsEnumerations
SOLID0
DASH1
DOT2
DASH_DOT3
DASH_DOT_DOT4
LONG_DASH5
LONG_DASH_DOT6

TextAlignmentType

TextAlignmentType bir IntEnum bir şekil içinde yatay metin hizalaması için.

EnumerationsEnumerations
LEFT0
CENTER1
RIGHT2
JUSTIFY3
DISTRIBUTED4

TextAnchorType

TextAnchorType bir IntEnum bir şekil içinde dikey metin sabitlemesi için.

EnumerationsEnumerations
TOP0
MIDDLE1
BOTTOM2
JUSTIFIED3

MsoFillFormat

Bir şeklin dolgu görünümünü kontrol eder. Şu yolla erişilir shape.fill.

Enumerations

EnumerationsEnumerationsEnumerations
fill_typeFillTypeEtkin dolgu türü.
fore_colorstrÖn plan (birincil) doldurma rengi RRGGBB onaltılık.
transparencyfloatDoldurma opaklığı şu değerden 0.0 (tamamen opak) ile 1.0 (tamamen şeffaf).

Enumerations

copy

fill.copy() -> MsoFillFormat

Bu doldurma ayarlarının derin bir kopyasını döndürür.


MsoLineFormat

Bir şeklin dış hat/kenar görünümünü kontrol eder. Şu yolla erişilir shape.line.

Enumerations

EnumerationsEnumerationsEnumerations
is_visibleboolTrue şekil konturunu çizmek için.
colorstrKontur rengi RRGGBB onaltılık olarak.
weightintKontur kalınlığı (genişliği) puan cinsinden.
dash_styleMsoLineDashStyleKontur için kesikli desen.
transparencyfloatKontur opaklığı şu değerden 0.0 (opak) şu değere 1.0 (şeffaf).

Enumerations

copy

line.copy() -> MsoLineFormat

Bu çizgi ayarlarının derin bir kopyasını döndürür.


ShapeFont

Bir şekil içindeki metin yazı tipini kontrol eder. Şu yolla erişilir: shape.font.

Enumerations

EnumerationsEnumerationsEnumerations
namestrYazı tipi ailesi adı (örneğin,., "Calibri").
sizefloatYazı tipi boyutu puan cinsinden.
boldboolTrue kalın ağırlık için.
italicboolTrue italik stil için.
underlineboolTrue tek alt çizgi için.
colorstrYazı tipi rengi RRGGBB onaltılık olarak.

Enumerations

copy

font.copy() -> ShapeFont

Bu yazı tipi ayarlarının derin bir kopyasını döndürür.


Enumerations

Shape nesneler doğrudan oluşturulmaz. Şunu kullanın: ws.shapes.add(...) veya ws.shapes.add_text_box(...).

Enumerations

EnumerationsEnumerationsEnumerationsEnumerations
namestrOkuma/YazmaŞekil adı (çalışma sayfası içinde benzersiz olmalıdır).
drawing_typeMsoDrawingTypeEnumerationsBu şeklin geometrik türü.
upper_left_rowintOkuma/Yazma0-based row index of the top-left anchor cell.
upper_left_columnintOkuma/Yazma0-based column index of the top-left anchor cell.
lower_right_rowintOkuma/Yazma0-based row index of the bottom-right anchor cell.
lower_right_columnintOkuma/Yazma0-based column index of the bottom-right anchor cell.
upper_left_row_offsetintOkuma/YazmaÜst sol hücrenin üst kenarından piksel kayması.
upper_left_column_offsetintOkuma/YazmaÜst sol hücrenin sol kenarından piksel kayması.
lower_right_row_offsetintOkuma/YazmaAlt sağ hücrenin üst kenarından piksel kayması.
lower_right_column_offsetintOkuma/YazmaAlt sağ hücrenin sol kenarından piksel kayması.
fillMsoFillFormatEnumerationsDolgu (arka plan) ayarları.
lineMsoLineFormatEnumerationsAnahat/kenar ayarları.
textstrOkuma/YazmaŞekil içinde görüntülenen metin içeriği.
fontShapeFontEnumerationsŞekil metni için yazı tipi ayarları.
text_horizontal_alignmentTextAlignmentTypeOkuma/YazmaŞekil içindeki yatay metin hizalaması.
text_vertical_alignmentTextAnchorTypeOkuma/YazmaŞekil içindeki dikey metin sabitlemesi.
is_text_wrappedboolOkuma/YazmaTrue metni şekil sınırında kaydırmak için.
is_lockedboolOkuma/YazmaTrue çalışma sayfası koruması etkin olduğunda şekli kilitlemek için.
is_hiddenboolOkuma/YazmaTrue şekli gizlemek için.
hyperlink`strNone`Okuma/Yazma

Enumerations

copy

shape.copy() -> Shape

Bu şeklin tüm biçimlendirmeleri korunmuş bir derin kopyasını döndürür.


ShapeCollection

ShapeCollection olarak erişilir ws.shapes. Çalışma sayfasındaki tüm şekilleri içerir.

Enumerations

add

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

Belirtilen türde bir şekil ekler. Tüm konum argümanları 0 tabanlı satır/sütun indeksleridir.

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

Kısayol: add(MsoDrawingType.TEXT_BOX, ...).

Özellikler ve Yineleme

EnumerationsEnumerations
countKoleksiyondaki şekil sayısı (yalnızca okunur).
__len__()Enumerations count.
__iter__()Tüm … üzerinde yineleme yapar. Shape nesneler.
__getitem__(index)Şunu döndürür Shape sıfır tabanlı olarak index.

Enumerations

Katı Dolgu ile bir Dikdörtgen ekle

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

Bir Metin Kutusu ekle

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

Ayrıca Bakınız

 Türkçe