Класс QStandardItem
Класс QStandardItem предоставляет элемент для использования с классом QStandardItemModel. Подробнее...
| Заголовок: | #include <QStandardItem> |
| qmake: | QT += gui |
| С момента: | Qt 4.2 |
Этот класс был представлен в Qt 4.2.
Открытые типы
| перечисление | ItemType { Type, UserType } |
Открытые функции
| QStandardItem(int rows, int columns = 1) | |
| QStandardItem(const QIcon &icon, const QString &text) | |
| QStandardItem(const QString &text) | |
| QStandardItem() | |
| virtual | ~QStandardItem() |
| QString | accessibleDescription() const |
| QString | accessibleText() const |
| void | appendColumn(const QList<QStandardItem *> &items) |
| void | appendRow(const QList<QStandardItem *> &items) |
| void | appendRow(QStandardItem *item) |
| void | appendRows(const QList<QStandardItem *> &items) |
| QBrush | background() const |
| Qt::CheckState | checkState() const |
| QStandardItem * | child(int row, int column = 0) const |
| void | clearData() |
| virtual QStandardItem * | clone() const |
| int | column() const |
| int | columnCount() const |
| virtual QVariant | data(int role = Qt::UserRole + 1) const |
| Qt::ItemFlags | flags() const |
| QFont | font() const |
| QBrush | foreground() const |
| bool | hasChildren() const |
| QIcon | icon() const |
| QModelIndex | index() const |
| void | insertColumn(int column, const QList<QStandardItem *> &items) |
| void | insertColumns(int column, int count) |
| void | insertRow(int row, const QList<QStandardItem *> &items) |
| void | insertRow(int row, QStandardItem *item) |
| void | insertRows(int row, const QList<QStandardItem *> &items) |
| void | insertRows(int row, int count) |
| bool | isAutoTristate() const |
| bool | isCheckable() const |
| bool | isDragEnabled() const |
| bool | isDropEnabled() const |
| bool | isEditable() const |
| bool | isEnabled() const |
| bool | isSelectable() const |
| bool | isUserTristate() const |
| QStandardItemModel * | model() const |
| QStandardItem * | parent() const |
| virtual void | read(QDataStream &in) |
| void | removeColumn(int column) |
| void | removeColumns(int column, int count) |
| void | removeRow(int row) |
| void | removeRows(int row, int count) |
| int | row() const |
| int | rowCount() const |
| void | setAccessibleDescription(const QString &accessibleDescription) |
| void | setAccessibleText(const QString &accessibleText) |
| void | setAutoTristate(bool tristate) |
| void | setBackground(const QBrush &brush) |
| void | setCheckState(Qt::CheckState state) |
| void | setCheckable(bool checkable) |
| void | setChild(int row, int column, QStandardItem *item) |
| void | setChild(int row, QStandardItem *item) |
| void | setColumnCount(int columns) |
| virtual void | setData(const QVariant &value, int role = Qt::UserRole + 1) |
| void | setDragEnabled(bool dragEnabled) |
| void | setDropEnabled(bool dropEnabled) |
| void | setEditable(bool editable) |
| void | setEnabled(bool enabled) |
| void | setFlags(Qt::ItemFlags flags) |
| void | setFont(const QFont &font) |
| void | setForeground(const QBrush &brush) |
| void | setIcon(const QIcon &icon) |
| void | setRowCount(int rows) |
| void | setSelectable(bool selectable) |
| void | setSizeHint(const QSize &size) |
| void | setStatusTip(const QString &statusTip) |
| void | setText(const QString &text) |
| void | setTextAlignment(Qt::Alignment alignment) |
| void | setToolTip(const QString &toolTip) |
| void | setUserTristate(bool tristate) |
| void | setWhatsThis(const QString &whatsThis) |
| QSize | sizeHint() const |
| void | sortChildren(int column, Qt::SortOrder order = Qt::AscendingOrder) |
| QString | statusTip() const |
| QStandardItem * | takeChild(int row, int column = 0) |
| QList<QStandardItem *> | takeColumn(int column) |
| QList<QStandardItem *> | takeRow(int row) |
| QString | text() const |
| Qt::Alignment | textAlignment() const |
| QString | toolTip() const |
| virtual int | type() const |
| QString | whatsThis() const |
| virtual void | write(QDataStream &out) const |
| virtual bool | operator<(const QStandardItem &other) const |
Защищенные функции
| QStandardItem(const QStandardItem &other) | |
| QStandardItem & | operator=(const QStandardItem &other) |
| void | emitDataChanged() |
Связанные нечленные функции
| QDataStream & | operator<<(QDataStream &out, const QStandardItem &item) |
| QDataStream & | operator>>(QDataStream &in, QStandardItem &item) |
Подробное описание
Элементы обычно содержат текст, значки или флажки.
Каждый элемент может иметь свою собственную кисть фона, которая устанавливается с помощью функции setBackground(). Текущая кисть фона можно найти с помощью background(). Текстовая метка для каждого элемента может быть отрисована со своим шрифтом и кистью. Они задаются с помощью функций setFont() и setForeground() и считываются с помощью функций font() и foreground().
По умолчанию элементы включены, редактируемы, выбираемы, могут быть отмечены и могут использоваться как источник, так и цель операции перетаскивания. Флажки каждого элемента можно изменить, вызвав функцию setFlags(). Отмечаемые элементы могут быть отмечены и сняты с отметки с помощью функции setCheckState(). Соответствующая функция checkState() указывает, отмечен ли элемент в данный момент.
Вы можете хранить данные, специфичные для приложения, в элементе, вызвав функцию setData().
Каждый элемент может иметь двумерную таблицу дочерних элементов. Это позволяет создавать иерархии элементов. Типичная иерархия — дерево, в котором дочерняя таблица — таблица с одним столбцом (список).
Размеры дочерней таблицы можно установить с помощью setRowCount() и setColumnCount(). Элементы можно разместить в дочерней таблице с помощью setChild(). Получить указатель на дочерний элемент с помощью child(). Новые строки и столбцы дочерних элементов также можно вставить с помощью insertRow() и insertColumn() или добавить с помощью appendRow() и appendColumn(). При использовании функций добавления и вставки размеры дочерней таблицы будут увеличиваться по мере необходимости.
Существующую строку дочерних элементов можно удалить с помощью removeRow() или takeRow(); соответственно, столбец можно удалить с помощью removeColumn() или takeColumn().
Дочерние элементы элемента можно отсортировать, вызвав функцию sortChildren().
Наследование
При наследовании от QStandardItem для предоставления пользовательских элементов можно определять новые типы для них, чтобы их можно было отличить от базового класса. Функция type() должна быть переопределена для возвращения нового значения типа, равного или большего, чем UserType.
Переопределите data() и setData(), если хотите выполнить пользовательскую обработку запросов данных и/или управлять тем, как данные элемента представлены.
Переопределите clone(), если вы хотите, чтобы QStandardItemModel мог создавать экземпляры вашего пользовательского класса элементов по требованию (см. QStandardItemModel::setItemPrototype()).
Переопределите read() и write(), если хотите контролировать, как элементы представляются в их сериализованной форме.
Переопределите operator<(), если хотите контролировать семантику сравнения элементов. operator<() определяет порядок сортировки при сортировке элементов с помощью sortChildren() или QStandardItemModel::sort().
См. также QStandardItemModel, Классы удобства представления элементов и Программирование модели/представления.
Документация по типам членов
Перечисление QStandardItem::ItemType
Это перечисление описывает типы, используемые для описания стандартных элементов.
| Постоянная | Значение | Описание |
|---|---|---|
QStandardItem::Type |
0 |
Тип по умолчанию для стандартных элементов. |
QStandardItem::UserType |
1000 |
Минимальное значение для пользовательских типов. Значения ниже UserType зарезервированы Qt. |
Вы можете определять новые пользовательские типы в подклассах QStandardItem, чтобы убедиться, что пользовательские элементы обрабатываются особо; например, при сортировке элементов.
См. также type().
END_OF_DOCUMENT_MARKERДокументация по функциям-членам
[protected] QStandardItem::QStandardItem(const QStandardItem &other)
Создает копию other. Обратите внимание, что model() не копируется.
Эта функция полезна при переопределении clone().
QStandardItem::QStandardItem(int rows, int columns = 1)
Создает элемент с rows строками и columns столбцами дочерних элементов.
QStandardItem::QStandardItem(const QIcon &icon, const QString &text)
Создает элемент с заданным icon и text.
QStandardItem::QStandardItem(const QString &text)
Создает элемент с заданным text.
QStandardItem::QStandardItem()
Создаёт элемент.
[protected] QStandardItem &QStandardItem::operator=(const QStandardItem &other)
Присваивает данные и флаги other данному элементу. Обратите внимание, что type() и model() не копируются.
Эта функция полезна при переопределении clone().
[virtual] QStandardItem::~QStandardItem()
Удаляет элемент. Это приводит к удалению дочерних элементов элемента.
QString QStandardItem::accessibleDescription() const
Возвращает описание элемента для доступности.
Описание элемента для доступности используется технологиями вспомогательного доступа (например, для пользователей, которые не могут использовать традиционные методы взаимодействия).
См. также setAccessibleDescription() и accessibleText().
QString QStandardItem::accessibleText() const
Возвращает доступный текст элемента.
Доступный текст используется технологиями вспомогательного доступа (т. е. для пользователей, которые не могут взаимодействовать традиционными способами).
См. также setAccessibleText() и accessibleDescription().
void QStandardItem::appendColumn(const QList<QStandardItem *> &items)
Добавляет столбец, содержащий items. Если необходимо, количество строк увеличивается до размера items.
См. также insertColumn().
void QStandardItem::appendRow(const QList<QStandardItem *> &items)
Добавляет строку, содержащую items. Если необходимо, количество столбцов увеличивается до размера items.
См. также insertRow().
void QStandardItem::appendRow(QStandardItem *item)
Это перегруженная функция.
Добавляет строку, содержащую item.
При построении списка или дерева, имеющего только один столбец, эта функция предоставляет удобный способ добавления одного нового элемента.
void QStandardItem::appendRows(const QList<QStandardItem *> &items)
Добавляет строки, содержащие items. Количество столбцов не изменится.
См. также insertRow().
QBrush QStandardItem::background() const
Возвращает кисть, используемую для отрисовки фона элемента.
См. также foreground() и setBackground().
Qt::CheckState QStandardItem::checkState() const
Возвращает состояние выбора элемента.
См. также setCheckState() и isCheckable().
QStandardItem *QStandardItem::child(int row, int column = 0) const
Возвращает дочерний элемент в (row, column), если он задан; в противном случае возвращает nullptr.
См. также setChild(), takeChild() и parent().
void QStandardItem::clearData()
Удаляет все данные из всех ролей, ранее заданных.
Эта функция была введена в Qt 5.12.
[virtual] QStandardItem *QStandardItem::clone() const
Возвращает копию этого элемента. Дочерние элементы элемента не копируются.
При наследовании от QStandardItem, вы можете переопределить эту функцию, чтобы предоставить QStandardItemModel фабрику, которую он может использовать для создания новых элементов по требованию.
См. также QStandardItemModel::setItemPrototype() и operator=().
int QStandardItem::column() const
Возвращает столбец, в котором находится элемент в таблице дочерних элементов родительского элемента, или -1, если у элемента нет родителя.
int QStandardItem::columnCount() const
Возвращает количество столбцов дочерних элементов, имеющихся у элемента.
См. также setColumnCount() и rowCount().
[virtual] QVariant QStandardItem::data(int role = Qt::UserRole + 1) const
Возвращает данные элемента для заданной role или недействительный QVariant, если для роли нет данных.
Примечание: В реализации по умолчанию, Qt::EditRole и Qt::DisplayRole рассматриваются как ссылки на одни и те же данные.
См. также setData().
[protected] void QStandardItem::emitDataChanged()
Заставляет модель, связанную с этим элементом, передавать сигнал dataChanged() для этого элемента.
Обычно вызываете эту функцию только в случае, если вы наследовались от QStandardItem и переопределили data() и/или setData().
Эта функция была введена в Qt 4.4.
См. также setData().
Qt::ItemFlags QStandardItem::flags() const
Возвращает флаги элемента для элемента.
Флаги элемента определяют, как пользователь может взаимодействовать с элементом.
По умолчанию элементы включены, редактируемы, выбираемы, могут быть выбраны и могут быть использованы в качестве источника и цели операции перетаскивания.
См. также setFlags().
QFont QStandardItem::font() const
Возвращает шрифт, используемый для отрисовки текста элемента.
См. также setFont().
QBrush QStandardItem::foreground() const
Возвращает кисть, используемую для отрисовки переднего плана элемента (например, текста).
См. также setForeground() и background().
bool QStandardItem::hasChildren() const
Возвращает true , если у этого элемента есть дочерние элементы; в противном случае возвращает false.
См. также rowCount(), columnCount() и child().
QIcon QStandardItem::icon() const
Возвращает значок элемента.
См. также setIcon() и iconSize.
QModelIndex QStandardItem::index() const
Возвращает QModelIndex, связанный с этим элементом.
Когда вам нужно вызвать функциональность элемента в QModelIndex-ориентированном API (например, QAbstractItemView), вы можете вызвать эту функцию, чтобы получить индекс, соответствующий местоположению элемента в модели.
Если элемент не связан с моделью, возвращается недействительный QModelIndex.
См. также model() и QStandardItemModel::itemFromIndex().
void QStandardItem::insertColumn(int column, const QList<QStandardItem *> &items)
Вставляет столбец по индексу column, содержащий элементы items. При необходимости, количество строк увеличивается до размера items.
См. также insertColumns() и insertRow().
void QStandardItem::insertColumns(int column, int count)
Вставляет count столбцов элементов-потомков по индексу column.
См. также insertColumn() и insertRows().
void QStandardItem::insertRow(int row, const QList<QStandardItem *> &items)
Вставляет строку по индексу row, содержащую элементы items. При необходимости, количество столбцов увеличивается до размера items.
См. также insertRows() и insertColumn().
void QStandardItem::insertRow(int row, QStandardItem *item)
Это перегруженный метод.
Вставляет строку по индексу row, содержащую элемент item.
При построении списка или дерева с одним столбцом, эта функция предоставляет удобный способ вставки одного нового элемента.
void QStandardItem::insertRows(int row, const QList<QStandardItem *> &items)
Вставляет элементы items по индексу row. Количество столбцов не изменится.
См. также insertRow() и insertColumn().
void QStandardItem::insertRows(int row, int count)
Вставляет count строк элементов-потомков по индексу row.
См. также insertRow() и insertColumns().
bool QStandardItem::isAutoTristate() const
Возвращает значение, указывающее, является ли элемент трехсостоятельным и контролируется QTreeWidget.
Значение по умолчанию — false.
Этот метод был введён в Qt 5.6.
См. также setAutoTristate(), isCheckable(), и checkState().
bool QStandardItem::isCheckable() const
Возвращает значение, указывающее, может ли пользователь выбирать этот элемент.
Значение по умолчанию — false.
См. также setCheckable(), checkState(), isUserTristate(), и isAutoTristate().
bool QStandardItem::isDragEnabled() const
Возвращает значение, указывающее, разрешен ли перенос элемента. Элемент, для которого перенос разрешен, может быть перетащен пользователем.
Значение по умолчанию — true.
Обратите внимание, что перетаскивание элементов должно быть включено в представлении для работы перетаскивания; см. QAbstractItemView::dragEnabled.
См. также setDragEnabled(), isDropEnabled(), и flags().
bool QStandardItem::isDropEnabled() const
Возвращает значение, указывающее, разрешен ли разброс элемента. Когда разброс элемента разрешен, его можно использовать в качестве целевой точки разброса.
Значение по умолчанию — true.
См. также setDropEnabled(), isDragEnabled(), и flags().
bool QStandardItem::isEditable() const
Возвращает значение, указывающее, может ли элемент быть отредактирован пользователем.
Когда элемент редактируемый (и активный), пользователь может отредактировать его, вызвав одну из команд редактирования представления; см. QAbstractItemView::editTriggers.
Значение по умолчанию — true.
См. также setEditable() и flags().
bool QStandardItem::isEnabled() const
Возвращает значение, указывающее, активен ли элемент.
Когда элемент активен, пользователь может взаимодействовать с ним. Возможные типы взаимодействия определяются другими флагами элемента, такими как isEditable() и isSelectable().
Значение по умолчанию — true.
См. также setEnabled() и flags().
bool QStandardItem::isSelectable() const
Возвращает значение, указывающее, может ли элемент быть выбран пользователем.
Значение по умолчанию — true.
См. также setSelectable() и flags().
bool QStandardItem::isUserTristate() const
Возвращает значение, указывающее, является ли элемент трехсостоятельным; то есть, если он может быть выбран в трёх состояниях, и пользователь может переключаться между всеми тремя состояниями.
Значение по умолчанию — false.
Этот метод был введён в Qt 5.6.
См. также setUserTristate(), isCheckable(), и checkState().
QStandardItemModel *QStandardItem::model() const
Возвращает QStandardItemModel, к которому принадлежит этот элемент.
Если элемент не является потомком другого элемента, принадлежащего модели, эта функция возвращает nullptr.
См. также index().
QStandardItem *QStandardItem::parent() const
Возвращает родительский элемент или nullptr если у элемента нет родителя.
Примечание: Для элементов верхнего уровня parent() возвращает nullptr. Чтобы получить родителя элемента верхнего уровня, используйте QStandardItemModel::invisibleRootItem() вместо этого.
См. также child() и QStandardItemModel::invisibleRootItem().
[virtual] void QStandardItem::read(QDataStream &in)
Считывает элемент из потока in. Считываются только данные и флаги элемента, а не его дочерние элементы.
См. также write().
void QStandardItem::removeColumn(int column)
Удаляет указанный столбец column. Элементы, которые были в этом столбце, удаляются.
См. также takeColumn(), removeColumns(), и removeRow().
void QStandardItem::removeColumns(int column, int count)
Удаляет count столбцов, начиная с column. Элементы в этих столбцах удаляются.
См. также removeColumn() и removeRows().
void QStandardItem::removeRow(int row)
Удаляет указанную строку row. Элементы, которые были в этой строке, удаляются.
См. также takeRow(), removeRows(), и removeColumn().
void QStandardItem::removeRows(int row, int count)
Удаляет count строк, начиная с row. Элементы в этих строках удаляются.
См. также removeRow() и removeColumn().
int QStandardItem::row() const
Возвращает строку, в которой находится элемент в таблице потомков родительского элемента, или -1, если у элемента нет родителя.
См. также column() и parent().
int QStandardItem::rowCount() const
Возвращает количество дочерних элементов в строках, которыми обладает элемент.
См. также setRowCount() и columnCount().
void QStandardItem::setAccessibleDescription(const QString &accessibleDescription)
Устанавливает описания элемента для вспомогательных технологий (например, для пользователей, которые не могут использовать традиционные методы взаимодействия) с помощью строки accessibleDescription.
См. также accessibleDescription() и setAccessibleText().
void QStandardItem::setAccessibleText(const QString &accessibleText)
Устанавливает доступный текст для элемента с помощью строки accessibleText.
Доступный текст используется вспомогательными технологиями (например, для пользователей, которые не могут использовать стандартные способы взаимодействия).
См. также accessibleText() и setAccessibleDescription().
void QStandardItem::setAutoTristate(bool tristate)
Определяет, что элемент является трехсостоятельным и контролируется QTreeWidget, если tristate равно true. Это позволяет автоматически управлять состоянием родительских элементов в QTreeWidget (отмеченный, если все дочерние элементы отмечены, не отмеченный, если все дочерние элементы не отмечены, или частично отмеченный, если только некоторые дочерние элементы отмечены).
Эта функция была добавлена в Qt 5.6.
См. также isAutoTristate(), setCheckable() и setCheckState().
void QStandardItem::setBackground(const QBrush &brush)
Устанавливает кисть фона элемента на указанную кисть brush.
См. также background() и setForeground().
void QStandardItem::setCheckState(Qt::CheckState state)
Устанавливает состояние отметки элемента на state.
См. также checkState() и setCheckable().
void QStandardItem::setCheckable(bool checkable)
Устанавливает, является ли элемент проверяемым пользователем. Если checkable истинно, элемент может быть помечен пользователем; в противном случае пользователь не может пометить элемент.
Делегат элемента будет отображать проверяемый элемент с флажком рядом с текстом элемента.
См. также isCheckable(), setCheckState(), setUserTristate() и setAutoTristate().
void QStandardItem::setChild(int row, int column, QStandardItem *item)
Устанавливает дочерний элемент в позиции (row, column) на item. Этот элемент (родительский элемент) принимает владение item. При необходимости количество строк и столбцов увеличивается для размещения элемента.
Примечание: Передача nullptr в качестве item удаляет элемент.
См. также child().
void QStandardItem::setChild(int row, QStandardItem *item)
Это перегруженная функция.
Устанавливает дочерний элемент в позиции row на item.
void QStandardItem::setColumnCount(int columns)
Устанавливает количество столбцов дочерних элементов на columns. Если это значение меньше columnCount(), данные в нежелательных столбцах удаляются.
См. также columnCount() и setRowCount().
[virtual] void QStandardItem::setData(const QVariant &value, int role = Qt::UserRole + 1)
Устанавливает данные элемента для заданного role на указанное значение value.
Если вы наследуете от QStandardItem и переопределяете эту функцию, ваша переопределение должна вызывать emitDataChanged(), если вы не вызываете базовую реализацию setData(). Это гарантирует, что, например, представления, использующие модель, уведомляются об изменениях.
Примечание: Базовая реализация рассматривает Qt::EditRole и Qt::DisplayRole как ссылки на одни и те же данные.
См. также Qt::ItemDataRole, data() и setFlags().
void QStandardItem::setDragEnabled(bool dragEnabled)
Устанавливает, разрешено ли перетаскивание элемента. Если dragEnabled истинно, элемент можно перетащить; в противном случае пользователь не может перетащить элемент.
Обратите внимание, что вам также необходимо убедиться, что перетаскивание элементов включено в представлении; см. QAbstractItemView::dragEnabled.
См. также isDragEnabled(), setDropEnabled() и setFlags().
void QStandardItem::setDropEnabled(bool dropEnabled)
Устанавливает, разрешен ли сброс элемента. Если dropEnabled истинно, элемент можно использовать в качестве цели сброса; в противном случае нет.
Обратите внимание, что вам также необходимо убедиться, что сбросы включены в представлении; см. QWidget::acceptDrops; и что модель поддерживает требуемые действия сброса; см. QAbstractItemModel::supportedDropActions.
См. также isDropEnabled(), setDragEnabled() и setFlags().
void QStandardItem::setEditable(bool editable)
Устанавливает, редактируется ли элемент. Если editable истинно, элемент можно редактировать пользователем; в противном случае пользователь не может редактировать элемент.
Как пользователь может редактировать элементы в представлении, определяется триггерами редактирования представления; см. QAbstractItemView::editTriggers.
См. также isEditable() и setFlags().
void QStandardItem::setEnabled(bool enabled)
Устанавливает, активен ли элемент. Если enabled истинно, элемент активен, то есть пользователь может взаимодействовать с элементом; если enabled ложно, пользователь не может взаимодействовать с элементом.
Этот флаг имеет приоритет над другими флагами элемента; например, если элемент не активен, его нельзя выбрать пользователем, даже если флаг Qt::ItemIsSelectable был установлен.
См. также isEnabled(), Qt::ItemIsEnabled и setFlags().
void QStandardItem::setFlags(Qt::ItemFlags flags)
Устанавливает флаги элемента для элемента на flags.
Флаги элемента определяют, как пользователь может взаимодействовать с элементом. Это часто используется для отключения элемента.
См. также flags() и setData().
void QStandardItem::setFont(const QFont &font)
Устанавливает шрифт, используемый для отображения текста элемента, на заданный font.
См. также font(), setText() и setForeground().
void QStandardItem::setForeground(const QBrush &brush)
Устанавливает кисть, используемую для отображения переднего плана элемента (например, текста), на заданную brush.
См. также foreground(), setBackground() и setFont().
void QStandardItem::setIcon(const QIcon &icon)
Устанавливает значок элемента на указанный icon.
См. также icon().
void QStandardItem::setRowCount(int rows)
Устанавливает количество строк дочерних элементов на rows. Если это значение меньше rowCount(), данные в нежелательных строках удаляются.
См. также rowCount() и setColumnCount().
void QStandardItem::setSelectable(bool selectable)
Устанавливает, выбирается ли элемент. Если selectable истинно, элемент можно выбрать пользователем; в противном случае пользователь не может выбрать элемент.
Вы можете управлять поведением выбора и режимом, изменяя свойства представления; см. QAbstractItemView::selectionMode и QAbstractItemView::selectionBehavior.
См. также isSelectable() и setFlags().
void QStandardItem::setSizeHint(const QSize &size)
Устанавливает размер подсказки для элемента на size. Если подсказка размера не задана, делегат элемента вычислит размер подсказки на основе данных элемента.
См. также sizeHint().
void QStandardItem::setStatusTip(const QString &statusTip)
Устанавливает подсказку состояния элемента на строку, заданную statusTip.
См. также statusTip(), setToolTip() и setWhatsThis().
END_OF_DOCUMENT_MARKERvoid QStandardItem::setText(const QString &text)
Устанавливает текст элемента на заданный text.
См. также text(), setFont(), и setForeground().
void QStandardItem::setTextAlignment(Qt::Alignment alignment)
Устанавливает выравнивание текста элемента на заданное alignment.
См. также textAlignment().
void QStandardItem::setToolTip(const QString &toolTip)
Устанавливает подсказку элемента на заданную строку toolTip.
См. также toolTip(), setStatusTip(), и setWhatsThis().
void QStandardItem::setUserTristate(bool tristate)
Устанавливает, является ли элемент трехсостоятельным и управляемым пользователем. Если tristate истинно, пользователь может переключаться между тремя состояниями; в противном случае элемент может быть отмечен двумя состояниями. (Обратите внимание, что это также требует, чтобы элемент был помечен; см. isCheckable().)
Эта функция была добавлена в Qt 5.6.
См. также isUserTristate(), setCheckable(), и setCheckState().
void QStandardItem::setWhatsThis(const QString &whatsThis)
Устанавливает помощь "Что это?" для элемента на строку, указанную в whatsThis.
См. также whatsThis(), setStatusTip(), и setToolTip().
QSize QStandardItem::sizeHint() const
Возвращает установленное значение размера подсказки для элемента или недопустимое значение QSize, если размер подсказки не установлен.
Если размер подсказки не установлен, делегат элемента вычислит размер подсказки на основе данных элемента.
См. также setSizeHint().
void QStandardItem::sortChildren(int column, Qt::SortOrder order = Qt::AscendingOrder)
Сортирует дочерние элементы элемента с использованием заданного order по значениям в заданном column.
Примечание: Эта функция рекурсивна, поэтому она сортирует дочерние элементы элемента, его внуки и т. д.
См. также operator<().
QString QStandardItem::statusTip() const
Возвращает подсказку статуса элемента.
См. также setStatusTip(), toolTip(), и whatsThis().
QStandardItem *QStandardItem::takeChild(int row, int column = 0)
Удаляет дочерний элемент по (row, column) без удаления и возвращает указатель на элемент. Если элемента с указанными координатами не существует, функция возвращает nullptr.
Обратите внимание, что эта функция, в отличие от takeRow() и takeColumn(), не влияет на размеры таблицы дочерних элементов.
См. также child(), takeRow(), и takeColumn().
QList<QStandardItem *> QStandardItem::takeColumn(int column)
Удаляет столбец column без удаления элементов столбца и возвращает список указателей на удаленные элементы. Для элементов в столбце, которые не были установлены, соответствующие указатели в списке будут nullptr.
См. также removeColumn(), insertColumn(), и takeRow().
QList<QStandardItem *> QStandardItem::takeRow(int row)
Удаляет строку row без удаления элементов строки и возвращает список указателей на удаленные элементы. Для элементов в строке, которые не были установлены, соответствующие указатели в списке будут nullptr.
См. также removeRow(), insertRow(), и takeColumn().
QString QStandardItem::text() const
Возвращает текст элемента. Это текст, который отображается пользователю в представлении.
См. также setText().
Qt::Alignment QStandardItem::textAlignment() const
Возвращает выравнивание текста элемента.
См. также setTextAlignment().
QString QStandardItem::toolTip() const
Возвращает подсказку элемента.
См. также setToolTip(), statusTip(), и whatsThis().
[virtual] int QStandardItem::type() const
Возвращает тип этого элемента. Тип используется для различения пользовательских элементов от базового класса. При наследовании от QStandardItem вы должны переопределить эту функцию и вернуть новое значение, большее или равное UserType.
См. также QStandardItem::Type.
QString QStandardItem::whatsThis() const
Возвращает помощь "Что это?" для элемента.
См. также setWhatsThis(), toolTip(), и statusTip().
[virtual] void QStandardItem::write(QDataStream &out) const
Записывает элемент в поток out. Записываются только данные и флаги элемента, а не дочерние элементы.
См. также read().
[virtual] bool QStandardItem::operator<(const QStandardItem &other) const
Возвращает true если этот элемент меньше, чем other; в противном случае возвращает false.
По умолчанию используется данные для роли сортировки элемента (см. QStandardItemModel::sortRole) для сравнения, если элемент принадлежит модели; в противном случае используются данные для роли Qt::DisplayRole (text()) для сравнения.
sortChildren() и QStandardItemModel::sort() используют эту функцию при сортировке элементов. Если вам нужна пользовательская сортировка, вы можете расширить QStandardItem и переопределить эту функцию.
Связанные нечленные функции
QDataStream &operator<<(QDataStream &out, const QStandardItem &item)
Записывает QStandardItem item в поток out.
Этот оператор использует QStandardItem::write().
Эта функция была добавлена в Qt 4.2.
См. также Сериализация типов данных Qt.
QDataStream &operator>>(QDataStream &in, QStandardItem &item)
Считывает QStandardItem из потока in в item.
Этот оператор использует QStandardItem::read().
Эта функция была добавлена в Qt 4.2.
См. также Сериализация типов данных Qt.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.14/qstandarditem.html