QStyleHints 类

QStyleHints 类包含平台特定提示及设置。 更多...

头：	#include <QStyleHints>
qmake:	QT += gui
Since:	Qt 5.0
继承：	QObject

该类在 Qt 5.0 引入。

• 所有成员列表，包括继承成员

特性

cursorFlashTime : const int fontSmoothingGamma : const qreal keyboardAutoRepeatRate : const int keyboardInputInterval : const int mouseDoubleClickDistance : const int mouseDoubleClickInterval : const int mousePressAndHoldInterval : const int mouseQuickSelectionThreshold : const int passwordMaskCharacter : const QChar passwordMaskDelay : const int setFocusOnTouchRelease : const bool showIsFullScreen : const bool

showIsMaximized : const bool showShortcutsInContextMenus : bool singleClickActivation : const bool startDragDistance : const int startDragTime : const int startDragVelocity : const int tabFocusBehavior : const Qt::TabFocusBehavior touchDoubleTapDistance : const int useHoverEffects : bool useRtlExtensions : const bool wheelScrollLines : const int

公共函数

int	cursorFlashTime () const
qreal	fontSmoothingGamma () const
int	keyboardAutoRepeatRate () 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	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 ，提供对当前平台某些全局用户界面参数的访问。

访问是只读的；通常，平台本身为用户提供了微调这些参数的方式。

访问这些参数很有用，当实现自定义用户界面组件时，因为它们允许组件显露如其它组件的相同行为和感觉。

另请参阅 QGuiApplication::styleHints ().

特性文档编制

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 )

fontSmoothingGamma : const qreal

This property holds the gamma value used in font smoothing.

访问函数：

qreal

fontSmoothingGamma () const

keyboardAutoRepeatRate : const int

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.

访问函数：

int	keyboardAutoRepeatRate () const

keyboardInputInterval : const int

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

访问函数：

int	keyboardInputInterval () const

通知程序信号：

void	keyboardInputIntervalChanged (int keyboardInputInterval )

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

该特性在 Qt 5.14 引入。

访问函数：

int	mouseDoubleClickDistance () const

mouseDoubleClickInterval : const int

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

访问函数：

int	mouseDoubleClickInterval () const

通知程序信号：

void	mouseDoubleClickIntervalChanged (int mouseDoubleClickInterval )

mousePressAndHoldInterval : const int

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

该特性在 Qt 5.3 引入。

访问函数：

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.

该特性在 Qt 5.11 引入。

访问函数：

int	mouseQuickSelectionThreshold () const

通知程序信号：

void	mouseQuickSelectionThresholdChanged (int threshold )

passwordMaskCharacter : const QChar

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

访问函数：

QChar

passwordMaskCharacter () const

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

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

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 ().

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.

该特性在 Qt 5.6 引入。

访问函数：

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.

该特性在 Qt 5.10 引入。

访问函数：

bool	showShortcutsInContextMenus () const
void	setShowShortcutsInContextMenus (bool showShortcutsInContextMenus )

通知程序信号：

void	showShortcutsInContextMenusChanged ( bool )

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.

该特性在 Qt 5.5 引入。

访问函数：

bool	singleClickActivation () const

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 ()，和 拖放 .

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 拖放 .

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 拖放 .

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 5.5 引入。

访问函数：

Qt::TabFocusBehavior

tabFocusBehavior () const

通知程序信号：

void	tabFocusBehaviorChanged (Qt::TabFocusBehavior tabFocusBehavior )

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

该特性在 Qt 5.14 引入。

访问函数：

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.

该特性在 Qt 5.8 引入。

访问函数：

bool	useHoverEffects () const
void	setUseHoverEffects (bool useHoverEffects )

通知程序信号：

void	useHoverEffectsChanged (bool useHoverEffects )

useRtlExtensions : const bool

此特性保持书写方向。

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

访问函数：

bool	useRtlExtensions () const

wheelScrollLines : const int

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

该特性在 Qt 5.9 引入。

访问函数：

int	wheelScrollLines () const

通知程序信号：

void	wheelScrollLinesChanged (int scrollLines )

内容

• 特性

• 公共函数

• 信号

• 详细描述