Spec-Zone.ru › Qt 6.1

Класс 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
virtual void multiData(QModelRoleDataSpan roleDataSpan) 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, Элементы виджетов удобные классы, и Моделирование/Представление.

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

enum QStandardItem::ItemType

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

Постоянная Значение Описание
QStandardItem::Type 0 Тип по умолчанию для стандартных элементов.
QStandardItem::UserType 1000 Минимальное значение для пользовательских типов. Значения ниже UserType зарезервированы Qt.
END_OF_DOCUMENT_MARKER

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

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

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

[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.

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

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

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

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

См. также QStandardItemModel::setItemPrototype() и operator=().

int QStandardItem::column() const

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

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

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().

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().

[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().

[virtual, since 6.0] void QStandardItem::multiData(QModelRoleDataSpan roleDataSpan) const

Заполняет область roleDataSpan данными из этого элемента.

Реализация по умолчанию просто вызывает data() для каждого роли в области.

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

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

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().

[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().

END_OF_DOCUMENT_MARKER

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.1/qstandarditem.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API