mirror of
https://github.com/tfussell/xlnt.git
synced 2024-03-22 13:11:17 +08:00
80 lines
5.8 KiB
Markdown
80 lines
5.8 KiB
Markdown
|
|
||
|
|
# Introduction
|
||
|
|
|
||
|
|
```c++
|
||
|
|
#include <xlnt/xlnt.hpp>
|
||
|
|
|
||
|
|
int main()
|
||
|
|
{
|
||
|
|
xlnt::workbook wb;
|
||
|
|
xlnt::worksheet ws = wb.active_sheet();
|
||
|
|
ws.cell("A1").value(5);
|
||
|
|
ws.cell("B2").value("string data");
|
||
|
|
ws.cell("C3").formula("=RAND()");
|
||
|
|
ws.merge_cells("C3:C4");
|
||
|
|
ws.freeze_panes("B2");
|
||
|
|
wb.save("xlnt.xlsx");
|
||
|
|
return 0;
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
xlnt is a C++14 library for reading, writing, and modifying XLSX files as described in [ECMA 376](http://www.ecma-international.org/publications/standards/Ecma-376.htm). The API is based on [openpyxl](https://bitbucket.org/openpyxl/openpyxl), a Python library to read/write Excel 2007 xlsx/xlsm files, and ultimately on [PHPExcel](https://github.com/PHPOffice/PHPExcel), pure PHP library for reading and writing spreadsheet files upon which openpyxl was based. This project is still very much a work in progress, but the core development work is complete.
|
||
|
|
|
||
|
|
## Features
|
||
|
|
|
||
|
|
| Feature | Read | Edit | Write |
|
||
|
|
|---------------------------------------------------------------------|------|------|-------|
|
||
|
|
| Excel-style Workbook | ✓ | ✓ | ✓ |
|
||
|
|
| LibreOffice-style Workbook | ✓ | ✓ | ✓ |
|
||
|
|
| Numbers-style Workbook | ✓ | ✓ | ✓ |
|
||
|
|
| Encrypted Workbook (Excel 2007-2010) | ✓ | ✓ | |
|
||
|
|
| Encrypted Workbook (Excel 2013-2016) | ✓ | ✓ | |
|
||
|
|
| Excel Binary Workbook (.xlsb) | | | |
|
||
|
|
| Excel Macro-Enabled Workbook (.xlsm) | | | |
|
||
|
|
| Excel Macro-Enabled Template (.xltm) | | | |
|
||
|
|
| Document Properties | ✓ | ✓ | ✓ |
|
||
|
|
| Numeric Cell Values | ✓ | ✓ | ✓ |
|
||
|
|
| Inline String Cell Values | ✓ | ✓ | ✓ |
|
||
|
|
| Shared String Cell Values | ✓ | ✓ | ✓ |
|
||
|
|
| Shared String Text Run Formatting (e.g. varied fonts within a cell) | ✓ | ✓ | ✓ |
|
||
|
|
| Hyperlink Cell Values | | | |
|
||
|
|
| Formula Cell Values | | | |
|
||
|
|
| Formula Evaluation | | | |
|
||
|
|
| Page Margins | ✓ | ✓ | ✓ |
|
||
|
|
| Page Setup | | | |
|
||
|
|
| Print Area | | | |
|
||
|
|
| Comments | ✓ | ✓ | |
|
||
|
|
| Header and Footer | | | |
|
||
|
|
| Custom Views | | | |
|
||
|
|
| Charts | | | |
|
||
|
|
| Chartsheets | | | |
|
||
|
|
| Dialogsheets | | | |
|
||
|
|
| Themes | ✓ | | ✓ |
|
||
|
|
| Cell Styles | ✓ | ✓ | ✓ |
|
||
|
|
| Cell Formats | ✓ | ✓ | ✓ |
|
||
|
|
| Formatting->Alignment (e.g. right align) | ✓ | ✓ | ✓ |
|
||
|
|
| Formatting->Border (e.g. red cell outline) | ✓ | ✓ | ✓ |
|
||
|
|
| Formatting->Fill (e.g. green cell background) | ✓ | ✓ | ✓ |
|
||
|
|
| Formatting->Font (e.g. blue cell text) | ✓ | ✓ | ✓ |
|
||
|
|
| Formatting->Number Format (e.g. show 2 decimals) | ✓ | ✓ | ✓ |
|
||
|
|
| Formatting->Protection (e.g. hide formulas) | ✓ | ✓ | ✓ |
|
||
|
|
| Column Styles | | | |
|
||
|
|
| Row Styles | | | |
|
||
|
|
| Sheet Styles | | | |
|
||
|
|
| Conditional Formatting | | | |
|
||
|
|
| Tables | | | |
|
||
|
|
| Table Formatting | | | |
|
||
|
|
| Pivot Tables | | | |
|
||
|
|
| XLSX Thumbnail | ✓ | | ✓ |
|
||
|
|
| Custom OOXML Properties | | | |
|
||
|
|
| Custom OOXML Parts | | | |
|
||
|
|
| Drawing | | | |
|
||
|
|
| Text Box | | | |
|
||
|
|
| WordArt | | | |
|
||
|
|
| Embedded Content (e.g. images) | | | |
|
||
|
|
| Excel VBA | | | |
|
||
|
|
|
||
|
|
## Performance
|
||
|
|
|
||
|
|
Creates a new workbook and writes 1 million cells to a file in X seconds using a fully optimized build on Windows 10 with MSVC 2015.
|