Aspose.Cells FOSS for Python

Informacje o pakiecie


pakiet PyPI	`aspose-cells-foss`
Python import	`from aspose.cells_foss import ...`
ImageRenderOptions	26.3.1
ImageRenderOptions	MIT
Python requirement	>= 3.7
ImageRenderOptions	`pycryptodome>=3.15.0`, `olefile>=0.46`

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions
aspose.cells_foss	Podstawowe API arkusza kalkulacyjnego: workbooks, worksheets, cells, styles, charts, format handlers

ImageRenderOptions: Nie ma aspose.pydrawing moduł w Aspose.Cells FOSS. Kolory są wyrażane jako 8‑cyfrowe ciągi szesnastkowe AARRGGBB (np., "FFFF0000" dla nieprzezroczystej czerwieni).

aspose.cells_foss

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`Workbook`	skoroszyt	Punkt wejścia do tworzenia, wczytywania i zapisywania plików arkuszy kalkulacyjnych
`Worksheet`	arkusz	Reprezentuje pojedynczy arkusz; zapewnia dostęp do komórek, wykresów i obrazów
`Cells`	komórki	Kolekcja podobna do słownika `Cell` obiektów w `Worksheet`
`Cell`	komórka	Reprezentuje pojedynczą komórkę; wartość, formułę i styl
`Style`	styl	Formatowanie komórki: czcionka, wypełnienie, obramowania, wyrównanie, format liczbowy, ochrona
`Font`	styl	Właściwości czcionki: nazwa, rozmiar, kolor, pogrubienie, kursywa, podkreślenie, przekreślenie
`Fill`	styl	Wypełnienie tła: jednolite, gradientowe lub wzorzysty
`NumberFormat`	styl	Wbudowane narzędzia do wyszukiwania formatów liczb
`SaveFormat`	skoroszyt	Wyliczenie obsługiwanych formatów wyjściowych (XLSX, CSV, MARKDOWN, JSON)
`Chart`	wykres	Reprezentuje wykres osadzony w arkuszu
`ChartType`	wykres	Wyliczenie: LINE, BAR, PIE, AREA, STOCK i inne
`NSeries`	wykres	Zbiór serii danych na wykresie
`ChartSeries`	wykres	Jedna seria danych z wartościami, kategoriami i słupkami błędów
`ChartAxis`	wykres	Ustawienia osi: skala, format, tytuł
`ChartView3D`	wykres	3D rotation and perspective settings
`ChartErrorBars`	wykres	Konfiguracja słupka błędu dla serii
`DataValidation`	walidacja danych	Pojedyncza reguła walidacji w zakresie komórek
`DataValidationCollection`	walidacja danych	Wszystkie reguły walidacji dla arkusza
`DataValidationType`	walidacja danych	Enum: WHOLE_NUMBER, DECIMAL, LIST, DATE, TIME, TEXT_LENGTH, CUSTOM
`DataValidationOperator`	data-validation	Enum: BETWEEN, EQUAL, GREATER_THAN, itp.
`DataValidationAlertStyle`	data-validation	Enum: STOP, WARNING, INFORMATION
`CSVHandler`	csv-handler	Statyczne metody do importu/eksportu CSV
`CSVLoadOptions`	csv-handler	Opcje ładowania plików CSV
`CSVSaveOptions`	csv-handler	Opcje zapisywania plików CSV
`MarkdownHandler`	markdown-handler	Statyczne metody eksportu Markdown
`MarkdownSaveOptions`	markdown-handler	Opcje eksportu Markdown
`JsonHandler`	json-handler	Statyczne metody eksportu JSON
`JsonSaveOptions`	json-handler	Opcje eksportu JSON
`Shape`	kształt	Rysowanie kształtu z wypełnieniem, linią, tekstem i formatowaniem czcionki
`ShapeCollection`	kształt	Wszystkie kształty w arkuszu (`ws.shapes`)
`MsoDrawingType`	kształt	Wyliczenie: RECTANGLE, OVAL, TEXT_BOX, ARROW, itp.
`Table`	tabela	Tabela Excel (referencja strukturalna) w arkuszu
`TableCollection`	tabela	Wszystkie tabele w arkuszu (`ws.list_objects`)
`TableColumn`	tabela	Definicja kolumny w tabeli
`TableStyleInfo`	tabela	Ustawienia stylu wizualnego dla tabeli
`SparklineGroup`	sparkline	Grupa wykresów sparkline dzielących styl wizualny
`SparklineGroupCollection`	sparkline	Wszystkie grupy sparkline (`ws.sparkline_groups`)
`Sparkline`	sparkline	Pojedyncza komórka sparkline powiązana z zakresem danych
`SparklineType`	sparkline	Wyliczenie: LINE, COLUMN, WIN_LOSS
`HorizontalPageBreakCollection`	page-break	Ręczne poziome przerwy stron (`ws.horizontal_page_breaks`)
`VerticalPageBreakCollection`	przerwa-strony	Ręczne pionowe przerwy stron (`ws.vertical_page_breaks`)
`AgileEncryptionParameters`	szyfrowanie	Parametry szyfrowania AES-256/SHA-512 (zalecane)
`StandardEncryptionParameters`	szyfrowanie	Starsze parametry szyfrowania AES-128/SHA-1
`CipherAlgorithm`	szyfrowanie	Wyliczenie: AES_128, AES_192, AES_256
`HashAlgorithm`	szyfrowanie	Wyliczenie: SHA1, SHA256, SHA384, SHA512

ImageRenderOptions

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions
`Workbook()`	Utwórz nowy pusty skoroszyt (format XLSX)
`Workbook(file_path: str)`	Wczytaj skoroszyt z ścieżki pliku
`Workbook(file_path: str, password: str)`	Wczytaj skoroszyt zabezpieczony hasłem

Kluczowe właściwości

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`worksheets`	lista	Uzyskaj dostęp do arkuszy roboczych według indeksu: `workbook.worksheets[0]`

Kluczowe metody

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`save(file_path)`	ImageRenderOptions	Zapisz do pliku; format wywnioskowany z rozszerzenia
`save(file_path, save_format)`	ImageRenderOptions	Zapisz z wyraźnym SaveFormat
`save_as_csv(file_path, options=None)`	ImageRenderOptions	Zapisz jako CSV
`save_as_markdown(file_path, options=None)`	ImageRenderOptions	Zapisz jako tabele Markdown
`save_as_json(file_path, options=None)`	ImageRenderOptions	Zapisz jako JSON
`load_csv(file_path, options=None)`	ImageRenderOptions	Wczytaj dane CSV do skoroszytu
`add_worksheet(name=None)`	ImageRenderOptions	Dodaj nowy arkusz
`get_worksheet(index_or_name)`	ImageRenderOptions	Pobierz arkusz według indeksu lub nazwy
`remove_worksheet(index_or_name)`	ImageRenderOptions	Usuń arkusz
`copy_worksheet(index_or_name_or_ws)`	ImageRenderOptions	Skopiuj istniejący arkusz
`protect(password=None, lock_structure=True)`	ImageRenderOptions	Zabezpiecz skoroszyt hasłem
`unprotect(password=None)`	ImageRenderOptions	Usuń ochronę skoroszytu
`is_protected()`	bool	Sprawdź, czy skoroszyt jest chroniony

ImageRenderOptions

Kluczowe właściwości

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`name`	str	Nazwa zakładki arkusza
`cells`	ImageRenderOptions	Wszystkie komórki w tym arkuszu
`charts`	ChartCollection	Wszystkie wykresy w tym arkuszu

ImageRenderOptions

Cells obsługuje dostęp w stylu słownikowym za pomocą ciągu adresu komórki.

Wzorce dostępu

# Read a cell value
value = ws.cells["A1"].value

# Set a cell value directly
ws.cells["A1"].value = "Hello"

# Assign a Cell object
from aspose.cells_foss import Cell
ws.cells["A1"] = Cell(42)
ws.cells["A2"] = Cell(3.14)
ws.cells["A3"] = Cell("Hello World")
ws.cells["A4"] = Cell(None, "=SUM(A1:A3)")   # formula cell

ImageRenderOptions

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions
`Cell(value=None)`	Utwórz komórkę z wartością (int, float, str lub None)
`Cell(value, formula)`	Utwórz komórkę formuły (wartość jest zazwyczaj None)

Kluczowe właściwości

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`value`	ImageRenderOptions	Wartość komórki (str, int, float lub None)
`formula`	str	Ciąg formuły (np., `"=SUM(A1:A5)"`)
`style`	ImageRenderOptions	Styl komórki (font, fill)

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`font`	ImageRenderOptions	Ustawienia czcionki dla tego stylu
`fill`	ImageRenderOptions	Ustawienia wypełnienia tła

ImageRenderOptions

Kolory są wyrażane jako 8-digit AARRGGBB hex strings bez # prefiks. Przykłady: "FFFF0000" = nieprzezroczysty czerwony, "FF0000FF" = nieprzezroczysty niebieski, "FF000000" = czarny.

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`name`	str	ImageRenderOptions	Nazwa rodziny czcionki
`size`	float	11	Rozmiar czcionki w punktach
`color`	str	FF000000	8-digit AARRGGBB hex color string
`bold`	bool	ImageRenderOptions	Pogrubiony tekst
`italic`	bool	ImageRenderOptions	Tekst kursywą
`underline`	bool	ImageRenderOptions	Podkreślony tekst
`strikethrough`	bool	ImageRenderOptions	Przekreślony tekst

ImageRenderOptions

Font(name="Calibri", size=11, color="FF000000",
     bold=False, italic=False, underline=False, strikethrough=False)

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions
`set_solid_fill(color)`	Jednolite tło; `color` jest 8‑cyfrowym ciągiem szesnastkowym AARRGGBB
`set_pattern_fill(pattern_type, fg_color, bg_color)`	Wzorzysty wypełnienie
`set_no_fill()`	Usuń wypełnienie tła

MarkdownHandler

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`MarkdownHandler.save_markdown_to_string(workbook)`	str	Eksportuj skoroszyt do łańcucha znaków Markdown w pamięci

MarkdownSaveOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`default_alignment`	str	lewo	Wyrównanie kolumny: lewo, prawo lub środek
`include_worksheet_name`	bool	ImageRenderOptions	Czy uwzględnić nazwę arkusza jako nagłówek
`header_level`	int	2	Poziom nagłówka Markdown (1-6)
`worksheet_index`	int	0	Indeks arkusza do eksportu; -1 eksportuje wszystkie arkusze

ChartCollection

Wykresy są dodawane przy użyciu dedykowanych metod dla każdego typu. Indeksy wierszy i kolumn są indeksowane od zera.

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`add_bar(top_row, left_col, bottom_row, right_col)`	ImageRenderOptions	Dodaj wykres kolumnowy (pionowy słupek)
`add_line(top_row, left_col, bottom_row, right_col)`	ImageRenderOptions	Dodaj wykres liniowy
`add_pie(top_row, left_col, bottom_row, right_col)`	ImageRenderOptions	Dodaj wykres kołowy

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`title`	str	Tytuł wykresu jako zwykły ciąg znaków (nie `.title.text`)
`category_data`	str	Zakres komórek dla etykiet kategorii osi X
`n_series`	NSeries	Zbiór serii danych
`show_legend`	bool	Czy wyświetlać legendę
`legend_position`	str	Pozycja legendy: po prawej, na dole, po lewej lub u góry

NSeries

ImageRenderOptions	ImageRenderOptions
`add(data_range, category_data=None, name=None)`	Dodaj nazwany zestaw danych

Wyliczenie SaveFormat

ImageRenderOptions	Format wyjściowy
`SaveFormat.XLSX`	Excel Open XML (domyślnie)
`SaveFormat.CSV`	Wartości rozdzielane przecinkami
`SaveFormat.TSV`	Wartości rozdzielane tabulacjami
`SaveFormat.MARKDOWN`	Tabele Markdown
`SaveFormat.JSON`	Dane strukturalne JSON

ImageRenderOptions: SaveFormat.PDF, SaveFormat.HTML, SaveFormat.PNG, SaveFormat.TIFF, SaveFormat.DOCX, oraz SaveFormat.PPTX są niedostępne w Aspose.Cells FOSS. Te formaty wymagają komercyjnego aspose-cells-python pakietu.

Przykłady kodu

Utwórz, sformatuj i zapisz skoroszyt

from aspose.cells_foss import Workbook, Cell

wb = Workbook()
ws = wb.worksheets[0]

ws.cells["A1"].value = "Revenue Report"
ws.cells["A2"].value = 125000

ws.cells["A1"].style.font.bold = True
ws.cells["A1"].style.font.size = 14
ws.cells["A1"].style.font.color = "FF1E64C8"   # Blue (AARRGGBB, no #)

wb.save("report.xlsx")

Eksportuj do Markdown w pamięci

from aspose.cells_foss import Workbook, Cell, MarkdownHandler

wb = Workbook()
ws = wb.worksheets[0]
ws.cells["A1"].value = "Name"
ws.cells["B1"].value = "Score"
ws.cells["A2"].value = "Alice"
ws.cells["B2"].value = 95

md = MarkdownHandler.save_markdown_to_string(wb)
print(md)

Zbuduj wykres liniowy

from aspose.cells_foss import Workbook, Cell

wb = Workbook()
ws = wb.worksheets[0]

for i, (m, v) in enumerate([("Jan", 50), ("Feb", 80), ("Mar", 120)], start=2):
    ws.cells[f"A{i}"].value = m
    ws.cells[f"B{i}"].value = v

chart = ws.charts.add_line(5, 0, 18, 7)
chart.title = "Monthly Trend"
chart.category_data = "A2:A4"
chart.n_series.add("B2:B4", category_data="A2:A4", name="Sales")

wb.save("trend.xlsx")

Powiązane zasoby

Przewodnik dla programistów: Samouczki dla wszystkich podstawowych funkcji
Rozpoczęcie / Instalacja: pip install i konfiguracja
Baza wiedzy: Przewodniki krok po kroku ukierunkowane na zadania
Przegląd produktu: Podsumowanie funkcji i możliwości
Repozytorium GitHub
Blog: Wprowadzenie Aspose.Cells FOSS: Przegląd biblioteki i szybki start