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 因用户交互或程序操作而发生变化时，都会发送此信号。该项的index 会被传递；如果组合框变为空状态，或者currentIndex 被重置，则传递-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

返回包含给定data 的项的索引，该项属于给定的role ；否则返回-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

返回下拉列表中给定role 在给定index 中的数据，如果该角色没有数据，则返回无效的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 ），以替代当前的行编辑控件。

下拉列表将接管该行编辑控件的所有权。

另请参阅 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)。