Класс 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.1/qstylehints.html