EDropdown 下拉菜单
示例与代码
鼠标位置右键菜单
指定位置打开菜单
下拉菜单
属性
accessibleNamestring辅助技术读取的名称;建议为无文字控件设置可读名称。
textautoInsertSpacebool在两个中文字符的按钮文字之间插入空格。
继承 Provider,默认 falseautofocusbool组件显示时自动聚焦;受控件可用状态及弹层生命周期影响。
falsebgbool为文字按钮显示背景。
falsecheckablebool是否允许通过点击切换选中状态。
falsecheckedbool控件是否选中或开启。
falsecirclebool采用圆形按钮样式。
falsecolorcolor自定义颜色;透明值通常表示使用当前主题或语义配色。
动态绑定dashedbool使用虚线边框。
继承 Provider,默认 falsedurationint加载图标完成一圈旋转的时间,单位为毫秒。
2600effectstring弹层的视觉主题。
"light" / "dark"
"light"enabledbool是否允许交互;false 时控件禁用。
truefontfont字体配置,控制字体、字号及文字样式。
常用字段:
family、pixelSize、pointSize
bold、italic、weight
underline、strikeout
letterSpacing、wordSpacing
应用字体heightreal组件尺寸,单位为像素;可绑定父布局尺寸。
implicitHeighthideOnClickbool点击菜单项后关闭下拉菜单。
truehideTimeoutint等待、节流或自动关闭时间,单位为毫秒;0 表示不延迟或不启用定时关闭。
150iconComponentComponent自定义图标的 Component 插槽;null 使用默认内容。 委托上下文见本页示例。
nulliconSizeint图标、选项或交互部件的尺寸,单位为像素。
12iconSourceint组件使用的图标。
EIcons.*
0(无图标)
EIcons.CHEVRON_DOWNleftIconbool将图标放在文字左侧。
falselinkbool采用链接按钮样式。
falseloadingbool是否处于加载状态。
falseloadingComponentComponent自定义加载状态的 Component 插槽;null 使用默认内容。 委托上下文见本页示例。
nullloadingIconSourceint组件使用的图标。
EIcons.*
0(无图标)
0maxHeightreal最大显示高度,单位为像素;0 表示不额外限制。
0minHeightint控件最小高度,单位为像素;默认随 size 变化。
动态绑定modelvar组件的数据源;数组项结构以当前示例及组件说明为准。
[]nativeTypestring按钮行为,可用于普通操作、提交或重置表单。
button
submit
reset
"button"paddingSpacingint文字和图标之间的间距,单位为像素。
6persistentbool关闭后保留弹层内容实例。
trueplacementint弹层或消息的显示位置。
EPlacement.TopLeftEPlacement.TopEPlacement.TopRightEPlacement.LeftEPlacement.RightEPlacement.BottomLeftEPlacement.BottomEPlacement.BottomRight
EPlacement.BottomLeftplainbool采用朴素配色。
继承 Provider,默认 falseprogressreal进度值;用于进度动画或通知进度显示,具体范围由组件处理。
-1referenceItem弹层依附的可视对象。
nullroundbool采用圆角胶囊按钮样式。
继承 Provider,默认 falseshowArrowbool是否显示弹层或引导箭头。
falseshowTimeoutint等待、节流或自动关闭时间,单位为毫秒;0 表示不延迟或不启用定时关闭。
150sizeint控件尺寸;默认继承最近的 EConfigProvider。
EStyle.SmallEStyle.MediumEStyle.Large
继承 Provider,默认 EStyle.MediumsplitButtonbool把触发按钮拆分为主操作和下拉操作。
falsestrokeWidthint边框、分隔线或进度轨道的线宽,单位为像素。
3styleTypeint语义配色风格。
EStyle.DefaultEStyle.PrimaryEStyle.SuccessEStyle.InfoEStyle.WarningEStyle.Danger
继承 Provider,默认 EStyle.Defaulttextstring显示的文字内容。
""textButtonbool采用文字按钮样式。
继承 Provider,默认 falsetriggerstring打开下拉菜单的触发方式。
"click" / "hover""contextmenu"
"click"triggerKeysvar触发操作的 Qt 键值数组;空数组禁用键盘触发。
[Qt.Key_Return, Qt.Key_Enter, Qt.Key_Space, Qt.Key_Down]visiblebool是否显示组件。
truewidthreal组件尺寸,单位为像素;可绑定父布局尺寸。
implicitWidthdisplayTextstring只读经过格式化、进度或徽章规则处理后的显示文字。
由运行时计算itemsvar只读经过规范化或转换的项目列表。
由运行时计算referenceAvailablebool只读弹层参考对象是否可用、可交互或可见。
由运行时计算信号
command(var value, var item)执行命令时触发,包含命令值和对应菜单项。
visibleChangedByUser(bool visible)用户操作使下拉菜单显示或隐藏时触发,visible 为新的可见状态。
方法
close()关闭组件的面板或弹窗。
open()打开组件的面板或弹窗。
openAt(x, y, item)在 item 的 x、y 坐标处打开下拉菜单。