Класс QTableWidgetItem

Класс QTableWidgetItem предоставляет элемент для использования с классом QTableWidget. Подробнее...

• Список всех членов, включая унаследованные

Типы публичного доступа

Функции публичного доступа

Связанные нечлены

Подробное описание

Элементы таблицы используются для хранения фрагментов информации для виджетов таблиц. Элементы обычно содержат текст, значки или флажки.

Класс QTableWidgetItem — это класс-обёртка, заменяющий класс QTableItem в Qt 3. Он предоставляет элемент для использования с классом QTableWidget.

Элементы верхнего уровня создаются без родителя, а затем вставляются в позицию, задаваемую парой номеров строки и столбца:

    QTableWidgetItem *newItem = new QTableWidgetItem(tr("%1").arg(
        pow(row, column+1)));
    tableWidget->setItem(row, column, newItem);

Каждый элемент может иметь свою кисть фона, которая устанавливается с помощью функции setBackground(). Текущая кисть фона можно найти с помощью background(). Текстовую метку каждого элемента можно отобразить с собственным шрифтом и кистью. Они задаются функциями setFont() и setForeground(), и читаются с помощью font() и foreground().

По умолчанию элементы включены, редактируемы, выбираемы, изменяемы и могут быть использованы как источник операции перетаскивания, так и как целевой объект. Флаги каждого элемента можно изменить, вызвав setFlags() с соответствующим значением (см. Qt::ItemFlags). Элементы, которые можно включать, можно включать и выключать с помощью функции setCheckState(). Соответствующая функция checkState() указывает, отмечен ли элемент в данный момент.

Наследование

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

См. также QTableWidget, Программирование модели/представления, QListWidgetItem и QTreeWidgetItem.

Документация по типам членов

перечисление QTableWidgetItem::ItemType

Это перечисление описывает типы, используемые для описания элементов виджетов таблицы.

Вы можете определять новые пользовательские типы в подклассах QTableWidgetItem, чтобы гарантировать, что пользовательские элементы обрабатываются особым образом.

См. также type().

Документация по функциям-членам

QTableWidgetItem::QTableWidgetItem(const QTableWidgetItem &other)

Создает копию other. Обратите внимание, что type() и tableWidget() не копируются.

Эта функция полезна при переопределении clone().

См. также data() и flags().

QTableWidgetItem::QTableWidgetItem(const QIcon &icon, const QString &text, int type = Type)

Создает элемент таблицы с заданным icon и text.

См. также type().

QTableWidgetItem::QTableWidgetItem(const QString &text, int type = Type)

Создает элемент таблицы с заданным text.

См. также type().

QTableWidgetItem::QTableWidgetItem(int type = Type)

Создает элемент таблицы заданного type, который не принадлежит никакой таблице.

См. также type().

QTableWidgetItem &QTableWidgetItem::operator=(const QTableWidgetItem &other)

Присваивает данные и флаги other данному элементу. Обратите внимание, что type() и tableWidget() не копируются.

Эта функция полезна при переопределении clone().

См. также data() и flags().

[virtual] QTableWidgetItem::~QTableWidgetItem()

Уничтожает элемент таблицы.

QBrush QTableWidgetItem::background() const

Возвращает кисть, используемую для отрисовки фона элемента.

См. также setBackground() и foreground().

Qt::CheckState QTableWidgetItem::checkState() const

Возвращает состояние выбора элемента таблицы.

См. также setCheckState() и flags().

[virtual] QTableWidgetItem *QTableWidgetItem::clone() const

Создает копию элемента.

int QTableWidgetItem::column() const

Возвращает столбец элемента в таблице. Если элемент не находится в таблице, эта функция вернет -1.

См. также row().

[virtual] QVariant QTableWidgetItem::data(int role) const

Возвращает данные элемента для заданного role.

См. также setData().

Qt::ItemFlags QTableWidgetItem::flags() const

Возвращает флаги, используемые для описания элемента. Они определяют, может ли элемент быть выбранным, изменённым и выделенным.

См. также setFlags().

QFont QTableWidgetItem::font() const

Возвращает шрифт, используемый для отрисовки текста элемента.

См. также setFont().

QBrush QTableWidgetItem::foreground() const

Возвращает кисть, используемую для отрисовки переднего плана элемента (например, текста).

См. также setForeground() и background().

QIcon QTableWidgetItem::icon() const

Возвращает значок элемента.

См. также setIcon() и iconSize.

bool QTableWidgetItem::isSelected() const

Возвращает true если элемент выбран, в противном случае возвращает false.

См. также setSelected().

[virtual] void QTableWidgetItem::read(QDataStream &in)

Считывает элемент из потока in.

См. также write().

int QTableWidgetItem::row() const

Возвращает строку элемента в таблице. Если элемент не находится в таблице, эта функция вернет -1.

См. также column().

void QTableWidgetItem::setBackground(const QBrush &brush)

Устанавливает кисть фона элемента на указанную brush. Установка кисти по умолчанию позволит представлению использовать цвет по умолчанию из стиля.

См. также background() и setForeground().

void QTableWidgetItem::setCheckState(Qt::CheckState state)

Устанавливает состояние выбора элемента таблицы в state.

См. также checkState().

[virtual] void QTableWidgetItem::setData(int role, const QVariant &value)

Устанавливает данные элемента для заданного role на указанное value.

См. также Qt::ItemDataRole и data().

void QTableWidgetItem::setFlags(Qt::ItemFlags flags)

Устанавливает флаги элемента на заданные flags. Эти флаги определяют, может ли элемент быть выделенным или изменённым.

См. также flags().

void QTableWidgetItem::setFont(const QFont &font)

Устанавливает шрифт, используемый для отображения текста элемента, на заданный font.

См. также font(), setText() и setForeground().

void QTableWidgetItem::setForeground(const QBrush &brush)

Устанавливает кисть переднего плана элемента на указанную brush. Установка кисти по умолчанию позволит представлению использовать цвет по умолчанию из стиля.

См. также foreground() и setBackground().

void QTableWidgetItem::setIcon(const QIcon &icon)

Устанавливает значок элемента на заданный icon.

См. также icon(), setText() и iconSize.

void QTableWidgetItem::setSelected(bool select)

Устанавливает состояние выбора элемента на select.

См. также isSelected().

void QTableWidgetItem::setSizeHint(const QSize &size)

Устанавливает подсказку размера для элемента таблицы в size. Если подсказка размера не установлена или size некорректна, делегат элемента вычислит подсказку размера на основе данных элемента.

См. также sizeHint().

void QTableWidgetItem::setStatusTip(const QString &statusTip)

Устанавливает подсказку состояния для элемента таблицы на текст, заданный в statusTip. Для работы этой функции необходимо включить отслеживание мыши в QTableWidget.

См. также statusTip(), setToolTip() и setWhatsThis().

void QTableWidgetItem::setText(const QString &text)

Устанавливает текст элемента на указанный text.

См. также text(), setFont() и setForeground().

void QTableWidgetItem::setTextAlignment(int alignment)

Устанавливает выравнивание текста для элемента на указанное alignment.

См. также textAlignment() и Qt::Alignment.

void QTableWidgetItem::setToolTip(const QString &toolTip)

Устанавливает подсказку элемента на указанную строку toolTip.

См. также toolTip(), setStatusTip() и setWhatsThis().

void QTableWidgetItem::setWhatsThis(const QString &whatsThis)

Устанавливает справку "Что это?" элемента на указанную строку whatsThis.

См. также whatsThis(), setStatusTip() и setToolTip().

QSize QTableWidgetItem::sizeHint() const

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

См. также setSizeHint().

QString QTableWidgetItem::statusTip() const

Возвращает подсказку состояния элемента.

См. также setStatusTip().

QTableWidget *QTableWidgetItem::tableWidget() const

Возвращает виджет таблицы, содержащий элемент.

QString QTableWidgetItem::text() const

Возвращает текст элемента.

См. также setText().

int QTableWidgetItem::textAlignment() const

Возвращает выравнивание текста для текста элемента.

См. также setTextAlignment() и Qt::Alignment.

QString QTableWidgetItem::toolTip() const

Возвращает подсказку элемента.

См. также setToolTip().

int QTableWidgetItem::type() const

Возвращает тип, переданный конструктору QTableWidgetItem.

QString QTableWidgetItem::whatsThis() const

Возвращает справку "Что это?" элемента.

См. также setWhatsThis().

[virtual] void QTableWidgetItem::write(QDataStream &out) const

Записывает элемент в поток out.

См. также read().

[virtual] bool QTableWidgetItem::operator<(const QTableWidgetItem &other) const

Возвращает true если элемент меньше, чем элемент other; в противном случае возвращает false.