Features
Funkcje
Aspose.Cells FOSS for C++ to biblioteka open-source w C++ umożliwiająca tworzenie, wczytywanie, edytowanie i zapisywanie skoroszytów Excel .xlsx bez konieczności posiadania Microsoft Excel. Biblioteka udostępnia nagłówkowo-jednostkowy C++ API zorganizowany wokół małego zestawu klas podstawowych.
Zarządzanie skoroszytem i arkuszami
Klasa Workbook jest obiektem głównym dla wszystkich operacji na arkuszach kalkulacyjnych. Użyj jej do utworzenia nowego skoroszytu, wczytania istniejącego pliku XLSX lub zapisania zmian na dysku.
- Utwórz nowy skoroszyt z wykorzystaniem
Workbook() - Wczytaj plik XLSX przy pomocy
Workbook(filePath) - Zapisz do pliku za pomocą
Workbook::Save(fileName) - Dostęp do wszystkich arkuszy poprzez
Workbook::GetWorksheets() - Dodawaj, zmieniaj nazwę i konfigurować arkusze przy użyciu klasy
Worksheet
Wartości komórek i formuły
Klasa Cell reprezentuje pojedynczą komórkę arkusza kalkulacyjnego. Obsługuje odczyt i zapis tekstu, wartości liczbowych, logicznych oraz formuł.
- Zapisz wartości przy użyciu
Cell::PutValue(value)iCell::SetValue(value) - Odczytaj wartości przy użyciu
Cell::GetValue(), zwracająceCellValue - Ustaw formuły przy użyciu
Cell::SetFormula(formula)— standardowa składnia formuł Excel - Odwołuj się do komórek po nazwie (
"A1") lub po indeksie wiersza/kolumny za pomocąCells::operator[](cellName)
Stylowanie komórek
Zastosuj bogate formatowanie komórek przy użyciu klasy Style. Pobierz bieżący styl z Cell::GetStyle(), zmodyfikuj go i zastosuj ponownie za pomocą Cell::SetStyle(style).
- Konfiguracja czcionki przez
Style::Font()zwracająca obiektFont— pogrubienie, kolor, rozmiar - Wzory wypełnienia tła przy użyciu
Style::SetPattern(FillPattern)iStyle::SetForegroundColor(Color) - Konfiguracja obramowań przy pomocy
Style::Borders() - Ciągi formatów liczb za pośrednictwem
Style::SetNumberFormat(format)
Ustawienia strony i układ wydruku
Klasa PageSetup umożliwia konfigurowanie ustawień drukowania arkusza, takich jak rozmiar papieru, orientacja, marginesy, skalowanie oraz tekst nagłówka i stopki.
- Ustaw rozmiar papieru za pomocą
PageSetup::SetPaperSize(PaperSizeType) - Ustaw orientację wydruku za pomocą
PageSetup::SetOrientation(PageOrientationType) - Skonfiguruj marginesy:
PageSetup::SetTopMargin,SetBottomMargin,SetLeftMargin,SetRightMargin - Skalowanie dopasowane do strony za pomocą
PageSetup::SetFitToPagesTalliSetFitToPagesWide
Formatowanie warunkowe
Klasa ConditionalFormattingCollection zarządza formatowaniem komórek opartym na regułach. Reguły można dodawać do zakresów arkusza, a priorytet może być zarządzany automatycznie.
- Dodaj reguły za pomocą
ConditionalFormattingCollection::Add() - Usuń reguły według indeksu lub obszaru
- Uzyskaj następny dostępny priorytet przy użyciu
ConditionalFormattingCollection::GetNextPriority()
Auto-filtr
Klasa AutoFilter obsługuje stosowanie filtrów danych na poziomie kolumn do zakresów arkusza.
- Ustaw zakres filtru przy użyciu
AutoFilter::SetRange(rangeAddress) - Wyczyść wszystkie aktywne filtry przy użyciu
AutoFilter::Clear() - Zarządzaj filtrami niestandardowymi za pośrednictwem
AutoFilterCustomFilteriAutoFilterCustomFilterCollection
Nazwane zakresy i nazwy zdefiniowane
Klasa DefinedName przechowuje formuły i zakresy nazwane na poziomie skoroszytu lub arkusza, aby móc je ponownie używać w formułach i kodzie.
- Pobierz zdefiniowaną nazwę za pomocą
DefinedName::GetName() - Pobierz lub ustaw formułę (adres zakresu) za pomocą
DefinedName::GetFormula()/SetFormula(formula) - Ustaw zakres na konkretny arkusz za pomocą
DefinedName::GetLocalSheetIndex()
Obsługa formatu XLSX
| Format | Load | Save |
|---|---|---|
| XLSX | ✔ | ✔ |
| CSV | ✔ | — |
Wszystkie operacje wczytywania i zapisywania używają przeciążeń Workbook::Save(fileName). Format jest domyślnie określany na podstawie rozszerzenia pliku.
API Reference Podsumowanie
| Klasa | Opis |
|---|---|
Workbook | Główny obiekt arkusza kalkulacyjnego — tworzyć, wczytywać i zapisywać pliki XLSX |
Worksheet | Pojedynczy arkusz — nazwa, komórki, ustawienia strony i auto-filter |
Cell | Pojedyncza komórka — wartość, formuła i operacje stylu |
Style | Fasada stylu komórki — czcionka, wypełnienie, obramowania i format liczby |
Font | Ustawienia czcionki — pogrubienie, kolor, rozmiar |
PageSetup | Układ wydruku — rozmiar papieru, orientacja, marginesy, skalowanie |
ConditionalFormattingCollection | Zbiór reguł formatowania warunkowego |
AutoFilter | Automatyczny filtr na poziomie kolumny dla zakresu arkusza |
DefinedName | Zakres nazwany lub definicja formuły |