Cells
API Overview

Aspose.Cells FOSS API Reference

ImageRenderOptions

Aspose.Cells FOSS is an open-source Python library for creating, reading, and modifying spreadsheet files without requiring Microsoft Excel. It supports XLSX and CSV formats for input, and adds Markdown export via save_as_markdown(). 라이브러리는 하나의 루트 객체를 중심으로 구조화되어 있습니다 Workbook 루트 객체는 워크시트, 스타일, 차트 및 I/O를 관리합니다.

핵심 진입점은 Workbook.각 Workbook 은(는) 하나 이상의 Worksheet 객체에 접근할 수 있도록 wb.worksheets[index].개별 셀은 Cells 컬렉션을 통해 A1 표기법 또는 0 기반 행/열 인덱스를 사용합니다.

from aspose.cells_foss import Workbook

wb = Workbook()
ws = wb.worksheets[0]
ws.cells["A1"].value = "Revenue"
ws.cells["B2"].value = 42
wb.save("output.xlsx")

Workbook 및 Worksheet

ImageRenderOptions Workbook 클래스는 모든 스프레드시트 작업을 위한 루트 객체입니다. 파일 로드, 저장 및 워크시트와 문서 속성에 대한 접근을 처리합니다.

from aspose.cells_foss import Workbook

wb = Workbook()                      # new workbook
wb = Workbook("input.xlsx")          # open existing file
wb = Workbook("protected.xlsx", password="secret")  # open encrypted file

ws = wb.worksheets[0]                # first worksheet (0-based)
ws = wb.add_worksheet("Sheet2")      # add a named worksheet

ws.cells["A1"].put_value("Hello")    # write by A1 reference
ws.cells["A1"].value                 # read value (property, no parentheses)
ws.cells["A2"].formula = "=SUM(B1:B5)"

wb.save("output.xlsx")               # save as XLSX
wb.save("output.csv")                # auto-detects format from extension
wb.save_as_markdown("output.md")     # export as Markdown table
wb.save("output.xlsx", password="secret")  # save with AES encryption

ImageRenderOptions

워크시트에 차트를 추가하려면 add_* 의 메서드를 사용합니다. ws.charts.각 메서드는 네 개의 위치 인수를 받습니다: top_row, left_col, bottom_row, right_col.인덱스로 차트에 접근하여 제목과 데이터 시리즈를 설정합니다.

from aspose.cells_foss import Workbook

wb = Workbook()
ws = wb.worksheets[0]
chart_idx = ws.charts.add_line(upper_left_row=0, upper_left_col=4,
                                lower_right_row=20, lower_right_col=12)
chart = ws.charts[chart_idx]
chart.title = "Monthly Sales"
chart.n_series.add("B2:B7", category_data="A2:A7", name="Sales")

# Other add methods: add_bar, add_pie, add_area, add_scatter,
# add_waterfall, add_combo, add_stock, add_surface, add_radar,
# add_treemap, add_sunburst, add_histogram, add_funnel,
# add_box_whisker, add_map

ImageRenderOptions

워크시트에 도형 및 텍스트 상자를 추가하려면 ws.shapes.

from aspose.cells_foss import Workbook
from aspose.cells_foss import MsoDrawingType, TextAlignmentType, TextAnchorType

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

shape = ws.shapes.add(MsoDrawingType.ROUNDED_RECTANGLE, 1, 1, 5, 5)
shape.text = "Hello"
shape.fill.fore_color = "90EE90"
shape.font.bold = True
shape.text_horizontal_alignment = TextAlignmentType.CENTER
shape.text_vertical_alignment = TextAnchorType.MIDDLE

textbox = ws.shapes.add_text_box(7, 1, 11, 8)
textbox.text = "Notes"

셀 값 및 스타일

를 사용하여 셀 값을 읽고 씁니다. .value 속성. 접근하여 서식을 수정합니다. cell.style 직접.

from aspose.cells_foss import Workbook

workbook = Workbook()
worksheet = workbook.worksheets[0]

# Write values
worksheet.cells["A1"].value = "Hello"
worksheet.cells["B1"].value = "World"
worksheet.cells["A2"].value = 42
worksheet.cells["B2"].value = 3.14

# Read a value
value = worksheet.cells["A1"].value
print(f"Cell A1 contains: {value}")

# Apply a style via the cell's style property
cell = worksheet.cells["A1"]
cell.style.font.bold = True
cell.style.font.size = 14
cell.style.font.color = "FF0000"          # RRGGBB hex, no # prefix
cell.style.set_horizontal_alignment("center")
cell.style.set_number_format("#,##0.00")
cell.style.set_border("bottom", line_style="thin")

workbook.save("output.xlsx")

참고: 설정할 때 font.color, 접두사 없이 16진수 문자열을 사용하십시오 # 접두사 (예:., "FF0000" 빨간색용).

데이터 유효성 검사

셀 범위에 드롭다운 또는 기타 검증 규칙을 추가하려면 ws.data_validations.

from aspose.cells_foss import Workbook, DataValidationType

workbook = Workbook()
worksheet = workbook.worksheets[0]

validation = worksheet.data_validations.add("A1:A10")
validation.type = DataValidationType.LIST
validation.formula1 = '"Option1,Option2,Option3"'

workbook.save("validation.xlsx")

ImageRenderOptions

비밀번호로 보호된 워크북을 저장하거나 열기:

from aspose.cells_foss import Workbook

workbook = Workbook()
worksheet = workbook.worksheets[0]
worksheet.cells["A1"].value = "Confidential Data"

# Save with password protection
workbook.save("protected.xlsx", password="mypassword")

# Open a password-protected file
workbook2 = Workbook("protected.xlsx", password="mypassword")

공개 API

ImageRenderOptions Cells 클래스는 A1 스타일 표기법(e.g.,)을 사용하여 개별 셀에 접근할 수 있습니다., "A1") 또는 1 기반 행/열 튜플 인덱스. The Cell 클래스는 단일 셀을 나타내며 노출합니다 value, formula, 및 style 읽기/쓰기 속성으로 사용할 수 있습니다. 셀 병합 및 병합 해제는 다음을 통해 지원됩니다 merge() 및 unmerge() 메서드 on Cells.

from aspose.cells_foss import Workbook

workbook = Workbook()
worksheet = workbook.worksheets[0]
worksheet.cells["A1"].value = "Hello"
worksheet.cells["B1"].value = "World"    # A1 notation preferred
workbook.save("output.xlsx")
ImageRenderOptionsImageRenderOptionsImageRenderOptions
Workbookworkbook루트 workbook 객체
Worksheetworksheet셀, 차트, 도형이 포함된 단일 worksheet
Cells셀A1 및 1 기반 (row, col) 접근 방식을 지원하는 셀 컬렉션
Cell셀단일 셀: 값, 수식, 스타일
Style스타일셀 서식: 글꼴, 채우기, 테두리, 정렬
Chart차트삽입 차트
DataValidation데이터 검증셀 범위 검증 규칙
CSVHandlerCSV 핸들러CSV 가져오기/내보내기
MarkdownHandlerMarkdown 핸들러Markdown 내보내기
JsonHandlerJSON 핸들러JSON 내보내기
Shape도형도형 또는 텍스트 상자 그리기
Table표Excel 구조화된 표
SparklineGroup스파크라인스파크라인 차트
HorizontalPageBreakCollection페이지 나누기수동 페이지 나누기
AgileEncryptionParameters암호화AES 암호화 매개변수
SaveFormat워크북출력 형식 열거형

공통 패턴 

# Styling a cell
cell = ws.cells["A1"]
cell.style.font.bold = True
cell.style.font.size = 14
cell.style.font.color = "FF0000"             # red (RRGGBB, no #)
cell.style.set_horizontal_alignment("center")
cell.style.set_number_format("#,##0.00")
cell.style.set_border("bottom", line_style="thin")
# Add a dropdown validation
from aspose.cells_foss import DataValidationType

dv = ws.data_validations.add("B1:B10")
dv.type = DataValidationType.LIST
dv.formula1 = '"Red,Green,Blue"'
dv.show_dropdown = True

참고

 한국어