Класс QStandardItem
Класс QStandardItem предоставляет элемент для использования с классом QStandardItemModel. Подробнее...
| Заголовок: | #include <QStandardItem> |
| CMake: | find_package(Qt6 COMPONENTS Gui REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
Открытые типы
| перечисление | 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, Item View Convenience Classes и Model/View Programming.
Документация по типам членов
enum 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().
[since 5.12] 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().
См. также 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, связанную с этим элементом.
Когда вам нужно вызвать функциональность элемента в API на основе QModelIndex (например, QAbstractItemView), вы можете вызвать эту функцию, чтобы получить индекс, соответствующий расположению элемента в модели.
Если элемент не связан с моделью, возвращается недействительный QModelIndex.
См. также model() и QStandardItemModel::itemFromIndex().
END_OF_DOCUMENT_MARKERvoid 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().
[since 5.6] 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().
[since 5.6] 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().
END_OF_DOCUMENT_MARKERvoid QStandardItem::setAccessibleText(const QString &accessibleText)
Устанавливает доступный текст элемента на строку, указанную параметром accessibleText.
Доступный текст используется средствами вспомогательной технологией (например, для пользователей, которые не могут использовать стандартные способы взаимодействия).
См. также accessibleText() и setAccessibleDescription().
[since 5.6] 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 равно true, элемент можно выбрать; в противном случае, пользователь не может выбрать элемент.
Делегат элемента отобразит выбираемый элемент с флажком рядом с текстом элемента.
См. также 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 равно true, элемент можно перетащить; в противном случае, пользователь не может перетащить элемент.
Обратите внимание, что вам также необходимо убедиться, что перетаскивание элементов включено в представлении; см. QAbstractItemView::dragEnabled.
См. также isDragEnabled(), setDropEnabled(), и setFlags().
void QStandardItem::setDropEnabled(bool dropEnabled)
Устанавливает возможность опускания элемента. Если dropEnabled равно true, элемент может использоваться как целевой объект для опускания; в противном случае, он не может.
Обратите внимание, что вам также необходимо убедиться, что опускание включено в представлении; см. QWidget::acceptDrops; и что модель поддерживает желаемые действия опускания; см. QAbstractItemModel::supportedDropActions().
См. также isDropEnabled(), setDragEnabled(), и setFlags().
void QStandardItem::setEditable(bool editable)
Устанавливает возможность редактирования элемента. Если editable равно true, элемент можно редактировать; в противном случае, пользователь не может редактировать элемент.
Способ редактирования элементов в представлении определяется триггерами редактирования представления; см. QAbstractItemView::editTriggers.
См. также isEditable() и setFlags().
void QStandardItem::setEnabled(bool enabled)
Устанавливает, включен ли элемент. Если enabled равно true, элемент включен, что означает, что пользователь может взаимодействовать с элементом; если enabled равно false, пользователь не может взаимодействовать с элементом.
Этот флаг имеет приоритет над другими флагами элемента; например, если элемент не включен, он не может быть выбран пользователем, даже если флаг 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 равно true, элемент можно выбрать; в противном случае, пользователь не может выбрать элемент.
Вы можете контролировать поведение выбора и режим, изменяя свойства представления; см. QAbstractItemView::selectionMode и QAbstractItemView::selectionBehavior.
См. также isSelectable() и setFlags().
void QStandardItem::setSizeHint(const QSize &size)
Устанавливает подсказку размера элемента на size. Если подсказка размера не установлена, делегат элемента вычисляет подсказку размера на основе данных элемента.
См. также sizeHint().
void QStandardItem::setStatusTip(const QString &statusTip)
Устанавливает подсказку состояния элемента строкой, указанной в statusTip.
См. также statusTip(), setToolTip() и setWhatsThis().
void 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().
[since 5.6] void QStandardItem::setUserTristate(bool tristate)
Устанавливает, является ли элемент трехсостоятельным и контролируется ли пользователем. Если tristate равно true, пользователь может циклически переключаться между тремя состояниями; в противном случае элемент является проверяемым с двумя состояниями. (Обратите внимание, что это также требует, чтобы элемент был проверяемым; см. 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.
QDataStream &operator>>(QDataStream &in, QStandardItem &item)
Считывает QStandardItem из потока in в item.
Этот оператор использует QStandardItem::read().
См. также Сериализация типов данных Qt.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.0/qstandarditem.html