=> Главная База Знаний Qt Создание подкласса qtablewidget


Создание подкласса qtablewidget

Создание подкласса qtablewidget

Класс Spreadsheet наследует QTableWidget. Виджет QTableWidget фактически является сеткой, представляющей собой двумерный разряженный массив. На нем отображается часть ячеек всей сетки, полученная при прокрутке изображения пользователем. При вводе пользователем текста в пустую ячейку QTableWidget автоматически создает элемент QTableWidgetItem для хранения текста.

Давайте начнем с реализации виджета и сначала приведем заголовочный файл:

01 #ifndef SPREADSHEET_H

02 #define SPREADSHEET_H

03 #include <QTableWidget>

04 class Cell;

05 class SpreadsheetCompare;

Заголовочный файл начинается с предварительных объявлений классов Cell и SpreadsheetCompare.

Рис. 4.1. Деревья наследования для классов Spreadsheet и Cell.

Такие атрибуты ячейки QTableWidget, как ее текст и выравнивание, хранятся в QTableWidgetltem. В отличие от QTableWidget, класс QTableWidgetltem не является виджетом; это обычный класс данных. Класс Cell наследует QTableWidgetltem, и мы рассмотрим этот класс в последнем разделе данной главы, где представим его реализацию.

06 class Spreadsheet : public QTableWidget

07 {

08 Q_OBJECT

09 public:

10 Spreadsheet(QWidget *parent = 0);

11 bool autoRecalculate() const { return autoRecalc; }

12 QString currentLocation() const;

13 QString currentFormula() const;

14 QTableWidgetSelectionRange selectedRange() const;

15 void clear();

16 bool readFile(const QString &fileName);

17 bool writeFile(const QString &fileName);

18 void sort(const SpreadsheetCompare &compare);

Функция autoRecalculate() реализуется как встроенная (inline), поскольку она лишь показывает, задействован или нет режим автоматического перерасчета.

В главе 3 мы опирались на использование некоторых открытых функций класса электронной таблицы Spreadsheet при реализации MainWindow Например, из MainWindow::newFile() мы вызывали функцию clear() для очистки электронной таблицы. Кроме того, мы вызывали некоторые функции, унаследованные от QTableWidget, а именно setCurrentCell() и setShowGrid().

19 public slots:

20 void cut();

21 void copy();

22 void paste();

23 void del();

24 void selectCurrentRow();

25 void selectCurrentColumn();

26 void recalculate();

27 void setAutoRecalculate(bool recalc);

28 void findNext(const QString &str, Qt::CaseSensitivity cs);

29 void findPrevious(const QString &str, Qt::CaseSensitivity cs);

30 signals:

31 void modified();

Класс Spreadsheet содержит много слотов, которые реализуют действия пунктов меню Edit, Tools и Options, и он содержит один сигал modified() для уведомления о возникновении любого изменения.

32 private slots:

33 void somethingChanged();

Мы определяем один закрытый слот, который используется внутри класса Spreadsheet.

34 private:

35 enum { MagicNumber = 0x7F51C883, RowCount = 999, ColumnCount = 26 };

36 Cell *cell(int row, int column) const;

37 QString text(int row, int column) const;

38 QString formula(int row, int column) const;

39 void setFormula(int row, int column, const QString &formula);

40 bool autoRecalc;

41 };

В закрытой секции этого класса мы объявляем три константы, четыре функции и одну переменную.

42 class SpreadsheetCompare

43 {

44 public:

45 bool operator()(const QStringList &row1, const QStringList &row2) const;

46 enum { KeyCount = 3 };

47 int keys[KeyCount];

48 bool ascending[KeyCount];

49 };

50 #endif

Заголовочный файл заканчивается определением класса SpreadsheetCompare. Мы объясним назначение этого класса при рассмотрении функции Spreadsheet::sort().

Теперь мы рассмотрим реализацию:

01 #include <QtGui>

02 #include "cell.h"

03 #include "spreadsheet.h"

04 Spreadsheet::Spreadsheet(QWidget *parent)

05 : QTableWidget(parent)

06 {

07 autoRecalc = true;

08 setItemPrototype(new Cell);

09 setSelectionMode(ContiguousSelection);

10 connect(this, SIGNAL(itemChanged(QTableWidgetItem *)),

11 this, SLOT(somethingChanged()));

12 clear();

13 }

Обычно при вводе пользователем некоторого текста в пустую ячейку QTableWidget будет автоматически создавать элемент QTableWidgetltem для хранения этого текста. Вместо этого мы хотим, чтобы создавались элементы Cell. Это достигается с помощью вызова в конструкторе функции setItemPrototype(). Всякий раз, когда требуется новый элемент, QTableWidget дублирует элемент, переданный в качестве прототипа.

Кроме того, в конструкторе мы устанавливаем режим выделения области на значение QAbstractItemView::ContiguousSelection, чтобы могла быть выделена только одна прямоугольная область. Мы соединяем сигнал itemChanged() виджета таблицы с закрытым слотом somethingChanged(); это гарантирует вызов слота somethingChanged() при редактировании ячейки пользователем. Наконец, мы вызываем clear() для изменения размеров таблицы и задания заголовков столбцов.

14 void Spreadsheet::clear()

15 {

16 setRowCount(0);

17 setColumnCount(0);

18 setRowCount(RowCount);

19 setColumnCount(ColumnCount);

20 for (int i = 0; i < ColumnCount; ++i) {

21 QTableWidgetltem *item = new QTableWidgetltem;

22 item->setText(QString(QChar('A' + i)));

23 setHorizontalHeaderItem(i, item);

24 }

25 setCurrentCell(0, 0);

26 }

Функция clear() вызывается из конструктора Spreadsheet для инициализации электронной таблицы. Она также вызывается из MainWindow::newFile().

Мы могли бы использовать QTableWidget::clear() для очистки всех элементов и любых выделений, но в этом случае заголовки имели бы текущий размер. Вместо этого мы уменьшаем размер электронной таблицы до 0 × 0. Это приводит к очистке всей электронной таблицы, включая заголовки. Затем мы опять устанавливаем ее размер на ColumnCount × RowCount (26 × 999) и заполняем строку горизонтального заголовка элементами QTableWidgetltem, содержащими обозначения столбцов. Нам не надо задавать метки строк, потому что по умолчанию строки обозначаются как «1», «2», … «26». В конце мы перемещаем курсор на ячейку A1.

Рис. 4.2. Виджеты, составляющие QTableWidget.

QTableWidget содержит несколько дочерних виджетов. Сверху располагается горизонтальный заголовок QHeaderView, слева — вертикальный заголовок QHeaderView и две полосы прокрутки QScrollBar. В центральной области размещается специальный виджет, называемый областью отображения (viewport), в котором QTableWidget вычерчивает ячейки. Доступ к различным дочерним виджетам осуществляется с помощью функций, унаследованных от QTableView и QAbstractScrollArea (рис. 4.2). QAbstractScrollArea содержит перемещаемую область отображения и две полосы прокрутки, которые могут включаться и отключаться. Подкласс QScrollArea рассматривается в главе 6.

В приложении Электронная таблица каждая непустая ячейка хранится в памяти в виде одного объекта QTableWidgetltem (элемент табличного виджета). Хранение данных в объектах типа «элемент» используется также виджетами QListWidget и QTreeWidget, которые работают с объектами QListWidgetItem и QTreeWidgetItem.

В Qt классы элементов могут использоваться вне таблиц как самостоятельные структуры данных. Например, QTableWidgetltem уже содержит некоторые атрибуты, в том числе строку, шрифт, цвет и пиктограмму, а также обратный указатель на QTableWidget. Такие элементы могут содержать также данные типа QVariant, включая зарегистрированные пользовательские типы, и, создавая подкласс такого элемента, можно обеспечить дополнительную функциональность.

Другие инструментальные средства предусматривают наличие в классах элементов указателя типа void для хранения пользовательских данных. В Qt используется более естественный подход с применением setData() для типа QVariant, однако если требуется иметь указатель void, это можно сделать просто путем создания подкласса для класса элемента, который будет содержать переменную—указатель на член типа void.

Для данных, к которым предъявляются повышенные требования, например для больших наборов данных, для сложных элементов данных, для интеграции баз данных и для множественных представлений данных, Qt предоставляет набор классов «модель/представление», в которых данные отделены от их визуального представления. Эти классы рассматриваются в главе 10.

01 Cell *Spreadsheet::cell(int row, int column) const

02 {

03 return static_cast<Cell *>(item(row, column));

04 }

Закрытая функция cell() возвращает для заданной строки и столбца объект Cell. Она работает почти так же, как QTableWidget::item(), но возвращает указатель на Cell, а не указатель на QTableWidgetltem.

01 QString Spreadsheet::text(int row, int column) const

02 {

03 Cell *c = cell(row, column);

04 if (с) {

05 return c->text();

06 } else {

07 return "";

08 }

09 }

Закрытая функция text() возвращает формулу заданной ячейки. Если cell() возвращает нулевой указатель, то это означает, что ячейка пустая, и поэтому мы возвращаем пустую строку.

01 QString Spreadsheet::formula(int row, int column) const

02 {

03 Cell *c = cell(row, column);

04 if (с) {

05 return c->formula();

06 } else {

07 return "";

08 }

09 }

Функция formula() возвращает формулу ячейки. Во многих случаях формула и текст совпадают; например формула «Hello» соответствует строке «Hello», поэтому при вводе пользователем в ячейку строки «Hello» и нажатии клавиши Enter в ячейке отобразится текст «Hello». Но имеется несколько исключений:

• Если формула представлена числом, именно оно и будет отображаться. Например, формула «1.50» обозначает значение 1.5 типа double, которое отображается в электронной таблице как выровненное вправо значение «1.5».

• Если формула начинается с одиночной кавычки, остальная часть формулы интерпретируется как текст. Например, результатом формулы «'12345» будет строка «12345».

• Если формула начинается со знака равенства («=»), то ее значение интерпретируется как арифметическое выражение. Например, если ячейка A1 содержит «12» и ячейка A2 содержит «6», то результатом формулы «=A1+A2» будет 18. Задача преобразования формулы в значение выполняется классом Cell. Здесь следует иметь в виду, что отображаемый в ячейке текст соответствует значению, полученному в результате расчета формулы, а не является текстом самой формулы.

01 void Spreadsheet::setFormula(int row, int column,
const QString &formula)

02 {

03 Cell *c = cell(row, column);

04 if (!c) {

05 с = new Cell;

06 setItem(row, column, с);

07 }

08 c->setFormula(formula);

09 }

Закрытая функция setFormula() задает формулу для указанной ячейки. Если ячейка уже имеет объект Cell, мы его повторно используем. В противном случае мы создаем новый объект Cell и вызываем QTableWidget::setItem() для вставки его в таблицу. В конце мы вызываем для этой ячейки функцию setFormula(), что приводит к перерисовке ячейки, если она отображается на экране. Нам не надо беспокоиться об удалении в будущем объекта Cell; QTableWidget является собственником ячейки и будет автоматически удалять ее содержимое в нужное время.

01 QString Spreadsheet::currentLocation() const

02 {

03 return QChar('A' + currentColumn())

04 + QString::number(currentRow() + 1);

05 }

Функция currentLocation() возвращает текущее положение ячейки, используя обычную форму представления ее координат в электронной таблице с обозначением буквой положения столбца, за которой идет номер строки. Функция MainWindow::updateStatusBar() использует ее для отображения положения ячейки в строке состояния.

01 QString Spreadsheet::currentFormula() const

02 {

03 return formula(currentRow(), currentColumn());

04 }

Функция currentFormula() возвращает формулу текущей ячейки. Она вызывается из функции MainWindow::updateStatusBar().

01 void Spreadsheet::somethingChanged()

02 {

03 if (autoRecalc)

04 recalculate();

05 emit modified();

06 }

Закрытый слот somethingChanged() делает перерасчет всей электронной таблицы, если включен режим Auto—Recalculate (автоматический пересчет). Он также генерирует сигнал modified().