QStyleHints 类
QStyleHints 类包含平台特定的提示和设置。更多信息...
头文件 | #include <QStyleHints> |
CMake | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
qmake | QT += gui |
继承 | QObject |
属性
|
|
公共函数
Qt::ColorScheme | colorScheme() const |
int | cursorFlashTime() const |
qreal | fontSmoothingGamma() const |
qreal | keyboardAutoRepeatRateF() const |
int | keyboardInputInterval() 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 颜色方案) |
[只读]
cursorFlashTime : const int
此属性存储了文本光标的闪烁(闪烁)时间(以毫秒为单位)。
闪烁时间是指显示、反转和恢复光标显示的时间。通常文本光标显示一半的闪烁时间,然后隐藏相同的时间。
访问函数
int | cursorFlashTime() const |
通知信号
void | cursorFlashTimeChanged(int cursorFlashTime) |
[只读]
fontSmoothingGamma : const qreal
此属性存储了用于字体平滑的伽玛值。
访问函数
qreal | fontSmoothingGamma() const |
[只读,自6.5以来]
keyboardAutoRepeatRateF : const qreal
此属性存储了在键被按下的情况下,如果按下一个键,将自动生成额外重复按键事件的速率,以事件每秒为单位。
此属性自 Qt 6.5 版本中引入。
访问函数
qreal | keyboardAutoRepeatRateF() const |
[只读]
keyboardInputInterval : const int
此属性存储了区分按键和两个连续按键的时间限制(以毫秒为单位)。
访问函数
int | keyboardInputInterval() const |
通知信号
void | keyboardInputIntervalChanged(int keyboardInputInterval) |
[只读]
mouseDoubleClickDistance : const int
此属性存储了鼠标在两次连续鼠标单击之间的最大移动距离(以像素为单位),使其仍然被检测为双击。
访问函数
int | mouseDoubleClickDistance() const |
[只读]
mouseDoubleClickInterval : const int
此属性存储了区分双击和两次连续鼠标单击的时间限制(以毫秒为单位)。
访问函数
int | mouseDoubleClickInterval() const |
通知信号
void | mouseDoubleClickIntervalChanged(int mouseDoubleClickInterval) |
[只读]
mousePressAndHoldInterval : const int
此属性存储了激活按住的时间限制(以毫秒为单位)。
访问函数
int | mousePressAndHoldInterval() const |
通知信号
void | mousePressAndHoldIntervalChanged(int mousePressAndHoldInterval) |
mouseQuickSelectionThreshold : const int
QLineEdit中的快速选择鼠标阈值。
此属性定义了鼠标光标在y轴上移动多少才能在正常QLineEdit文本选择期间触发快速选择。
如果属性值小于或等于0,则禁用快速选择功能。
访问函数
int | mouseQuickSelectionThreshold() const |
通知信号
void | mouseQuickSelectionThresholdChanged(int threshold) |
[只读]
passwordMaskCharacter : const QChar
此属性存储了用于在密码模式下屏蔽文本输入字段的字符。
访问函数
QChar | passwordMaskCharacter() const |
[只读]
passwordMaskDelay : const int
此属性保存了以毫秒为单位,在密码模式下文本输入字段中显示未加密字母的时间。
访问函数
int | passwordMaskDelay() const |
[只读]
setFocusOnTouchRelease : const bool
此属性保存了应在焦点对象上设置输入焦点的事件。
如果应在触摸/鼠标释放后使焦点对象(行编辑等)接收输入焦点,则此属性为 true
。在触摸平台上这是正常行为。在桌面平台上,标准是在触摸/鼠标按下的同时设置焦点。
访问函数
bool | setFocusOnTouchRelease() const |
[只读]
showIsFullScreen : const bool
此属性保存了平台默认是否为全屏窗口。
如果平台默认窗口为全屏,则此属性为 true
,否则为 false
。
注意:平台可以选择显示某些窗口非全屏,例如弹出窗口或对话框。此属性只报告默认行为。
访问函数
bool | showIsFullScreen() const |
另请参阅 QWindow::show() 和 showIsMaximized。
[只读]
showIsMaximized : const bool
此属性保存了平台默认是否为最大化窗口。
如果平台默认窗口为最大化,则此属性为 true
,否则为 false
。
注意:平台可以选择显示某些窗口非最大化,例如弹出窗口或对话框。此属性只报告默认行为。
访问函数
bool | showIsMaximized() const |
另请参阅 QWindow::show() 和 showIsFullScreen。
showShortcutsInContextMenus : bool
如果平台通常在上下文菜单中显示快捷方式键序列,则此为 true
,否则为 false
。
自 Qt 5.13 以来,可以使用 setShowShortcutsInContextMenus() 函数来覆盖平台默认值。
访问函数
bool | showShortcutsInContextMenus() const |
void | setShowShortcutsInContextMenus(bool showShortcutsInContextMenus) |
通知信号
void | showShortcutsInContextMenusChanged(bool) |
另请参阅 Qt::AA_DontShowShortcutsInContextMenus。
[只读]
singleClickActivation : const bool
此属性保存了项目是通过单击还是双击激活。
如果项目应通过单击激活,则此属性为 true
,如果它们应通过双击激活,则 false
。
访问函数
bool | singleClickActivation() const |
[只读]
startDragDistance : const int
此属性保存了在拖放操作开始之前,鼠标必须按下并移动的距离(以像素为单位)。
如果在您的应用程序中支持拖放,并且需要在用户按下鼠标按钮并移动光标一定距离后开始拖放操作,您应该使用该属性的值作为所需的最低距离。
例如,如果单击鼠标的位置存储在 startPos
中,而当前的位置(例如在鼠标移动事件中)为 currentPos
,可以使用如下代码判断是否应该开始拖放
if ((startPos - currentPos).manhattanLength() >= QApplication::startDragDistance()) startTheDrag();
访问函数
int | startDragDistance() const |
通知信号
void | startDragDistanceChanged(int startDragDistance) |
参见startDragTime、QPoint::manhattanLength() 和 拖放。
[只读]
startDragTime : const int
此属性保存开始拖放操作之前鼠标按钮必须按住的时间(以毫秒为单位)。
如果在您的应用程序中支持拖放,并且希望用户按下鼠标按钮一定时间后开始拖放操作,则应使用此属性的值作为延迟。
访问函数
int | startDragTime() const |
通知信号
void | startDragTimeChanged(int startDragTime) |
参见startDragDistance 和 拖放。
[只读]
startDragVelocity : const int
此属性保存鼠标按钮按下时鼠标移动开始拖放操作的速度限制(以像素/秒为单位)。值为0表示没有此限制。
访问函数
int | startDragVelocity() const |
参见startDragDistance 和 拖放。
[只读]
tabFocusBehavior : const Qt::TabFocusBehavior
此属性保存按下制表键时的焦点行为。
注意:不要在QML中绑定此值,因为尚未实现更改通知信号。
访问函数
Qt::TabFocusBehavior | tabFocusBehavior() const |
通知信号
void | tabFocusBehaviorChanged(Qt::TabFocusBehavior tabFocusBehavior) |
[只读]
touchDoubleTapDistance : const int
此属性保存指头在两个连续点击之间的最大移动距离(以像素为单位),仍将被检测为双击。
访问函数
int | touchDoubleTapDistance() const |
useHoverEffects : bool
此属性表示UI元素是否使用悬停效果。
如果UI元素应该使用悬停效果,则此属性为 true
。这是桌面平台上带有鼠标指针的标准行为,而在触摸平台上可以避免传递悬停事件的开销。
访问函数
bool | useHoverEffects() const |
void | setUseHoverEffects(bool useHoverEffects) |
通知信号
void | useHoverEffectsChanged(bool useHoverEffects) |
[只读]
useRtlExtensions : const bool
此属性保存书写方向。
如果启用了从右到左的书写方向,则此属性为 true
,否则为 false
。
访问函数
bool | useRtlExtensions() const |
[只读]
wheelScrollLines : const int
默认情况下,每次滚轮点击要滚动多少行。
访问函数
int | wheelScrollLines() const |
通知信号
void | wheelScrollLinesChanged(int scrollLines) |
© 2024 The Qt Company Ltd. 本文档中的文档贡献归各自所有者所有。本提供的文档是在免费软件基金会发布的GNU免费文档许可协议第1.3版的条款下许可的。Qt及其相关标志是芬兰及/或世界其它地区的The Qt Company Ltd.的商标。所有其他商标是它们各自所有者的财产。