QComboBox类

成员函数文档

[显式] QComboBox::QComboBox(QWidget *parent = nullptr)

使用默认模型QStandardItemModel和给定的parent构建组合框。

[virtual noexcept] QComboBox::~QComboBox()

销毁组合框。

[signal] void QComboBox::activated(int index)

当用户在组合框中选择一个项目时，会发送此信号。传递项目的 index。注意，即使选择没有改变，也会发送该信号。如果您需要知道选择实际上何时改变，请使用信号 currentIndexChanged() 或 currentTextChanged()。

void QComboBox::addItem(const QString &text, const QVariant &userData = QVariant())

向组合框添加给定 text 的项目，并包含指定的 userData（存储在 Qt::UserRole）。该条目被追加到现有条目列表中。

void QComboBox::addItem(const QIcon &icon, const QString &text, const QVariant &userData = QVariant())

向组合框添加带有给定 icon 和 text 的项目，并包含指定的 userData（存储在 Qt::UserRole）。该条目被追加到现有条目列表中。

void QComboBox::addItems(const QStringList &texts)

将给定 texts 中的每个字符串添加到组合框中。每个项目依次追加到现有项目列表中。

[override virtual protected] void QComboBox::changeEvent(QEvent *e)

重新实现了： QWidget::changeEvent(QEvent *event)。

[slot] void QComboBox::clear()

清除组合框，移除所有条目。

注意：如果您已在组合框上设置了外部模型，则在调用此函数时此模型仍然会被清除。

[slot] void QComboBox::clearEditText()

清除用于组合框编辑的行编辑内容。

QCompleter *QComboBox::completer() const

返回用于为组合框自动完成文本输入的补全器。

另请参阅 setCompleter() 和 editable。

[override virtual protected] void QComboBox::contextMenuEvent(QContextMenuEvent *e)

重新实现了： QWidget::contextMenuEvent(QContextMenuEvent *event)。

[信号] void QComboBox::currentIndexChanged(int index)

每当组合框中的currentIndex由于用户交互或其他程序操作而更改时，都会发送此信号。传递项目的index，如果组合框变为空或currentIndex已重置，则为-1。

[信号] void QComboBox::currentTextChanged(const QString &text)

当currentText改变时，会发出此信号。新值作为text传递。

[信号] void QComboBox::editTextChanged(const QString &text)

当组合框的行编辑小部件中的文本改变时，会发出此信号。新文本由text指定。

[重写虚函数] bool QComboBox::event(QEvent *event)

重新实现：QWidget::event(QEvent *event).

int QComboBox::findData(const QVariant &data, int role = Qt::UserRole, Qt::MatchFlags flags = static_cast<Qt::MatchFlags>(Qt::MatchExactly|Qt::MatchCaseSensitive)) const

返回包含给定data的项的索引；否则返回-1。

flags指定如何在组合框中搜索项。

int QComboBox::findText(const QString &text, Qt::MatchFlags flags = Qt::MatchExactly|Qt::MatchCaseSensitive) const

返回包含给定text的项的索引；否则返回-1。

flags指定如何在组合框中搜索项。

[重写虚保护函数] void QComboBox::focusInEvent(QFocusEvent *e)

重新实现：QWidget::focusInEvent(QFocusEvent *event).

[重写虚保护函数] void QComboBox::focusOutEvent(QFocusEvent *e)

重新实现：QWidget::focusOutEvent(QFocusEvent *event).

[重写虚保护函数] void QComboBox::hideEvent(QHideEvent *e)

重新实现：QWidget::hideEvent(QHideEvent *event).

[虚拟] void QComboBox::hidePopup()

如果组合框中的列表当前可见，则隐藏列表并重置内部状态。如果自定义弹出窗口在重写的 showPopup() 内显示，那么您还需要重写 hidePopup() 函数来隐藏自定义弹出窗口，并调用基类实现来重置内部状态，每当自定义弹出窗口控件被隐藏时。

另请参阅showPopup。

[信号] void QComboBox::highlighted(int index)

当用户突出显示组合框弹出列表中的项目时，会发出此信号。传递项目的 index。

[虚拟受保护] void QComboBox::initStyleOption(QStyleOptionComboBox *option) const

使用此 QComboBox 的值初始化 option。当子类需要 QStyleOptionComboBox，但不想自己填写所有信息时，此方法很有用。

另请参阅QStyleOption::initFrom。

[重写虚拟受保护] void QComboBox::inputMethodEvent(QInputMethodEvent *e)

重新实现：QWidget::inputMethodEvent(QInputMethodEvent *event)

[重写虚拟] QVariant QComboBox::inputMethodQuery(Qt::InputMethodQuery query) const

重新实现：QWidget::inputMethodQuery(Qt::InputMethodQuery query) const。

void QComboBox::insertItem(int index, const QString &text, const QVariant &userData = QVariant())

将 text 和 userData（存储在 Qt::UserRole）插入到给定 index 处的组合框中。

如果索引等于或大于项目总数，新项目将被附加到现有项目列表中。如果索引为零或负数，新项目将追加到现有项目列表的开头。

另请参阅insertItems。

void QComboBox::insertItem(int index, const QIcon &icon, const QString &text, const QVariant &userData = QVariant())

将 icon、text 和 userData（存储在 Qt::UserRole）插入到给定 index 处的组合框中。

如果索引等于或大于项目总数，新项目将被附加到现有项目列表中。如果索引为零或负数，新项目将追加到现有项目列表的开头。

另请参阅insertItems。

void QComboBox::insertItems(int index, const QStringList &list)

将列表中的字符串分别插入到组合框中，从指定的 index 开始。

如果索引等于或高于项目总数，则新项目将附加到现有项目列表中。如果索引为零或负数，则新项目将添加到现有项目列表的开头。

另请参阅 insertItem()。

void QComboBox::insertSeparator(int index)

在给定 index 处将分隔符项目插入组合框中。

如果索引等于或大于项目总数，新项目将被附加到现有项目列表中。如果索引为零或负数，新项目将追加到现有项目列表的开头。

另请参阅 insertItem()。

QVariant QComboBox::itemData(int index, int role = Qt::UserRole) const

返回组合框给定 index 下对应 role 的数据，如果没有该角色的数据，则返回无效的 QVariant。

另请参阅 setItemData()。

QAbstractItemDelegate *QComboBox::itemDelegate() const

返回组合框使用的弹出列表视图的项委托。

另请参阅 setItemDelegate()。

QIcon QComboBox::itemIcon(int index) const

返回组合框给定 index 项目的图标。

另请参阅 setItemIcon()。

QString QComboBox::itemText(int index) const

返回组合框给定 index 项目的文本。

另请参阅 setItemText()。

[override virtual protected] void QComboBox::keyPressEvent(QKeyEvent *e)

重新实现: QWidget::keyPressEvent(QKeyEvent *event)。

[override virtual protected] void QComboBox::keyReleaseEvent(QKeyEvent *e)

重新实现: QWidget::keyReleaseEvent(QKeyEvent *event)。

QLineEdit *QComboBox::lineEdit() const

返回用于编辑组合框中项目的行编辑，如果没有行编辑，则返回 nullptr。

只有可编辑的组合框才有行编辑。

另请参阅 setLineEdit()。

[override virtual] QSize QComboBox::minimumSizeHint() const

重新实现了属性访问函数： QWidget::minimumSizeHint。

QAbstractItemModel *QComboBox::model() const

返回组合框使用的模型。

另请参阅 setModel()。

[override virtual protected] void QComboBox::mousePressEvent(QMouseEvent *e)

重新实现: QWidget::mousePressEvent(QMouseEvent *event).

[覆盖 虚拟 保护] void QComboBox::mouseReleaseEvent(QMouseEvent *e)

重新实现: QWidget::mouseReleaseEvent(QMouseEvent *event).

[覆盖 虚拟 保护] void QComboBox::paintEvent(QPaintEvent *e)

重新实现: QWidget::paintEvent(QPaintEvent *event).

void QComboBox::removeItem(int index)

从组合框中移除指定 index 的项。如果移除该项，则更新当前索引。

如果 index 超出范围，此函数不执行任何操作。

[覆盖 虚拟 保护] void QComboBox::resizeEvent(QResizeEvent *e)

重新实现: QWidget::resizeEvent(QResizeEvent *event).

QModelIndex QComboBox::rootModelIndex() const

返回组合框中项的根模型项索引。

另请参阅setRootModelIndex()。

void QComboBox::setCompleter(QCompleter *completer)

将 completer 设为使用，而不是当前的 completer。如果 completer 为 nullptr，则禁用自动完成。

默认情况下，对于可编辑组合框，会自动创建一个执行不区分大小写行内完成的 QCompleter。

另请参阅completer。

[槽] void QComboBox::setEditText(const QString &text)

将组合框文本编辑的 text 设置。

void QComboBox::setItemData(int index, const QVariant &value, int role = Qt::UserRole)

将组合框中给定 index 的项的 role 数据设置为指定 value。

另请参阅itemData。

void QComboBox::setItemDelegate(QAbstractItemDelegate *delegate)

为弹出列表视图设置项 delegate。组合框将拥有此 delegate。

任何现有的 delegate 都将移除，但不会删除。 QComboBox 不会拥有 delegate。

另请参阅itemDelegate。

void QComboBox::setItemIcon(int index, const QIcon &icon)

设置组合框中给定 index 的项的 icon。

另请参阅itemIcon。

void QComboBox::setItemText(int index, const QString &text)

设置组合框中给定 index 的项的 text。

另请参阅itemText。

void QComboBox::setLineEdit(QLineEdit *edit)

设置要使用的行 edit 而不是当前的行编辑小部件。

组合框将拥有行编辑的版权。

另请参阅lineEdit。

[虚函数] void QComboBox::setModel(QAbstractItemModel *model)

设置要设置的模型 model。 model 不能是 nullptr。如果您想清除模型的内容，请调用 clear()。

另请参阅model、clear 和 setCompleter。

void QComboBox::setRootModelIndex(const QModelIndex &index)

设置组合框中项的根模型项 index。

另请参阅rootModelIndex。

void QComboBox::setValidator(const QValidator *validator)

设置要使用的 validator 而不是当前的验证器。

另请参阅validator。

void QComboBox::setView(QAbstractItemView *itemView)

将用于组合框弹出窗口的视图设置为给定的 itemView。组合框将拥有视图的版权。

注意：如果您想使用便捷视图（如QListWidget、QTableWidget或QTreeWidget），在使用本函数之前，请确保调用带有便捷视图模型的setModel()。

另请参阅 view。

[重写虚保护] void QComboBox::showEvent(QShowEvent *e)

重实现： QWidget::showEvent(QShowEvent *event).

[虚函数] void QComboBox::showPopup()

显示组合框中的项目列表。如果列表为空，则不显示任何项目。

如果您重写此函数以显示自定义弹出窗口，请确保调用hidePopup()以重置内部状态。

另请参阅 hidePopup。

[重写虚函数] QSize QComboBox::sizeHint() const

重实现属性的访问函数： QWidget::sizeHint。

此实现将大小提示缓存起来，以避免内容动态变化时的调整大小。要使缓存值无效，请更改sizeAdjustPolicy。

[信号] void QComboBox::textActivated(const QString &text)

当用户在组合框中选择一个项目时发送此信号。将项目的text传递。请注意，即使在选择没有变化的情况下，此信号也会发送。如果您需要知道选择是否实际更改，请使用信号currentIndexChanged或currentTextChanged。

[信号] void QComboBox::textHighlighted(const QString &text)

当用户突出显示组合框弹出列表中的一个项目时发送此信号。传递项目的text。

const QValidator *QComboBox::validator() const

返回用于限制组合框文本输入的验证器。

另请参阅 setValidator和editable。

QAbstractItemView *QComboBox::view() const

返回用于组合框弹出窗口的列表视图。

另请参阅 setView。

[重写虚保护] void QComboBox::wheelEvent(QWheelEvent *e)

重实现： QWidget::wheelEvent(QWheelEvent *event).