Класс QTableWidgetItem

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

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

Типы public

Функции public

Связанные свободные функции

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

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

Класс 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.

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

enum QTableWidgetItem::ItemType

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

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

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

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

QTableWidgetItem::QTableWidgetItem(const QTableWidgetItem &other)

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

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

Эта функция была введена в Qt 4.1.

См. также 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

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

Эта функция была введена в Qt 4.2.

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

Qt::CheckState QTableWidgetItem::checkState() const

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

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

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

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

int QTableWidgetItem::column() const

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

Эта функция была введена в Qt 4.2.

См. также 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

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

Эта функция была введена в Qt 4.2.

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

QIcon QTableWidgetItem::icon() const

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

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

bool QTableWidgetItem::isSelected() const

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

Эта функция была введена в Qt 4.2.

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

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

Читает элемент из потока in.

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

int QTableWidgetItem::row() const

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

Эта функция была введена в Qt 4.2.

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

void QTableWidgetItem::setBackground(const QBrush &brush)

Устанавливает кисть фона элемента на указанную brush.

Эта функция была введена в Qt 4.2.

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

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

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

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

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

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

Примечание: По умолчанию реализация обрабатывает Qt::EditRole и Qt::DisplayRole как ссылки на те же данные.

См. также 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.

Эта функция была введена в Qt 4.2.

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

void QTableWidgetItem::setIcon(const QIcon &icon)

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

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

void QTableWidgetItem::setSelected(bool select)

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

Эта функция была введена в Qt 4.2.

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

void QTableWidgetItem::setSizeHint(const QSize &size)

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

Эта функция была представлена в Qt 4.1.

См. также 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

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

Эта функция была представлена в Qt 4.1.

См. также 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.