PySide6.QtGui.QStyleHints¶

class QStyleHints¶

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

概要¶

属性¶

• colorSchemeᅟ - 应用程序使用的配色方案

• contextMenuTriggerᅟ - 用于触发上下文菜单事件的鼠标事件

• cursorFlashTimeᅟ - 文本光标的闪烁（眨眼）时间，以毫秒为单位

• fontSmoothingGammaᅟ - 用于字体平滑的伽马值

• keyboardAutoRepeatRateᅟ - 当按住一个键时，自动生成额外重复按键事件的速率，单位为每秒事件数。请改用keyboardAutoRepeatRateF()

• keyboardAutoRepeatRateFᅟ - 速率，以每秒事件为单位，如果按住某个键，将自动生成额外的重复按键

• keyboardInputIntervalᅟ - 区分按键和连续两次按键的时间限制，以毫秒为单位

• mouseDoubleClickDistanceᅟ - 鼠标在两次连续点击之间可以移动的最大距离（以像素为单位），并且仍然被检测为双击

• mouseDoubleClickIntervalᅟ - 区分双击和两次连续鼠标点击的时间限制（以毫秒为单位）

• mousePressAndHoldIntervalᅟ - 激活按下并保持的时间限制，以毫秒为单位

• mouseQuickSelectionThresholdᅟ - QLineEdit中的快速选择鼠标阈值

• passwordMaskCharacterᅟ - 用于在密码模式下屏蔽文本输入字段中键入字符的字符

• passwordMaskDelayᅟ - 在密码模式下，输入的字母在文本输入字段中以未遮蔽状态显示的时间，以毫秒为单位

• setFocusOnTouchReleaseᅟ - 应该在焦点对象上设置输入焦点的事件

• showIsFullScreenᅟ - 平台是否默认全屏窗口

• showIsMaximizedᅟ - 平台是否默认最大化窗口

• showShortcutsInContextMenusᅟ - 如果平台通常在上下文菜单中显示快捷键序列，则为True，否则为False

• singleClickActivationᅟ - 项目是通过单击还是双击激活

• startDragDistanceᅟ - 鼠标在按下按钮后必须移动的距离（以像素为单位），然后才会开始拖放操作

• startDragTimeᅟ - 鼠标按钮必须按住的时间，以毫秒为单位，然后才能开始拖放操作

• startDragVelocityᅟ - 鼠标在按住按钮的情况下移动的速度限制，以每秒像素为单位，用于开始拖放操作。值为0表示没有此类限制

• tabFocusBehaviorᅟ - 按下Tab键时的焦点行为

• touchDoubleTapDistanceᅟ - 手指在两次连续点击之间可以移动的最大距离（以像素为单位），并且仍然被检测为双击

• useHoverEffectsᅟ - 是否使用UI元素的悬停效果

• useRtlExtensionsᅟ - 书写方向

• wheelScrollLinesᅟ - 每次滚轮点击默认滚动的行数

方法¶

• def colorScheme()

• def contextMenuTrigger()

• def cursorFlashTime()

• def fontSmoothingGamma()

• def keyboardAutoRepeatRate()

• def keyboardAutoRepeatRateF()

• def keyboardInputInterval()

• def mouseDoubleClickDistance()

• def mouseDoubleClickInterval()

• def mousePressAndHoldInterval()

• def mouseQuickSelectionThreshold()

• def passwordMaskCharacter()

• def passwordMaskDelay()

• def setColorScheme()

• def setContextMenuTrigger()

• def setCursorFlashTime()

• def setFocusOnTouchRelease()

• def setKeyboardInputInterval()

• def setMouseDoubleClickInterval()

• def setMousePressAndHoldInterval()

• def setMouseQuickSelectionThreshold()

• def setShowShortcutsInContextMenus()

• def setStartDragDistance()

• def setStartDragTime()

• def setTabFocusBehavior()

• def setUseHoverEffects()

• def setWheelScrollLines()

• def showIsFullScreen()

• def showIsMaximized()

• def showShortcutsInContextMenus()

• def singleClickActivation()

• def startDragDistance()

• def startDragTime()

• def startDragVelocity()

• def tabFocusBehavior()

• def touchDoubleTapDistance()

• def unsetColorScheme()

• def useHoverEffects()

• def useRtlExtensions()

• def wheelScrollLines()

信号¶

• def colorSchemeChanged()

• def contextMenuTriggerChanged()

• def cursorFlashTimeChanged()

• def keyboardInputIntervalChanged()

• def mouseDoubleClickIntervalChanged()

• def mousePressAndHoldIntervalChanged()

• def mouseQuickSelectionThresholdChanged()

• def showShortcutsInContextMenusChanged()

• def startDragDistanceChanged()

• def startDragTimeChanged()

• def tabFocusBehaviorChanged()

• def useHoverEffectsChanged()

• def wheelScrollLinesChanged()

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述¶

此类的对象，从QGuiApplication获取，提供了对当前平台某些全局用户界面参数的访问。

大多数设置的访问是只读的。平台本身通常为用户提供了调整这些参数的方式。自定义用户界面组件的作者应阅读相关设置，以使组件表现出与其他组件相同的行为和感觉。

另请参阅

styleHints()

注意

当使用from __feature__ import true_property时，属性可以直接使用，否则通过访问器函数使用。

property colorSchemeᅟ: Qt.ColorScheme¶

此属性保存应用程序使用的颜色方案。

默认情况下，这遵循系统的默认配色方案（也称为外观），并在系统配色方案更改时（例如在黄昏或黎明时）发生变化。将配色方案设置为显式值将覆盖系统设置，并忽略系统配色方案的任何更改。然而，这样做是对系统的一个提示，并非所有平台都支持覆盖配色方案。

重置此属性或将其设置为Qt::ColorScheme::Unknown，将移除覆盖并使应用程序再次遵循系统默认值。属性值将更改为系统当前的颜色方案。

当此属性更改时，Qt 将读取系统调色板并更新默认调色板，但不会覆盖应用程序显式设置的调色板条目。当 colorSchemeChange() 信号发出时，旧调色板仍然有效。

应选择特定于应用程序的颜色，以便与有效调色板良好配合，同时考虑当前的颜色方案。当有效调色板发生变化时，为了更新特定于应用程序的颜色，请处理PaletteChange或ApplicationPaletteChange事件。

另请参阅

PaletteChange

Access functions:

• colorScheme()

• setColorScheme()

• unsetColorScheme()

• 信号 colorSchemeChanged()

property contextMenuTriggerᅟ: Qt.ContextMenuTrigger¶

此属性保存用于触发上下文菜单事件的鼠标事件。

在UNIX系统上，默认是在鼠标按钮按下事件时显示上下文菜单，而在Windows上则是在鼠标按钮释放事件时显示。此属性可用于覆盖默认的平台行为。

注意

开发人员必须非常小心地使用此属性，因为它会改变用户在他们运行的平台上期望的默认交互模式。

另请参阅

ContextMenuTrigger

Access functions:

• contextMenuTrigger()

• setContextMenuTrigger()

• 信号 contextMenuTriggerChanged()

property cursorFlashTimeᅟ: int¶

此属性保存文本光标的闪烁（眨眼）时间，单位为毫秒。

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

Access functions:

• cursorFlashTime()

• 信号 cursorFlashTimeChanged()

property fontSmoothingGammaᅟ: float¶

此属性保存用于字体平滑的伽马值。

Access functions:

• fontSmoothingGamma()

property keyboardAutoRepeatRateᅟ: int¶

此属性保存了每秒生成的事件速率，如果按住某个键，将自动生成额外的重复按键。请改用keyboardAutoRepeatRateF()。

Access functions:

• keyboardAutoRepeatRate()

property keyboardAutoRepeatRateFᅟ: float¶

此属性保存速率，以每秒事件为单位，如果按住某个键，将自动生成额外的重复按键。

Access functions:

• keyboardAutoRepeatRateF()

property keyboardInputIntervalᅟ: int¶

此属性保存时间限制，以毫秒为单位，用于区分一次按键和两次连续按键。

Access functions:

• keyboardInputInterval()

• 信号 keyboardInputIntervalChanged()

property mouseDoubleClickDistanceᅟ: int¶

此属性表示鼠标在两次连续点击之间可以移动的最大距离（以像素为单位），并且仍然可以检测为双击。

Access functions:

• mouseDoubleClickDistance()

property mouseDoubleClickIntervalᅟ: int¶

此属性以毫秒为单位保存时间限制，用于区分双击和两次连续的鼠标点击。

Access functions:

• mouseDoubleClickInterval()

• 信号 mouseDoubleClickIntervalChanged()

property mousePressAndHoldIntervalᅟ: int¶

此属性保存激活长按的时间限制，单位为毫秒。

Access functions:

• mousePressAndHoldInterval()

• 信号 mousePressAndHoldIntervalChanged()

property mouseQuickSelectionThresholdᅟ: int¶

此属性保存QLineEdit中的快速选择鼠标阈值。

此属性定义了在正常的QLineEdit文本选择过程中，鼠标光标应沿y轴移动多少以触发快速选择。

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

Access functions:

• mouseQuickSelectionThreshold()

• setMouseQuickSelectionThreshold()

• 信号 mouseQuickSelectionThresholdChanged()

property passwordMaskCharacterᅟ: QChar¶

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

Access functions:

• passwordMaskCharacter()

property passwordMaskDelayᅟ: int¶

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

Access functions:

• passwordMaskDelay()

property setFocusOnTouchReleaseᅟ: bool¶

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

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

Access functions:

• setFocusOnTouchRelease()

property showIsFullScreenᅟ: bool¶

此属性表示平台是否默认使用全屏窗口。

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

注意

平台可能仍会选择以非全屏方式显示某些窗口，例如弹出窗口或对话框。此属性仅报告默认行为。

另请参阅

show() showIsMaximized()

Access functions:

• showIsFullScreen()

property showIsMaximizedᅟ: bool¶

此属性表示平台是否默认最大化窗口。

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

注意

平台可能仍然选择以非最大化方式显示某些窗口，例如弹出窗口或对话框。此属性仅报告默认行为。

另请参阅

show() showIsFullScreen()

Access functions:

• showIsMaximized()

property showShortcutsInContextMenusᅟ: bool¶

如果平台通常在上下文菜单中显示快捷键序列，则此属性为 true，否则为 false。

自 Qt 5.13 起，可以使用 setShowShortcutsInContextMenus() 函数来覆盖平台的默认设置。

另请参阅

AA_DontShowShortcutsInContextMenus

Access functions:

• showShortcutsInContextMenus()

• setShowShortcutsInContextMenus()

• 信号 showShortcutsInContextMenusChanged()

property singleClickActivationᅟ: bool¶

此属性决定项目是通过单击还是双击激活。

如果项目应通过单击激活，则此属性为true，如果应通过双击激活，则为false。

Access functions:

• singleClickActivation()

property startDragDistanceᅟ: int¶

警告

本节包含从C++自动翻译到Python的代码片段，可能包含错误。

此属性保存鼠标在按住按钮的情况下必须移动的距离（以像素为单位），然后才能开始拖放操作。

如果您的应用程序支持拖放操作，并且希望在用户按住按钮移动光标一定距离后开始拖放操作，您应该将此属性的值用作所需的最小距离。

例如，如果点击的鼠标位置存储在 startPos 中，而当前位置（例如在鼠标移动事件中）是 currentPos，你可以通过如下代码判断是否应该开始拖动：

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

另请参阅

startDragTime 拖放

Access functions:

• startDragDistance()

• 信号 startDragDistanceChanged()

property startDragTimeᅟ: int¶

此属性保存鼠标按钮必须按住的时间，以毫秒为单位，然后才能开始拖放操作。

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

另请参阅

startDragDistance 拖放

Access functions:

• startDragTime()

• 信号 startDragTimeChanged()

property startDragVelocityᅟ: int¶

此属性保存鼠标在按住按钮的情况下移动的速度限制，以每秒像素为单位，以便开始拖放操作。值为0表示没有这样的限制。

另请参阅

startDragDistance 拖放

Access functions:

• startDragVelocity()

property tabFocusBehaviorᅟ: Qt.TabFocusBehavior¶

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

注意

不要在QML中绑定这个值，因为变更通知信号尚未实现。

Access functions:

• tabFocusBehavior()

• 信号 tabFocusBehaviorChanged()

property touchDoubleTapDistanceᅟ: int¶

此属性表示手指在两次连续点击之间可以移动的最大距离（以像素为单位），并且仍然可以检测为双击。

Access functions:

• touchDoubleTapDistance()

property useHoverEffectsᅟ: bool¶

此属性决定UI元素是否使用悬停效果。

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

Access functions:

• useHoverEffects()

• setUseHoverEffects()

• 信号 useHoverEffectsChanged()

property useRtlExtensionsᅟ: bool¶

此属性保存书写方向。

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

Access functions:

• useRtlExtensions()

property wheelScrollLinesᅟ: int¶

此属性保存每次滚轮点击默认滚动的行数。

Access functions:

• wheelScrollLines()

• 信号 wheelScrollLinesChanged()

colorScheme()¶

Return type:

ColorScheme

另请参阅

setColorScheme()

属性 colorSchemeᅟ 的获取器。

colorSchemeChanged(colorScheme)¶

Parameters:

colorScheme – ColorScheme

属性 colorSchemeᅟ 的通知信号。

contextMenuTrigger()¶

Return type:

ContextMenuTrigger

另请参阅

setContextMenuTrigger()

属性 contextMenuTriggerᅟ 的获取器。

contextMenuTriggerChanged(contextMenuTrigger)¶

Parameters:

contextMenuTrigger – ContextMenuTrigger

属性 contextMenuTriggerᅟ 的通知信号。

cursorFlashTime()¶

Return type:

整数

属性 cursorFlashTimeᅟ 的获取器。

cursorFlashTimeChanged(cursorFlashTime)¶

Parameters:

cursorFlashTime – int

属性 cursorFlashTimeᅟ 的通知信号。

fontSmoothingGamma()¶

Return type:

浮点数

属性 fontSmoothingGammaᅟ 的获取器。

keyboardAutoRepeatRate()¶

Return type:

整数

注意

此函数已弃用。

属性 keyboardAutoRepeatRateᅟ 的获取器。

keyboardAutoRepeatRateF()¶

Return type:

浮点数

属性 keyboardAutoRepeatRateFᅟ 的获取器。

keyboardInputInterval()¶

Return type:

整数

属性 keyboardInputIntervalᅟ 的获取器。

keyboardInputIntervalChanged(keyboardInputInterval)¶

Parameters:

keyboardInputInterval – int

属性 keyboardInputIntervalᅟ 的通知信号。

mouseDoubleClickDistance()¶

Return type:

整数

属性 mouseDoubleClickDistanceᅟ 的获取器。

mouseDoubleClickInterval()¶

Return type:

整数

属性 mouseDoubleClickIntervalᅟ 的获取器。

mouseDoubleClickIntervalChanged(mouseDoubleClickInterval)¶

Parameters:

mouseDoubleClickInterval – int

属性 mouseDoubleClickIntervalᅟ 的通知信号。

mousePressAndHoldInterval()¶

Return type:

整数

属性 mousePressAndHoldIntervalᅟ 的获取器。

mousePressAndHoldIntervalChanged(mousePressAndHoldInterval)¶

Parameters:

mousePressAndHoldInterval – int

属性 mousePressAndHoldIntervalᅟ 的通知信号。

mouseQuickSelectionThreshold()¶

Return type:

整数

属性 mouseQuickSelectionThresholdᅟ 的获取器。

mouseQuickSelectionThresholdChanged(threshold)¶

Parameters:

threshold – int

属性 mouseQuickSelectionThresholdᅟ 的通知信号。

passwordMaskCharacter()¶

Return type:

QChar

属性 passwordMaskCharacterᅟ 的获取器。

passwordMaskDelay()¶

Return type:

整数

属性 passwordMaskDelayᅟ 的获取器。

setColorScheme(scheme)¶

Parameters:

方案 – ColorScheme

将应用程序使用的颜色方案设置为显式的scheme，如果scheme是Qt::ColorScheme::Unknown，则恢复为系统的当前颜色方案。

另请参阅

colorScheme()

属性 colorSchemeᅟ 的设置器。

setContextMenuTrigger(contextMenuTrigger)¶

Parameters:

contextMenuTrigger – ContextMenuTrigger

另请参阅

contextMenuTrigger()

属性 contextMenuTriggerᅟ 的设置器。

setCursorFlashTime(cursorFlashTime)¶

Parameters:

cursorFlashTime – int

setFocusOnTouchRelease()¶

Return type:

布尔

属性 setFocusOnTouchReleaseᅟ 的获取器。

setKeyboardInputInterval(keyboardInputInterval)¶

Parameters:

keyboardInputInterval – int

setMouseDoubleClickInterval(mouseDoubleClickInterval)¶

Parameters:

mouseDoubleClickInterval – int

setMousePressAndHoldInterval(mousePressAndHoldInterval)¶

Parameters:

mousePressAndHoldInterval – int

setMouseQuickSelectionThreshold(threshold)¶

Parameters:

threshold – int

属性 mouseQuickSelectionThresholdᅟ 的设置器。

setShowShortcutsInContextMenus(showShortcutsInContextMenus)¶

Parameters:

showShortcutsInContextMenus – bool

另请参阅

showShortcutsInContextMenus()

属性 showShortcutsInContextMenusᅟ 的设置器。

setStartDragDistance(startDragDistance)¶

Parameters:

startDragDistance – int

setStartDragTime(startDragTime)¶

Parameters:

startDragTime – int

setTabFocusBehavior(tabFocusBehavior)¶

Parameters:

tabFocusBehavior – TabFocusBehavior

setUseHoverEffects(useHoverEffects)¶

Parameters:

useHoverEffects – 布尔值

另请参阅

useHoverEffects()

属性 useHoverEffectsᅟ 的设置器。

setWheelScrollLines(scrollLines)¶

Parameters:

scrollLines – int

showIsFullScreen()¶

Return type:

布尔

属性 showIsFullScreenᅟ 的获取器。

showIsMaximized()¶

Return type:

布尔

属性 showIsMaximizedᅟ 的获取器。

showShortcutsInContextMenus()¶

Return type:

布尔

另请参阅

setShowShortcutsInContextMenus()

属性 showShortcutsInContextMenusᅟ 的获取器。

showShortcutsInContextMenusChanged(arg__1)¶

Parameters:

arg__1 – 布尔值

属性 showShortcutsInContextMenusᅟ 的通知信号。

singleClickActivation()¶

Return type:

布尔

属性 singleClickActivationᅟ 的获取器。

startDragDistance()¶

Return type:

整数

属性 startDragDistanceᅟ 的获取器。

startDragDistanceChanged(startDragDistance)¶

Parameters:

startDragDistance – int

属性 startDragDistanceᅟ 的通知信号。

startDragTime()¶

Return type:

整数

属性 startDragTimeᅟ 的获取器。

startDragTimeChanged(startDragTime)¶

Parameters:

startDragTime – int

属性 startDragTimeᅟ 的通知信号。

startDragVelocity()¶

Return type:

整数

属性 startDragVelocityᅟ 的获取器。

tabFocusBehavior()¶

Return type:

TabFocusBehavior

属性 tabFocusBehaviorᅟ 的获取器。

tabFocusBehaviorChanged(tabFocusBehavior)¶

Parameters:

tabFocusBehavior – TabFocusBehavior

属性 tabFocusBehaviorᅟ 的通知信号。

touchDoubleTapDistance()¶

Return type:

整数

属性 touchDoubleTapDistanceᅟ 的获取器。

unsetColorScheme()¶

将配色方案恢复为系统的当前配色方案。

属性 colorSchemeᅟ 的重置功能。

useHoverEffects()¶

Return type:

布尔

另请参阅

setUseHoverEffects()

属性 useHoverEffectsᅟ 的获取器。

useHoverEffectsChanged(useHoverEffects)¶

Parameters:

useHoverEffects – 布尔值

属性 useHoverEffectsᅟ 的通知信号。

useRtlExtensions()¶

Return type:

布尔

属性 useRtlExtensionsᅟ 的获取器。

wheelScrollLines()¶

Return type:

整数

属性 wheelScrollLinesᅟ 的获取器。

wheelScrollLinesChanged(scrollLines)¶

Parameters:

scrollLines – int

属性 wheelScrollLinesᅟ 的通知信号。