HusCaptionBar 标题栏

January 28, 2026 · View on GitHub

← 返回主目录

← 返回本类别目录

HusCaptionBar 标题栏

为无边框窗口提供一个通用的标题栏。

  • 模块 { HuskarUI.Basic }

  • 继承自 { Rectangle }


支持的代理:

  • winNavButtonsDelegate: Component 窗口导航按钮代理

  • winIconDelegate: Component 窗口图标代理

  • winTitleDelegate: Component 窗口标题代理

  • winPresetButtonsDelegate: Component 窗口预设按钮代理(默认为主题切换&置顶按钮)

  • winExtraButtonsDelegate: Component 窗口额外按钮代理(默认为空)

  • winButtonsDelegate: Component 窗口按钮代理(默认最小化&最大化&关闭按钮)


支持的属性:

属性名类型默认值描述
targetWindowvarnull目标窗口
windowAgentHusWindowAgentnull无边框窗口代理(通常不使用)
layoutDirectionenumQt.LeftToRight布局方向
winIconurl''窗口图标
winIconWidthreal22窗口图标宽度
winIconHeightreal22窗口图标高度
showWinIconbooltrue窗口图标是否可见
winTitlestring''窗口标题
winTitleFontfont-窗口标题字体
winTitleColorcolor-窗口标题颜色
showWinTitlebooltrue窗口标题是否可见
showReturnButtonboolfalse返回按钮是否可见
showThemeButtonboolfalse主题按钮是否可见
topButtonCheckedboolfalse置顶按钮是否默认选中
showTopButtonboolfalse置顶按钮是否可见
showMinimizeButtonbooltrue最小化按钮是否可见
showMaximizeButtonbooltrue最大化按钮是否可见
showCloseButtonbooltrue关闭按钮是否可见
returnCallbackfunctionfunction()按下返回按钮时回调
themeCallbackfunctionfunction()按下主题按钮时回调
topCallbackfunctionfunction(checked)按下置顶按钮时回调
minimizeCallbackfunctionfunction()按下最小化按钮时回调
maximizeCallbackfunctionfunction()按下最大化按钮时回调
closeCallbackfunctionfunction()按下关闭按钮时回调
contentDescriptionstring-内容描述(提高可用性)

支持的函数:

  • addInteractionItem(item: var) 添加交互项 item (当交互项覆盖标题栏时需要使用)

  • removeInteractionItem(item: var) 删除交互项 item