QStyleHints 类

The QStyleHints class contains platform specific hints and settings. 更多...

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

特性

公共函数

int cursorFlashTime () const
qreal fontSmoothingGamma () const
int keyboardAutoRepeatRate () const
int keyboardInputInterval () const
int mouseDoubleClickInterval () const
int mousePressAndHoldInterval () const
QChar passwordMaskCharacter () const
int passwordMaskDelay () const
bool setFocusOnTouchRelease () const
void setUseHoverEffects (bool useHoverEffects )
bool showIsFullScreen () const
bool showIsMaximized () const
bool singleClickActivation () const
int startDragDistance () const
int startDragTime () const
int startDragVelocity () const
Qt::TabFocusBehavior tabFocusBehavior () 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 startDragDistanceChanged (int startDragDistance )
void startDragTimeChanged (int startDragTime )
void tabFocusBehaviorChanged (Qt::TabFocusBehavior tabFocusBehavior )
void useHoverEffectsChanged (bool useHoverEffects )
void wheelScrollLinesChanged (int scrollLines )

额外继承成员

详细描述

The QStyleHints class contains platform specific hints and settings.

此类的对象,获取自 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 )

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 )

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

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 )

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 )