mirror of
https://github.com/QtExcel/QXlsx.git
synced 2025-01-30 05:02:52 +08:00
89 lines
3.6 KiB
Markdown
89 lines
3.6 KiB
Markdown
# QXlsx
|
|
|
|
> *Read this in other languages: [English](README.md), :kr: [한국어](README.ko.md)*
|
|
|
|
<p align="center"><img src="https://github.com/j2doll/QXlsx/raw/master/markdown.data/QXlsx2.jpg"></p>
|
|
|
|
|
|
|
|
- QXlsx is excel file(*.xlsx) reader/writer library.
|
|
- Because QtXlsx is no longer supported(2014), I created a new project that is based on QtXlsx. (2017-)
|
|
- Development language of QXlsx is C++. (with Qt)
|
|
- You don't need to use static library or dynamic shared object using QXlsx.
|
|
|
|
## How to use
|
|
- See examples
|
|
- TestExcel : basic samples based on QtXlsx samples
|
|
- HelloAndroid : read xlsx on Android using QML
|
|
- Copycat : load xlsx file and display on widget. print xlsx file. (TODO: save xlsx)
|
|
|
|
## Example (Hello excel)
|
|
|
|
### :one: Writing excel file(*.xlsx)
|
|
|
|
```cpp
|
|
QXlsx::Document xlsx;
|
|
xlsx.write("A1", "Hello Qt!"); // write "Hello Qt!" to cell(A,1). it's shared string.
|
|
xlsx.saveAs("Test.xlsx"); // save the document as 'Test.xlsx'
|
|
```
|
|
|
|
### :two: Reading excel file(*.xlsx)
|
|
|
|
```cpp
|
|
Document xlsx("Test.xlsx"); // load excel file
|
|
if (!xlsx.isLoadPackage()) {
|
|
return; // failed to load excel
|
|
}
|
|
int row = 1; int col = 2;
|
|
Cell* cell = xlsx.cellAt(row, col); // get cell pointer. (row is 1. column is 2.)
|
|
if ( cell == NULL )
|
|
continue; // cell vaule is not set
|
|
QVariant var = cell->readValue(); // read cell value (number(double), QDateTime, QString ...)
|
|
qDebug() << var; // display value
|
|
```
|
|
|
|
## How to set up
|
|
- See [How to setup QXlsx project](HowToSetProject.md)
|
|
|
|
## Test environment
|
|
|
|
- See [Tested environments](TestEnv.md)
|
|
|
|
## To Test
|
|
- The following tests should be performed.
|
|
- Microsoft Excel, Google Spreadsheet, LibreOffice Calc Spreasheet
|
|
- Unicode test (filename :cloud:, filepath :cloud:, data value :sunny:)
|
|
|
|
## To Upgrade
|
|
- Develop the encryption function of xlsx
|
|
|
|
## License and links
|
|
-  QXlsx is under MIT License. [https://github.com/j2doll/QXlsx](https://github.com/j2doll/QXlsx)
|
|
-  QtXlsx is under MIT License. [https://github.com/dbzhang800/QtXlsxWriter](https://github.com/dbzhang800/QtXlsxWriter)
|
|
- Qt-Table-Printer is under BSD 3-Clause License. [https://github.com/T0ny0/Qt-Table-Printer](https://github.com/T0ny0/Qt-Table-Printer)
|
|
- Qt is under LGPL v3 License or Commercial Lisense. [https://www.qt.io/](https://www.qt.io/)
|
|
|
|
## :email: Contact
|
|
- Hi! I'm j2doll (aka Jay Two). My name is Korean and it is difficult for foreigners to pronounce it. Call me j2doll.
|
|
- Leave me a issue. [https://github.com/j2doll/QXlsx/issues](https://github.com/j2doll/QXlsx/issues)
|
|
- If you are interested in participating in the project, please contact us by issue.
|
|
- My native language is not English and my English is not fluent. Please, use EASY English. :-)
|
|
|
|
## Similar projects
|
|
|
|
### :star: <b>Qxlnt</b> [https://github.com/j2doll/Qxlnt](https://github.com/j2doll/Qxlnt)
|
|
|
|
<p align="center"><img src="https://github.com/j2doll/Qxlnt/raw/master/markdown-data/Concept-QXlnt.jpg"></p>
|
|
|
|
- Qxlnt is a helper project that allows xlnt to be used in Qt.
|
|
- xlnt is a excellent C++ library for using xlsx Excel files. :+1:
|
|
- I was looking for a way to make it easy to use in Qt. Of course, cmake is compatible with Qt, but it is not convenient to use. So I created Qxlnt.
|
|
|
|
### :star: <b>Qlibxlsxwriter</b> [https://github.com/j2doll/Qlibxlsxwriter](https://github.com/j2doll/Qlibxlsxwriter)
|
|
|
|
<p align="center"><img src="https://github.com/j2doll/Qlibxlsxwriter/raw/master/markdown.data/logo.png"></p>
|
|
|
|
- Qlibxlsxwriter is a helper project that allows libxlsxwriter to be used in Qt.
|
|
- libxlsxwriter is a C library for creating Excel XLSX files.
|
|
|