tcmsexcel.h

// **************************************************************************
// Tianchi C++ library for Qt (open source)
// 天池共享源码库
// 版权所有 (C) 天池共享源码库开发组
// 授权协议：请阅读天池共享源码库附带的授权协议
// **************************************************************************
// 文档说明：通过 OLE 方式操作 Microsoft Excel（仅限 Windows 下使用，要求已安
//           装 Excel）
// ==========================================================================
// 开发日志：
// 日期         人员        说明
// --------------------------------------------------------------------------
// 2013.04.10   圣域天子    建立
//
// ==========================================================================
//                  要求已安装 Excel）
// ==========================================================================
#ifndef TIANCHI_TCMSEXCEL_H
#define TIANCHI_TCMSEXCEL_H

#include <tianchi/tcglobal.h>

#include <QString>
#include <QStringList>
#include <QVariant>

class TcMSExcelPrivate;

class TIANCHI_API TcMSExcel
{
public:
    TcMSExcel();
    virtual ~TcMSExcel();

private:
    Q_DISABLE_COPY(TcMSExcel)
    Q_DECLARE_PRIVATE(TcMSExcel)
    TcMSExcelPrivate* const d_ptr;

public:
    enum Alignment
    {
        xlTop    = -4160, 
        xlLeft   = -4131, 
        xlRight  = -4152, 
        xlCenter = -4108, 
        xlBottom = -4107  
    };

    bool create(const QString& filename = QString());
    bool open(const QString& filename = QString());
    void save(const QString& filename = QString());
    void close();
    void kick();

    void setVisible(bool value);
    void setCaption(const QString& value);

    bool addBook();

    int sheetCount();

    QStringList sheetNames();

    bool currentSheet();

    bool setCurrentSheet(int index);

    QString currentSheetName();

    QVariant read(int row, int col);

    inline QVariant cell(int row, int col) { return read(row, col); }

    void write(int row, int col, const QVariant& value);

    void cellFormat(int row, int col, const QString& format);
    void cellAlign(int row, int col, Alignment hAlign, Alignment vAlign);

    bool usedRange(int& rowStart, int& colStart, int &rowEnd, int &colEnd);
};

#endif // TIANCHI_MSEXCEL_H