combo_box#

Module Contents#

`ComboItem`	下拉框项
`ComboBoxBase`	下拉框基类
`ComboBox`	下拉框
`EditableComboBox`	可编辑下拉框
`ComboBoxMenu`	下拉菜单

class ComboItem(text: str, icon: str | PyQt5.QtGui.QIcon | qfluentwidgets.common.icon.FluentIconBase = None, userData=None)#

下拉框项

property icon#

class ComboBoxBase(parent=None, **kwargs)#

Bases: PyQt5.QtCore.QObject

下拉框基类

currentIndexChanged#

currentTextChanged#

eventFilter(obj, e: PyQt5.QtCore.QEvent)#

addItem(text: str, icon: str | PyQt5.QtGui.QIcon | qfluentwidgets.common.icon.FluentIconBase = None, userData=None)#

添加选项

参数#

text: str: 选项的文本

icon: str | QIcon | FluentIconBase

addItems(texts: Iterable[str])#

添加多个选项

参数#

text: Iterable[str]: 选项的文本

removeItem(index: int)#: 移除指定索引处的选项。如果当前项被移除，该操作会更新当前选中的选项

currentIndex()#

setCurrentIndex(index: int)#

设置当前索引

参数#

index: int: 返回当前索引

setText(text: str)#

currentText()#

currentData()#

setCurrentText(text)#

设置当前选项，text 需要在选项中

参数#

text: str: 当前选项

setItemText(index: int, text: str)#

设置选项的文本

参数#

index: int: 选项的索引
text: str: 选项的新文本

itemData(index: int)#: 返回指定索引处的数据

itemText(index: int)#: 返回指定索引处的文本

itemIcon(index: int)#: 返回指定索引处的图标

setItemData(index: int, value)#: 设置选项的数据

setItemIcon(index: int, icon: str | PyQt5.QtGui.QIcon | qfluentwidgets.common.icon.FluentIconBase)#: 设置选项的数据

findData(data)#: 返回含有该数据的选项索引，如果找不到匹配的选项就返回 -1

findText(text: str)#: 返回含有该文本的选项索引，如果找不到匹配的选项就返回 -1

clear()#: Clears the combobox, removing all items.

count()#: 返回选项数量

insertItem(index: int, text: str, icon: str | PyQt5.QtGui.QIcon | qfluentwidgets.common.icon.FluentIconBase = None, userData=None)#: 在指定索引处插入选项

insertItems(index: int, texts: Iterable[str])#: 在指定索引处插入多个选项

setMaxVisibleItems(num: int)#

maxVisibleItems()#

class ComboBox(parent=None)#

Bases: PyQt5.QtWidgets.QPushButton, ComboBoxBase

下拉框

currentIndexChanged#

currentTextChanged#

setPlaceholderText(text: str)#

setCurrentIndex(index: int)#

设置当前索引

参数#

index: int: 返回当前索引

mouseReleaseEvent(e)#

paintEvent(e)#

class EditableComboBox(parent=None)#

Bases: qfluentwidgets.components.widgets.line_edit.LineEdit, ComboBoxBase

可编辑下拉框

currentIndexChanged#

currentTextChanged#

setCompleterMenu(menu)#

set completer menu

参数#

menu: CompleterMenu: completer menu

currentText()#

setCurrentIndex(index: int)#

设置当前索引

参数#

index: int: 返回当前索引

clear()#: Clears the combobox, removing all items.

setPlaceholderText(text: str)#

class ComboBoxMenu(parent=None)#

Bases: qfluentwidgets.components.widgets.menu.RoundMenu

下拉菜单

exec(pos, ani=True, aniType=MenuAnimationType.DROP_DOWN)#

show menu

参数#

pos: QPoint: pop-up position
ani: bool: Whether to show pop-up animation
aniType: MenuAnimationType: menu animation type