(转)4.2从QTableWidget继承（Subclassing QTableWidget）

最新推荐文章于 2023-10-25 16:34:52 发布

进击的横打

最新推荐文章于 2023-10-25 16:34:52 发布

阅读量3.1k

点赞数

分类专栏： Qt 文章标签： spreadsheet inheritance qt signal 网格存储

Qt 专栏收录该内容

32 篇文章 2 订阅

订阅专栏

类Spreadsheet从QTableWidget继承。QTableWidget是一个表示二维离散数组的表格。它在给定维度里显示当前用户滚动的单元格。当用户在一个空的单元格中输入一些文本时，QTableWidget自动创建一个QTableWidgetItem对象保存输入的文本。

现在我们来实现这个类，首先是头文件spreadsheet.h，首先前向声明两个类Cell和SpreadsheetCompare。

  
  
   
   
    
    #ifndef SPREADSHEET_H

    
    #define
    
     SPREADSHEET_H
    
    
#include 
    
    <
    
    QTableWidget
    
    >
    
    

    
    class
    
     Cell;

    
    class
    
     SpreadsheetCompare;

    
    class
    
     Spreadsheet : 
    
    public
    
     QTableWidget
{
    Q_OBJECT

    
    public
    
    :
    Spreadsheet(QWidget 
    
    *
    
    parent 
    
    =
    
     
    
    0
    
    );
    
    
    bool
    
     autoRecalculate() 
    
    const
    
     { 
    
    return
    
     autoRecalc; }
    
    //
    
    内联函数
    
    

    
        QString currentLocation() 
    
    const
    
    ;
    QString currentFormula() 
    
    const
    
    ;
    QTableWidgetSelectionRange selectedRange() 
    
    const
    
    ;
    
    
    void
    
     clear();
    
    
    bool
    
     readFile(
    
    const
    
     QString 
    
    &
    
    fileName);
    
    
    bool
    
     writeFile(
    
    const
    
     QString 
    
    &
    
    fileName);
    
    
    void
    
     sort(
    
    const
    
     SpreadsheetCompare 
    
    &
    
    compare);

    
    public
    
     slots:
    
    
    void
    
     cut();
    
    
    void
    
     copy();
    
    
    void
    
     paste();
    
    
    void
    
     del();
    
    
    void
    
     selectCurrentRow();
    
    
    void
    
     selectCurrentColumn();
    
    
    void
    
     recalculate();
    
    
    void
    
     setAutoRecalculate(
    
    bool
    
     recalc);
    
    
    void
    
     findNext(
    
    const
    
     QString 
    
    &
    
    str, Qt::CaseSensitivity cs);
    
    
    void
    
     findPrevious(
    
    const
    
     QString 
    
    &
    
    str, Qt::CaseSensitivity cs);
signals:
    
    
    void
    
     modified();

    
    private
    
     slots:
    
    
    void
    
     somethingChanged();

    
    private
    
    :
    
    
    enum
    
     { MagicNumber 
    
    =
    
     
    
    0x7F51C883
    
    , RowCount 
    
    =
    
     
    
    999
    
    , ColumnCount 
    
    =
    
     
    
    26
    
     };
    Cell 
    
    *
    
    cell(
    
    int
    
     row, 
    
    int
    
     column) 
    
    const
    
    ;
    QString text(
    
    int
    
     row, 
    
    int
    
     column) 
    
    const
    
    ;
    QString formula(
    
    int
    
     row, 
    
    int
    
     column) 
    
    const
    
    ;
    
    
    void
    
     setFormula(
    
    int
    
     row, 
    
    int
    
     column, 
    
    const
    
     QString 
    
    &
    
    formula);
    
    
    bool
    
     autoRecalc;
};

    
    class
    
     SpreadsheetCompare
{

    
    public
    
    :
    
    
    bool
    
     
    
    operator
    
    ()(
    
    const
    
     QStringList 
    
    &
    
    row1,
                    
    
    const
    
     QStringList 
    
    &
    
    row2) 
    
    const
    
    ;
    
    
    enum
    
     { KeyCount 
    
    =
    
     
    
    3
    
     };
    
    
    int
    
     keys[KeyCount];
    
    
    bool
    
     ascending[KeyCount];
};

    
    #endif

Figure 4.1. Inheritance trees for Spreadsheet and Cell

文本，对齐等这个QTableWidget单元格的属性存储在QTableWidgetItem类里。QTableWidgetItem类不是一个控件类，而是一个单纯保存数据的类。类Cell从QTableWidgetItem继承的，将在下一节介绍。

在第三章我们实现MainWindow类的时候我们用到了Spreadsheet的一些公有函数。如在MainWindow::newFile中调用clear()将表格置空。我们也用到了QTableWidget继承来的一些函数，如setCurrentCell()和setShowGrid()就多次调用过。

Spreadsheet提供了很多槽函数来相应Edit，Tools和Options等菜单的动作。信号modified()在表格发生变化时给出通知。

私有槽函数somethingChanged()在Speadsheet类内部使用。

在类的私有部分，我们声明了三个常数，四个函数和一个变量。

在头文件的最后定义了类SpreadsheetCompare

现在我们看一下源文件 spreadsheet.cpp ：

#include < QtGui >
#include " cell.h "
#include " spreadsheet.h "
Spreadsheet::Spreadsheet(QWidget * parent)
    : QTableWidget(parent)
{
    autoRecalc = true ;
    setItemPrototype( new Cell);
    setSelectionMode(ContiguousSelection);
    connect( this , SIGNAL(itemChanged(QTableWidgetItem * )),
             this , SLOT(somethingChanged()));
    clear();
}
void Spreadsheet::clear()
{
    setRowCount( 0 );
    setColumnCount( 0 );
    setRowCount(RowCount);
    setColumnCount(ColumnCount);
     for ( int i = 0 ; i < ColumnCount; ++ i) {
        QTableWidgetItem * item = new QTableWidgetItem;
        item -> setText(QString(QChar( ' A ' + i)));
        setHorizontalHeaderItem(i, item);
    }
    setCurrentCell( 0 , 0 );
}
Cell * Spreadsheet::cell( int row, int column) const
{
     return static_cast < Cell *> (item(row, column));
}
QString Spreadsheet::text( int row, int column) const
{
    Cell * c = cell(row, column);
     if (c) {
         return c -> text();
    } else {
         return "" ;
    }
}
QString Spreadsheet::formula( int row, int column) const
{
    Cell * c = cell(row, column);
     if (c) {
         return c -> formula();
    } else {
         return "" ;
    }
}
void Spreadsheet::setFormula( int row, int column,
                              const QString & formula)
{
    Cell * c = cell(row, column);
     if ( ! c) {
        c = new Cell;
        setItem(row, column, c);
    }
    c -> setFormula(formula);
}
QString Spreadsheet::currentLocation() const
{
     return QChar( ' A ' + currentColumn())
            + QString::number(currentRow() + 1 );
}
QString Spreadsheet::currentFormula() const
{
     return formula(currentRow(), currentColumn());
}
void Spreadsheet::somethingChanged()
{
     if (autoRecalc)
        recalculate();
    emit modified();
}

通常，用户在一个空的单元格中输入文本时， QTableWidget 将会自动创建 QTableWidgetItem 对象来保存这些文本。然而在 spreadsheet 程序中，我们通过创建 Cell 代替 QTableWidgetItem 。在构造函数中，通过调用 setItemProtoType()来实现。实际上是每次当需要创建一个新的项目时， QTableWidget 拷贝传递给 setItemProtoType() 函数中的项目。

在构造函数中，我们设置选择方式 QAbstractItemView::ContiguousSelection允许单一的矩形选择。连接表格控件的信号 itemChanged() 和私有的 somethingChanged() 槽函数，这样当用户编辑了一个单元格时， somethingChanged() 能够被调用。最后，我们调用 clear() 清空表格，设置列标头。

在构造函数中调用 clear() 用来初始化表格。在 MainWindow::newFile() 中也调用了这个函数。本来可以使用函数 QTableWidget::clear() 清除所有项和选择，但这样不能改变当前大小的标题头。因此我们首先把表格重新定义为 0 × 0 ，这样全部清除了表格和标题头。然后把表格重新定义为 ColumnCount × RowCount （ 26 × 999 ），让水平标题头为 QTableWidgetItem 类型，文本为 " A " 到 " Z " 。垂直标题栏会自动设置为 1 ， 2 ，到 999 。最后把光标移动到 A1 。

QTableWidget 由几个子控件组成。它在最上面有一个水平的 QHeaderView ，最左边有一个垂直的 QHeaderView 和两个 QScrollBars 。中间区域是一个特殊的 viewport 控件，这个控件可以显示网格。这些子控件可以通过 QTableView 和 QAbstractScrollArea 的函数进行操作。 QAbstractScrollArea 提供了一个可以滚动的 viewport 和两个滚动条。它的子类 QScrollArea 会在第六章介绍到。

Figure 4.2. QTableWidget 's constituent widgets

************************************

在 Items 中保存数据：

在 Spreadsheet 应用程序中，每一个非空的单元格都作为一个独立的 QTableWidgetItem 对象被存放在内存中。这种在 Item 中保存数据的方法被 QListWidget 和 QTreeWidget 所采用，对应这两个控件的 Item 类分别为 QListWidgetItem 和 QTreeWidgetItem 。

Qt 的 Item 类还可以作为数据存储器使用。比如， QTableWidgetItem 也保存了一些属性如文本，字体，颜色，图标等，还有一个指向 QTableWidget 的指针。这个 Item 还可以保存 QVariant 类型的数据，包括注册的自定义类型。从这个类派生子类，我们还可以提供其他功能。

其他的工具是在它们的 item 类中提供一个空指针来保存用户数据。在 Qt 中更加好用的方法是使用 setData() ，把 QVariant 类型的数据保存起来。如果需要一个空类型指针，也可以从 item 类派生，在派生类中添加一个空类型指针成员变量。

对于那些更为复杂的数据处理，如大量的数据，复杂的数据项，数据库数据和多种数据显示方式， Qt 提供了一套 model/view 类将数据和显示分离出来，第十章介绍了这个特性。

**************************************************************

私有函数 cell() 返回指定的行数和列数的 Cell 对象。它和 QTableWidget::item() 是一样的，只是它返回的是 Cell 类型的指针， QTableWidget::item() 返回的是 QTableWidgetItem 类型的指针。

私有函数 text() 返回指定的单元格的文本。如果 cell() 返回空指针，该单元格为空，则返回空字符。

函数 formula() 返回的是单元格的公式。大多数情况下，单元格的公式和文本是一样的。例如，公式 " hello " 和字符 " hello " 是一样的，如果用户输入了 " hello " ，网格的文本就显示为 hello 。但是下面会是例外：

1 、如果公式是一个数字，那么单元格的文本也是数字。

2 、如果公式是单引号开头，公式的其他部分就是文本。如公式 '12345 ，等价于串就是 " 12345 " 。

3 、如果公式由等号 " = " 开头，代表一个数学公式。如果 A1 为 12 ， A2 为 6 ，那么公式 " =A1+A2 " 就是 18 。

把公式转换为值的任务是由类 Cell 完成的。此时需要记住的是单元格中显示的文本是经过公式计算的结果，而不是公式本身。

私有函数 setFormula() 用来给一个指定的单元格设置公式。如果该单元格有 Cell 对象，那就使用这个对象。否则，我们创建一个新的 Cell 对象，然后我们调用 QTableWidget::setItem() 函数把它插入到表格中，最后调用单元格自己的setFormula()函数，在单元格上显示公式结果。我们不用删除 Cell 对象，在适当的时候， QTableWidget 会自动删除这些对象。

函数 currentLocation() 返回当前单元格的位置，字母显示的列和行号，被 MainWindow::updateStatusBar() 调用在状态条上显示位置。

函数 currentFormula() 返回当前单元格的公式。 MainWindow::updateStatusBar() 调用了这个函数。

私有槽函数 somethingChanged() 中，如果 auto-recalculate 为真，那么重新计算整个表格。然后发送 modified() 信号。