Features

기능

Aspose.Cells FOSS for C++는 Microsoft Excel 없이 Excel .xlsx 워크북을 생성, 로드, 편집 및 저장할 수 있는 오픈 소스 C++ 라이브러리입니다. 이 라이브러리는 소수의 핵심 클래스를 중심으로 구성된 헤더 전용 C++ API을(를) 제공합니다.


워크북 및 워크시트 관리

Workbook 클래스는 모든 스프레드시트 작업의 루트 객체입니다. 이를 사용하여 새 워크북을 만들고, 기존 XLSX 파일을 로드하거나, 변경 사항을 디스크에 저장할 수 있습니다.

  • 새 워크북을 Workbook()로 만들기
  • Workbook(filePath)를 사용하여 XLSX 파일 로드
  • Workbook::Save(fileName)를 사용하여 파일에 저장
  • Workbook::GetWorksheets()를 통해 모든 시트에 접근하세요
  • Worksheet 클래스를 통해 시트를 추가하고, 이름을 바꾸며, 구성합니다

셀 값 및 수식

Cell 클래스는 단일 스프레드시트 셀을 나타냅니다. 텍스트, 숫자, 불리언 및 수식 값을 읽고 쓸 수 있습니다.

  • Cell::PutValue(value)와 Cell::SetValue(value)를 사용하여 값을 씁니다
  • Cell::GetValue()를 사용하여 값을 읽고 CellValue를 반환합니다
  • Cell::SetFormula(formula)를 사용하여 수식을 설정합니다 — 표준 Excel 수식 구문
  • 셀을 이름("A1")이나 행/열 인덱스(Cells::operator[](cellName))를 통해 지정합니다

셀 스타일링

Style 클래스를 사용하여 셀에 풍부한 서식을 적용합니다. 현재 스타일을 Cell::GetStyle()에서 가져와 수정한 뒤 Cell::SetStyle(style)로 다시 적용합니다.

  • Style::Font()를 통해 폰트 구성을 수행하며, Font 객체를 반환합니다 — 굵게, 색상, 크기
  • Style::SetPattern(FillPattern)와 Style::SetForegroundColor(Color)을 사용하여 배경 채우기 패턴을 지정합니다.
  • Style::Borders()를 통해 테두리 구성을 합니다.
  • Style::SetNumberFormat(format)를 사용하여 숫자 형식 문자열을 지정합니다.

페이지 설정 및 인쇄 레이아웃

PageSetup 클래스는 용지 크기, 방향, 여백, 축척, 머리글/바닥글 텍스트 등 워크시트 인쇄 설정을 구성할 수 있게 합니다.

  • PageSetup::SetPaperSize(PaperSizeType) 로 용지 크기를 설정합니다.
  • PageSetup::SetOrientation(PageOrientationType) 로 인쇄 방향을 설정합니다.
  • 여백을 구성합니다: PageSetup::SetTopMargin, SetBottomMargin, SetLeftMargin, SetRightMargin
  • 페이지 맞춤 확대/축소를 PageSetup::SetFitToPagesTall 및 SetFitToPagesWide 로 수행합니다.

조건부 서식

ConditionalFormattingCollection 클래스는 규칙 기반 셀 서식을 관리합니다. 규칙은 워크시트 범위에 추가할 수 있으며 우선순위는 자동으로 관리됩니다.

  • ConditionalFormattingCollection::Add() 로 규칙을 추가합니다.
  • 인덱스 또는 영역으로 규칙을 제거합니다.
  • 다음 사용 가능한 우선순위를 ConditionalFormattingCollection::GetNextPriority()으로 가져옵니다

자동 필터

AutoFilter 클래스는 워크시트 범위에 열 수준 데이터 필터를 적용하는 것을 지원합니다.

  • AutoFilter::SetRange(rangeAddress)으로 필터 범위를 설정합니다
  • AutoFilter::Clear()을 사용하여 모든 활성 필터를 지웁니다
  • AutoFilterCustomFilter와 AutoFilterCustomFilterCollection을 통해 사용자 지정 필터를 관리합니다

이름이 지정된 범위 및 정의된 이름

DefinedName 클래스는 수식 및 코드에서 재사용하기 위해 통합 문서 수준 또는 시트 수준의 이름이 지정된 수식 및 범위를 저장합니다.

  • 정의된 이름을 DefinedName::GetName()로 가져옵니다
  • 수식(범위 주소)을 DefinedName::GetFormula() / SetFormula(formula)으로 가져오거나 설정합니다
  • 특정 시트에 범위를 한정하려면 DefinedName::GetLocalSheetIndex()을 사용합니다

XLSX 형식 지원

형식LoadSave
XLSX✔✔
CSV✔—

모든 로드 및 저장 작업은 Workbook::Save(fileName) 오버로드를 사용합니다. 기본적으로 형식은 파일 확장자를 기반으로 추론됩니다.


API Reference 요약

클래스설명
Workbook루트 스프레드시트 객체 — XLSX 파일을 생성, 로드 및 저장
Worksheet단일 워크시트 — 이름, 셀, 페이지 설정 및 자동 필터
Cell단일 셀 — 값, 수식 및 스타일 작업
Style셀 스타일 파사드 — 폰트, 채우기, 테두리 및 숫자 형식
Font폰트 설정 — 굵게, 색상, 크기
PageSetup인쇄 레이아웃 — 용지 크기, 방향, 여백, 배율
ConditionalFormattingCollection조건부 서식 규칙 모음
AutoFilter워크시트 범위의 열 수준 자동 필터
DefinedName이름이 지정된 범위 또는 수식 정의

참조

 한국어