QStyleHints 類

QStyleHints 類包含平颱特定提示及設置。 更多...

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

該類在 Qt 5.0 引入。

特性

公共函數

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 )