Класс QStandardItem

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

Этот класс был представлен в Qt 4.2.

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

Публичные типы

Публичные функции

Защищенные функции

Связанные нечленные функции

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

Элементы обычно содержат текст, значки или флажки.

Каждый элемент может иметь собственную кисть фона, которая устанавливается с помощью функции 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().

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

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

См. также 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() модели, связанной с этим элементом, для этого элемента.

Вам обычно не нужно вызывать эту функцию, если вы не переопределили 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, связанную с этим элементом.

Когда вам нужно вызвать функциональность элемента в 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().

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 равно 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().

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 и переопределить эту функцию.