QComboBox Class

成员函数文档

[explicit] 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).

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

每当组合框中的currentIndex 通过用户交互或编程方式发生变化时，就会发送该信号。如果组合框为空或currentIndex 已重置，则传递项目的index 或-1。

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

每当currentText 发生变化时，就会发出该信号。新值作为text 传递。

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

当组合框行编辑部件中的文本发生变化时，将发出该信号。新文本由text 指定。

[override virtual] 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

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

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

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

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

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

[override virtual protected] void QComboBox::focusInEvent(QFocusEvent *e)

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

[override virtual protected] void QComboBox::focusOutEvent(QFocusEvent *e)

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

[override virtual protected] void QComboBox::hideEvent(QHideEvent *e)

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

[virtual] void QComboBox::hidePopup()

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

另请参见 showPopup()。

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

当用户高亮显示组合框弹出列表中的某个项目时，将发送此信号。项目的index 会被传递。

[virtual protected] void QComboBox::initStyleOption(QStyleOptionComboBox *option) const

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

另请参阅 QStyleOption::initFrom()。

[override virtual protected] void QComboBox::inputMethodEvent(QInputMethodEvent *e)

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

[override virtual] 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)

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

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

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

[override virtual protected] void QComboBox::paintEvent(QPaintEvent *e)

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

void QComboBox::removeItem(int index)

从组合框中删除位于index 的项目。如果索引被删除，则会更新当前索引。

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

[override virtual protected] void QComboBox::resizeEvent(QResizeEvent *e)

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

QModelIndex QComboBox::rootModelIndex() const

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

另请参阅 setRootModelIndex()。

void QComboBox::setCompleter(QCompleter *completer)

设置completer ，以代替当前的补全器。如果completer 是nullptr ，自动补全将被禁用。

默认情况下，对于可编辑的组合框，会自动创建一个执行大小写不敏感的内联补全的QCompleter 。

另请参阅 completer()。

[slot] 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 。组合框拥有委托的所有权。

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 ，以代替当前的行编辑 widget。

组合框拥有行编辑器的所有权。

另请参阅 lineEdit()。

[virtual] 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() 。

[override virtual protected] void QComboBox::showEvent(QShowEvent *e)

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

[virtual] void QComboBox::showPopup()

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

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

另请参见 hidePopup()。

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

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

该实现会缓存大小提示，以避免在内容动态变化时调整大小。要使缓存值失效，请更改sizeAdjustPolicy 。

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

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

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

当用户高亮显示组合框弹出列表中的某个项目时，将发送此信号。项目的text 会被传递。

const QValidator *QComboBox::validator() const

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

另请参阅 setValidator() 和editable 。

QAbstractItemView *QComboBox::view() const

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

另请参阅 setView()。

[override virtual protected] void QComboBox::wheelEvent(QWheelEvent *e)

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