QStyleHints 类

QStyleHints 类包含平台特定的提示和设置。更多信息...

头文件 #include <QStyleHints>
CMakefind_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmakeQT += gui
继承 QObject

属性

公共函数

Qt::ColorSchemecolorScheme() const
intcursorFlashTime() const
qrealfontSmoothingGamma() const
qrealkeyboardAutoRepeatRateF() const
intkeyboardInputInterval() const
int鼠标双击距离() const
int鼠标双击间隔() const
int鼠标按住间隔() const
int鼠标快速选择阈值() const
QChar密码掩码字符() const
int密码掩码延迟() const
bool设置触摸释放时聚焦() const
void设置在上下文菜单中显示快捷键(bool showShortcutsInContextMenus)
void设置使用悬停效果(bool useHoverEffects)
bool显示全屏状态() const
bool显示最大化状态() const
bool显示在上下文菜单中显示快捷键() const
bool单次点击激活() const
int开始拖拽距离() const
int开始拖拽时间() const
int开始拖拽速度() const
Qt::TabFocusBehavior标签页焦点行为() const
int触摸双击距离() const
bool使用悬停效果() const
bool使用右到左扩展() const
int滚轮滚动行数() const

信号

void颜色方案改变(Qt::ColorScheme 颜色方案)
void光标闪烁时间改变(int 光标闪烁时间)
void键盘输入间隔改变(int 键盘输入间隔)
void鼠标双击间隔改变(int 鼠标双击间隔)
void鼠标按住间隔改变(int 鼠标按住间隔)
void鼠标快速选择阈值改变(int 阈值)
void在上下文菜单中显示快捷键改变(bool)
void开始拖拽距离改变(int 开始拖拽距离)
void开始拖拽时间改变(int 开始拖拽时间)
void标签页焦点行为改变(Qt::TabFocusBehavior 标签页焦点行为)
void使用悬停效果改变(bool 使用悬停效果)
void滚轮滚动行数改变(int 滚动行数)

详细描述

此类的对象是通过对QGuiApplication的访问获得的,提供对当前平台某些全局用户界面参数的访问。

大部分设置仅可读。平台通常会为用户提供方法来调整这些参数。自定义用户界面组件的作者应该读取相关设置,以便组件能够表现出与其他组件相同的行为和感觉。

参见QGuiApplication::styleHints

属性文档

[只读,自 6.5 版本起] 颜色方案 : const Qt::ColorScheme

该属性存储平台主题的颜色方案。

此属性自 Qt 6.5 版本中引入。

访问函数

Qt::ColorScheme颜色方案() const

通知信号

void颜色方案改变(Qt::ColorScheme 颜色方案)

参见Qt::ColorScheme

[只读] cursorFlashTime : const int

此属性存储了文本光标的闪烁(闪烁)时间(以毫秒为单位)。

闪烁时间是指显示、反转和恢复光标显示的时间。通常文本光标显示一半的闪烁时间,然后隐藏相同的时间。

访问函数

intcursorFlashTime() const

通知信号

voidcursorFlashTimeChanged(int cursorFlashTime)

[只读] fontSmoothingGamma : const qreal

此属性存储了用于字体平滑的伽玛值。

访问函数

qrealfontSmoothingGamma() const

[只读,自6.5以来] keyboardAutoRepeatRateF : const qreal

此属性存储了在键被按下的情况下,如果按下一个键,将自动生成额外重复按键事件的速率,以事件每秒为单位。

此属性自 Qt 6.5 版本中引入。

访问函数

qrealkeyboardAutoRepeatRateF() const

[只读] keyboardInputInterval : const int

此属性存储了区分按键和两个连续按键的时间限制(以毫秒为单位)。

访问函数

intkeyboardInputInterval() const

通知信号

voidkeyboardInputIntervalChanged(int keyboardInputInterval)

[只读] mouseDoubleClickDistance : const int

此属性存储了鼠标在两次连续鼠标单击之间的最大移动距离(以像素为单位),使其仍然被检测为双击。

访问函数

intmouseDoubleClickDistance() const

[只读] mouseDoubleClickInterval : const int

此属性存储了区分双击和两次连续鼠标单击的时间限制(以毫秒为单位)。

访问函数

intmouseDoubleClickInterval() const

通知信号

voidmouseDoubleClickIntervalChanged(int mouseDoubleClickInterval)

[只读] mousePressAndHoldInterval : const int

此属性存储了激活按住的时间限制(以毫秒为单位)。

访问函数

intmousePressAndHoldInterval() const

通知信号

voidmousePressAndHoldIntervalChanged(int mousePressAndHoldInterval)

mouseQuickSelectionThreshold : const int

QLineEdit中的快速选择鼠标阈值。

此属性定义了鼠标光标在y轴上移动多少才能在正常QLineEdit文本选择期间触发快速选择。

如果属性值小于或等于0,则禁用快速选择功能。

访问函数

intmouseQuickSelectionThreshold() const

通知信号

voidmouseQuickSelectionThresholdChanged(int threshold)

[只读] passwordMaskCharacter : const QChar

此属性存储了用于在密码模式下屏蔽文本输入字段的字符。

访问函数

QCharpasswordMaskCharacter() const

[只读] passwordMaskDelay : const int

此属性保存了以毫秒为单位,在密码模式下文本输入字段中显示未加密字母的时间。

访问函数

intpasswordMaskDelay() const

[只读] setFocusOnTouchRelease : const bool

此属性保存了应在焦点对象上设置输入焦点的事件。

如果应在触摸/鼠标释放后使焦点对象(行编辑等)接收输入焦点,则此属性为 true。在触摸平台上这是正常行为。在桌面平台上,标准是在触摸/鼠标按下的同时设置焦点。

访问函数

boolsetFocusOnTouchRelease() const

[只读] showIsFullScreen : const bool

此属性保存了平台默认是否为全屏窗口。

如果平台默认窗口为全屏,则此属性为 true,否则为 false

注意:平台可以选择显示某些窗口非全屏,例如弹出窗口或对话框。此属性只报告默认行为。

访问函数

boolshowIsFullScreen() const

另请参阅 QWindow::show() 和 showIsMaximized

[只读] showIsMaximized : const bool

此属性保存了平台默认是否为最大化窗口。

如果平台默认窗口为最大化,则此属性为 true,否则为 false

注意:平台可以选择显示某些窗口非最大化,例如弹出窗口或对话框。此属性只报告默认行为。

访问函数

boolshowIsMaximized() const

另请参阅 QWindow::show() 和 showIsFullScreen

showShortcutsInContextMenus : bool

如果平台通常在上下文菜单中显示快捷方式键序列,则此为 true,否则为 false

自 Qt 5.13 以来,可以使用 setShowShortcutsInContextMenus() 函数来覆盖平台默认值。

访问函数

boolshowShortcutsInContextMenus() const
voidsetShowShortcutsInContextMenus(bool showShortcutsInContextMenus)

通知信号

voidshowShortcutsInContextMenusChanged(bool)

另请参阅 Qt::AA_DontShowShortcutsInContextMenus

[只读] singleClickActivation : const bool

此属性保存了项目是通过单击还是双击激活。

如果项目应通过单击激活,则此属性为 true,如果它们应通过双击激活,则 false

访问函数

boolsingleClickActivation() const

[只读] startDragDistance : const int

此属性保存了在拖放操作开始之前,鼠标必须按下并移动的距离(以像素为单位)。

如果在您的应用程序中支持拖放,并且需要在用户按下鼠标按钮并移动光标一定距离后开始拖放操作,您应该使用该属性的值作为所需的最低距离。

例如,如果单击鼠标的位置存储在 startPos 中,而当前的位置(例如在鼠标移动事件中)为 currentPos,可以使用如下代码判断是否应该开始拖放

if ((startPos - currentPos).manhattanLength() >=
        QApplication::startDragDistance())
    startTheDrag();

访问函数

intstartDragDistance() const

通知信号

voidstartDragDistanceChanged(int startDragDistance)

参见startDragTimeQPoint::manhattanLength() 和 拖放

[只读] startDragTime : const int

此属性保存开始拖放操作之前鼠标按钮必须按住的时间(以毫秒为单位)。

如果在您的应用程序中支持拖放,并且希望用户按下鼠标按钮一定时间后开始拖放操作,则应使用此属性的值作为延迟。

访问函数

intstartDragTime() const

通知信号

voidstartDragTimeChanged(int startDragTime)

参见startDragDistance拖放

[只读] startDragVelocity : const int

此属性保存鼠标按钮按下时鼠标移动开始拖放操作的速度限制(以像素/秒为单位)。值为0表示没有此限制。

访问函数

intstartDragVelocity() const

参见startDragDistance拖放

[只读] tabFocusBehavior : const Qt::TabFocusBehavior

此属性保存按下制表键时的焦点行为。

注意:不要在QML中绑定此值,因为尚未实现更改通知信号。

访问函数

Qt::TabFocusBehaviortabFocusBehavior() const

通知信号

voidtabFocusBehaviorChanged(Qt::TabFocusBehavior tabFocusBehavior)

[只读] touchDoubleTapDistance : const int

此属性保存指头在两个连续点击之间的最大移动距离(以像素为单位),仍将被检测为双击。

访问函数

inttouchDoubleTapDistance() const

useHoverEffects : bool

此属性表示UI元素是否使用悬停效果。

如果UI元素应该使用悬停效果,则此属性为 true。这是桌面平台上带有鼠标指针的标准行为,而在触摸平台上可以避免传递悬停事件的开销。

访问函数

booluseHoverEffects() const
voidsetUseHoverEffects(bool useHoverEffects)

通知信号

voiduseHoverEffectsChanged(bool useHoverEffects)

[只读] useRtlExtensions : const bool

此属性保存书写方向。

如果启用了从右到左的书写方向,则此属性为 true,否则为 false

访问函数

booluseRtlExtensions() const

[只读] wheelScrollLines : const int

默认情况下,每次滚轮点击要滚动多少行。

访问函数

intwheelScrollLines() const

通知信号

voidwheelScrollLinesChanged(int scrollLines)

© 2024 The Qt Company Ltd. 本文档中的文档贡献归各自所有者所有。本提供的文档是在免费软件基金会发布的GNU免费文档许可协议第1.3版的条款下许可的。Qt及其相关标志是芬兰及/或世界其它地区的The Qt Company Ltd.的商标。所有其他商标是它们各自所有者的财产。