Класс QStyleHints
Класс QStyleHints содержит специфичные для платформы подсказки и настройки. Подробнее...
| Заголовок: | #include <QStyleHints> |
| CMake: | find_package(Qt6 COMPONENTS Gui REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| С момента: | Qt 5.0 |
| Наследует: | QObject |
Свойства
|
|
Открытые функции
| 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().
Документация свойств
[read-only] cursorFlashTime : const int
Это свойство содержит время мигания (переключения видимости) курсора в миллисекундах.
Время мигания — это время, используемое для отображения, инвертирования и восстановления отображения курсора. Обычно курсор отображается половину времени мигания, а затем скрывается на такое же время.
Функции доступа:
| int | cursorFlashTime() const |
Сигнал уведомления:
| void | cursorFlashTimeChanged(int cursorFlashTime) |
[read-only] fontSmoothingGamma : const qreal
Это свойство содержит значение гамма, используемое при сглаживании шрифтов.
Функции доступа:
| qreal | fontSmoothingGamma() const |
[read-only] keyboardAutoRepeatRate : const int
Это свойство содержит частоту, в событиях в секунду, с которой автоматически генерируются дополнительные повторные нажатия клавиш, если клавиша удерживается.
Функции доступа:
| int | keyboardAutoRepeatRate() const |
[read-only] keyboardInputInterval : const int
Это свойство содержит временной предел в миллисекундах, который отличает нажатие клавиши от двух последовательных нажатий клавиш.
Функции доступа:
| int | keyboardInputInterval() const |
Сигнал уведомления:
| void | keyboardInputIntervalChanged(int keyboardInputInterval) |
[read-only, since 5.14] mouseDoubleClickDistance : const int
Это свойство содержит максимальное расстояние в пикселях, на которое может быть перемещена мышь между двумя последовательными щелчками, чтобы двойной щелчок был распознан.
Это свойство было добавлено в Qt 5.14.
Функции доступа:
| int | mouseDoubleClickDistance() const |
[read-only] mouseDoubleClickInterval : const int
Это свойство содержит временной предел в миллисекундах, который отличает двойной щелчок от двух последовательных щелчков мышью.
Функции доступа:
| int | mouseDoubleClickInterval() const |
Сигнал уведомления:
| void | mouseDoubleClickIntervalChanged(int mouseDoubleClickInterval) |
[read-only, since 5.3] mousePressAndHoldInterval : const int
Это свойство содержит временной предел в миллисекундах, который активирует зажатие кнопки мыши.
Это свойство было добавлено в Qt 5.3.
Функции доступа:
| int | mousePressAndHoldInterval() const |
Сигнал уведомления:
| void | mousePressAndHoldIntervalChanged(int mousePressAndHoldInterval) |
[since 5.11] mouseQuickSelectionThreshold : const int
Порог быстрого выделения мышью в QLineEdit.
Это свойство определяет, насколько должна быть перемещена курсор мыши по оси Y, чтобы запустить быстрое выделение во время обычного выделения текста в QLineEdit.
Если значение свойства меньше или равно 0, функция быстрого выделения отключена.
Это свойство было добавлено в Qt 5.11.
Функции доступа:
| int | mouseQuickSelectionThreshold() const |
Сигнал уведомления:
| void | mouseQuickSelectionThresholdChanged(int threshold) |
[read-only] passwordMaskCharacter : const QChar
Это свойство содержит символ, используемый для маскирования символов, набранных в текстовые поля в режиме пароля.
Функции доступа:
| QChar | passwordMaskCharacter() const |
[read-only] passwordMaskDelay : const int
Это свойство содержит время в миллисекундах, в течение которого набранный символ отображается без маскировки в текстовом поле в режиме пароля.
Функции доступа:
| int | passwordMaskDelay() const |
[read-only] setFocusOnTouchRelease : const bool
Это свойство содержит событие, которое должно установить фокус ввода на объекты фокусировки.
Это свойство true если объекты фокуса (поля ввода и т.д.) должны получать фокус ввода после отпускания сенсорной/мышиной кнопки. Это стандартное поведение на сенсорных платформах. На настольных платформах стандарт заключается в том, чтобы установить фокус уже при нажатии сенсорной/мышиной кнопки.
Функции доступа:
| bool | setFocusOnTouchRelease() const |
[read-only] showIsFullScreen : const bool
Это свойство содержит информацию о том, устанавливает ли платформа по умолчанию полноэкранный режим для окон.
Это свойство true если платформа по умолчанию устанавливает окна в полноэкранный режим, в противном случае false.
Примечание: Платформа может по-прежнему выбрать отображение некоторых окон не в полноэкранном режиме, например, всплывающих окон или диалоговых окон. Это свойство только отражает поведение по умолчанию.
Функции доступа:
| bool | showIsFullScreen() const |
См. также QWindow::show() и showIsMaximized().
[read-only, since 5.6] showIsMaximized : const bool
Это свойство содержит информацию о том, устанавливает ли платформа по умолчанию максимальный размер окна.
Это свойство true если платформа по умолчанию устанавливает окна в максимальный размер, в противном случае false.
Это свойство было добавлено в Qt 5.6.
Функции доступа:
| bool | showIsMaximized() const |
См. также QWindow::show() и showIsFullScreen().
[since 5.10] showShortcutsInContextMenus : bool
true если платформа обычно отображает последовательности комбинаций клавиш в контекстных меню, в противном случае false.
С Qt 5.13 функция setShowShortcutsInContextMenus() может быть использована для переопределения поведения по умолчанию платформы.
Это свойство было добавлено в Qt 5.10.
Функции доступа:
| bool | showShortcutsInContextMenus() const |
| void | setShowShortcutsInContextMenus(bool showShortcutsInContextMenus) |
Сигнал уведомления:
| void | showShortcutsInContextMenusChanged(bool) |
[read-only, since 5.5] singleClickActivation : const bool
Это свойство определяет, активируются ли элементы одним или двойным щелчком.
Это свойство true если элементы должны активироваться одним щелчком, false если вместо этого они должны активироваться двойным щелчком.
Это свойство было добавлено в Qt 5.5.
Функции доступа:
| bool | singleClickActivation() const |
[read-only] startDragDistance : const int
Это свойство содержит расстояние в пикселях, на которое необходимо переместить указатель мыши с зажатой кнопкой, прежде чем начнется операция перетаскивания.
Если в вашем приложении поддерживается перетаскивание и вам нужно начать операцию перетаскивания после того, как пользователь переместил курсор на определенное расстояние с зажатой кнопкой, вы должны использовать значение этого свойства в качестве минимального необходимого расстояния.
Например, если позиция щелчка мыши хранится в startPos, а текущая позиция (например, в событии перемещения мыши) — в currentPos, вы можете определить, следует ли начинать перетаскивание с помощью такого кода:
int main(int argc, char *argv[])
{
QApplication::setDesktopSettingsAware(false);
QApplication app(argc, argv);
...
return app.exec();
} Функции доступа:
| int | startDragDistance() const |
Сигнал уведомления:
| void | startDragDistanceChanged(int startDragDistance) |
См. также startDragTime, QPoint::manhattanLength() и Перетаскивание и помещение.
[read-only] startDragTime : const int
Это свойство содержит время в миллисекундах, в течение которого необходимо удерживать кнопку мыши, прежде чем начнется операция перетаскивания.
Если в вашем приложении поддерживается перетаскивание и вам нужно начать операцию перетаскивания после того, как пользователь удерживал кнопку мыши определенное время, вы должны использовать значение этого свойства в качестве задержки.
Функции доступа:
| int | startDragTime() const |
Сигнал уведомления:
| void | startDragTimeChanged(int startDragTime) |
См. также startDragDistance и Перетаскивание и помещение.
[read-only] startDragVelocity : const int
Это свойство содержит предел скорости перемещения указателя мыши в пикселях в секунду с зажатой кнопкой для начала операции перетаскивания. Значение 0 означает отсутствие такого предела.
Функции доступа:
| int | startDragVelocity() const |
См. также startDragDistance и Перетаскивание и помещение.
[read-only, since 5.5] tabFocusBehavior : const Qt::TabFocusBehavior
Это свойство определяет поведение фокуса при нажатии клавиши Tab.
Примечание: Не привязывайте это значение в QML, так как сигнала уведомления о изменении еще не реализован.
Это свойство было добавлено в Qt 5.5.
Функции доступа:
| Qt::TabFocusBehavior | tabFocusBehavior() const |
Сигнал уведомления:
| void | tabFocusBehaviorChanged(Qt::TabFocusBehavior tabFocusBehavior) |
[read-only, since 5.14] touchDoubleTapDistance : const int
Это свойство содержит максимальное расстояние в пикселях, на которое палец может быть перемещен между двумя последовательными касаниями, чтобы оно все еще распознавалось как двойное касание.
Это свойство было добавлено в Qt 5.14.
Функции доступа:
| int | touchDoubleTapDistance() const |
[since 5.8] useHoverEffects : bool
Это свойство указывает, используют ли элементы интерфейса эффекты наведения.
Это свойство равно true, если элементы интерфейса должны использовать эффекты наведения. Это стандартное поведение на настольных платформах с указателем мыши, в то время как на сенсорных платформах можно избежать накладных расходов на доставку событий наведения.
Это свойство было добавлено в Qt 5.8.
Функции доступа:
| bool | useHoverEffects() const |
| void | setUseHoverEffects(bool useHoverEffects) |
Сигнал уведомления:
| void | useHoverEffectsChanged(bool useHoverEffects) |
[read-only] useRtlExtensions : const bool
Это свойство содержит направление письма.
Это свойство равно true, если направление письма справа налево включено, в противном случае false.
Функции доступа:
| bool | useRtlExtensions() const |
[read-only, since 5.9] wheelScrollLines : const int
Количество строк, на которое по умолчанию прокручивается каждый щелчок колесиком.
Это свойство было добавлено в Qt 5.9.
Функции доступа:
| int | wheelScrollLines() const |
Сигнал уведомления:
| void | wheelScrollLinesChanged(int scrollLines) |
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.0/qstylehints.html