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 mouseDoubleClickDistance () const
int mouseDoubleClickInterval () const
int mousePressAndHoldInterval () const
int mouseQuickSelectionThreshold () const
QChar passwordMaskCharacter () const
int passwordMaskDelay () const
bool setFocusOnTouchRelease () const
void setShowShortcutsInContextMenus (bool showShortcutsInContextMenus )
void setUseHoverEffects (bool useHoverEffects )
bool showIsFullScreen () const
bool showIsMaximized () const
bool showShortcutsInContextMenus () const
bool singleClickActivation () const
int startDragDistance () const
int startDragTime () const
int startDragVelocity () const
Qt::TabFocusBehavior tabFocusBehavior () const
int touchDoubleTapDistance () const
bool useHoverEffects () const
bool useRtlExtensions () const
int wheelScrollLines () const

信号

void colorSchemeChanged (Qt::ColorScheme colorScheme )
void cursorFlashTimeChanged (int cursorFlashTime )
void keyboardInputIntervalChanged (int keyboardInputInterval )
void mouseDoubleClickIntervalChanged (int mouseDoubleClickInterval )
void mousePressAndHoldIntervalChanged (int mousePressAndHoldInterval )
void mouseQuickSelectionThresholdChanged (int threshold )
void showShortcutsInContextMenusChanged (bool)
void startDragDistanceChanged (int startDragDistance )
void startDragTimeChanged (int startDragTime )
void tabFocusBehaviorChanged (Qt::TabFocusBehavior tabFocusBehavior )
void useHoverEffectsChanged (bool useHoverEffects )
void wheelScrollLinesChanged (int scrollLines )

详细描述

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

Access to most settings is read only. The platform itself usually provides the user with ways to tune these parameters. Authors of custom user interface components should read relevant settings to allow the components to exhibit the same behavior and feel as other components.

另请参阅 QGuiApplication::styleHints ().

特性文档编制

[read-only, since 6.5] colorScheme : const Qt::ColorScheme

This property holds the color scheme of the platform theme.

该特性在 Qt 6.5 引入。

访问函数:

Qt::ColorScheme colorScheme () const

通知程序信号:

void colorSchemeChanged (Qt::ColorScheme colorScheme )

另请参阅 Qt::ColorScheme .

[read-only] cursorFlashTime : const int

This property holds the text cursor's flash (blink) time in milliseconds.

The flash time is the time used to display, invert and restore the caret display. Usually the text cursor is displayed for half the cursor flash time, then hidden for the same amount of time.

访问函数:

int cursorFlashTime () const

通知程序信号:

void cursorFlashTimeChanged (int cursorFlashTime )

[read-only] fontSmoothingGamma : const qreal

This property holds the gamma value used in font smoothing.

访问函数:

qreal fontSmoothingGamma () const

[read-only, since 6.5] keyboardAutoRepeatRateF : const qreal

This property holds the rate, in events per second, in which additional repeated key presses will automatically be generated if a key is being held down.

该特性在 Qt 6.5 引入。

访问函数:

qreal keyboardAutoRepeatRateF () const

[read-only] keyboardInputInterval : const int

此特性保持区分键按下和 2 次连续按下的时间限制 (以毫秒为单位)。

访问函数:

int keyboardInputInterval () const

通知程序信号:

void keyboardInputIntervalChanged (int keyboardInputInterval )

[read-only] mouseDoubleClickDistance : const int

This property holds the maximum distance, in pixels, that the mouse can be moved between two consecutive mouse clicks and still have it detected as a double-click

访问函数:

int mouseDoubleClickDistance () const

[read-only] mouseDoubleClickInterval : const int

此特性保持区分双击和 2 次连续鼠标点击的时间限制 (以毫秒为单位)。

访问函数:

int mouseDoubleClickInterval () const

通知程序信号:

void mouseDoubleClickIntervalChanged (int mouseDoubleClickInterval )

[read-only] mousePressAndHoldInterval : const int

This property holds the time limit in milliseconds that activates a press and hold.

访问函数:

int mousePressAndHoldInterval () const

通知程序信号:

void mousePressAndHoldIntervalChanged (int mousePressAndHoldInterval )

mouseQuickSelectionThreshold : const int

Quick selection mouse threshold in QLineEdit .

This property defines how much the mouse cursor should be moved along the y axis to trigger a quick selection during a normal QLineEdit text selection.

If the property value is less than or equal to 0, the quick selection feature is disabled.

访问函数:

int mouseQuickSelectionThreshold () const

通知程序信号:

void mouseQuickSelectionThresholdChanged (int threshold )

[read-only] passwordMaskCharacter : const QChar

This property holds the character used to mask the characters typed into text input fields in password mode.

访问函数:

QChar passwordMaskCharacter () const

[read-only] passwordMaskDelay : const int

This property holds the time, in milliseconds, a typed letter is displayed unshrouded in a text input field in password mode.

访问函数:

int passwordMaskDelay () const

[read-only] setFocusOnTouchRelease : const bool

This property holds the event that should set input focus on focus objects.

此特性是 true if focus objects (line edits etc) should receive input focus after a touch/mouse release. This is normal behavior on touch platforms. On desktop platforms, the standard is to set focus already on touch/mouse press.

访问函数:

bool setFocusOnTouchRelease () const

[read-only] showIsFullScreen : const bool

This property holds whether the platform defaults to fullscreen windows.

此特性是 true if the platform defaults to windows being fullscreen, otherwise false .

注意: The platform may still choose to show certain windows non-fullscreen, such as popups or dialogs. This property only reports the default behavior.

访问函数:

bool showIsFullScreen () const

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

[read-only] showIsMaximized : const bool

This property holds whether the platform defaults to maximized windows.

此特性是 true if the platform defaults to windows being maximized, otherwise false .

注意: The platform may still choose to show certain windows non-maximized, such as popups or dialogs. This property only reports the default behavior.

访问函数:

bool showIsMaximized () const

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

showShortcutsInContextMenus : bool

true if the platform normally shows shortcut key sequences in context menus, otherwise false .

Since Qt 5.13, the setShowShortcutsInContextMenus() function can be used to override the platform default.

访问函数:

bool showShortcutsInContextMenus () const
void setShowShortcutsInContextMenus (bool showShortcutsInContextMenus )

通知程序信号:

void showShortcutsInContextMenusChanged (bool)

另请参阅 Qt::AA_DontShowShortcutsInContextMenus .

[read-only] singleClickActivation : const bool

This property holds whether items are activated by single or double click.

此特性是 true if items should be activated by single click, false if they should be activated by double click instead.

访问函数:

bool singleClickActivation () const

[read-only] startDragDistance : const int

This property holds the distance, in pixels, that the mouse must be moved with a button held down before a drag and drop operation will begin.

若应用程序支持拖放,且想要开始拖放操作在用户有按下按钮将光标移动一定距离后,应使用此特性值作为最小要求距离。

例如,若将点击鼠标位置存储在 startPos 且当前位置 (如:在鼠标移动事件中) 为 currentPos , 可以找出是否应采用像这样的代码启动拖拽:

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

访问函数:

int startDragDistance () const

通知程序信号:

void startDragDistanceChanged (int startDragDistance )

另请参阅 startDragTime , QPoint::manhattanLength (),和 拖放 .

[read-only] startDragTime : const int

This property holds the time, in milliseconds, that a mouse button must be held down before a drag and drop operation will begin.

若应用程序支持拖放,且想要开始拖放操作在用户有按下鼠标按钮一定时间后,应使用此特性值作为延迟。

访问函数:

int startDragTime () const

通知程序信号:

void startDragTimeChanged (int startDragTime )

另请参阅 startDragDistance and 拖放 .

[read-only] startDragVelocity : const int

This property holds the limit for the velocity, in pixels per second, that the mouse may be moved, with a button held down, for a drag and drop operation to begin. A value of 0 means there is no such limit.

访问函数:

int startDragVelocity () const

另请参阅 startDragDistance and 拖放 .

[read-only] tabFocusBehavior : const Qt::TabFocusBehavior

This property holds the focus behavior on press of the tab key.

注意: Do not bind this value in QML because the change notifier signal is not implemented yet.

访问函数:

Qt::TabFocusBehavior tabFocusBehavior () const

通知程序信号:

void tabFocusBehaviorChanged (Qt::TabFocusBehavior tabFocusBehavior )

[read-only] touchDoubleTapDistance : const int

This property holds the maximum distance, in pixels, that a finger can be moved between two consecutive taps and still have it detected as a double-tap

访问函数:

int touchDoubleTapDistance () const

useHoverEffects : bool

This property holds whether UI elements use hover effects.

此特性是 true if UI elements should use hover effects. This is the standard behavior on desktop platforms with a mouse pointer, whereas on touch platforms the overhead of hover event delivery can be avoided.

访问函数:

bool useHoverEffects () const
void setUseHoverEffects (bool useHoverEffects )

通知程序信号:

void useHoverEffectsChanged (bool useHoverEffects )

[read-only] useRtlExtensions : const bool

此特性保持书写方向。

此特性是 true if right-to-left writing direction is enabled, otherwise false .

访问函数:

bool useRtlExtensions () const

[read-only] wheelScrollLines : const int

Number of lines to scroll by default for each wheel click.

访问函数:

int wheelScrollLines () const

通知程序信号:

void wheelScrollLinesChanged (int scrollLines )