Класс QDial

Класс QDial предоставляет элемент управления диапазоном с закругленными контурами (например, спидометр или потенциометр). Подробнее...

• Список всех членов, включая унаследованные

Свойства

• notchSize : const int
• notchTarget : qreal
• notchesVisible : bool
• wrapping : bool

Открытые функции

Переопределенные открытые функции

Открытые слоты

Защищенные функции

Переопределенные защищенные функции

Подробное описание

Класс QDial используется, когда пользователю нужно контролировать значение в рамках определяемого программой диапазона, и этот диапазон либо циклический (например, углы от 0 до 359 градусов), либо макет диалога требует прямоугольного виджета.

Поскольку QDial наследуется от QAbstractSlider, поведение регулятора похоже на поведение ползунка. Если wrapping() равно false (по умолчанию), то между регулятором и ползунком нет реальной разницы. У них общие сигналы, слоты и методы. Какой использовать, зависит от ожиданий пользователей и типа приложения.

Поначалу регулятор непрерывно генерирует сигналы valueChanged() при перемещении; можно уменьшить частоту генерации сигнала, отключив свойство tracking. Сигнал sliderMoved() генерируется непрерывно, даже когда отслеживание отключено.

Регулятор также генерирует сигналы sliderPressed() и sliderReleased() при нажатии и отпускании кнопки мыши. Обратите внимание, что значение регулятора может измениться без генерации этих сигналов, так как значение также можно изменять с помощью клавиатуры и колеса мыши.

В отличие от ползунка, QDial пытается нарисовать "красивое" количество рисок, а не одну на каждый шаг. Если возможно, количество нарисованных рисок составляет одну на каждый шаг, но если для рисования каждой нет достаточного количества пикселей, QDial пропустит некоторые риски, чтобы попробовать нарисовать равномерный набор (например, рисуя каждую вторую или третью риску).

Как и ползунок, регулятор делает функцию QAbstractSlider setValue() доступной как слот.

Интерфейс регулятора с клавиатурой довольно прост: стрелки влево/вверх и вправо/вниз изменяют значение регулятора на определенный singleStep, Page Up и Page Down на определенный pageStep, а Home и End устанавливают значение на определенные minimum и maximum значения.

Если используется колесо мыши для изменения значения регулятора, значение приращения определяется меньшим значением wheelScrollLines, умноженным на singleStep, и pageStep.

См. также QScrollBar, QSpinBox, QSlider, Руководство по разработке графического интерфейса пользователя: ползунки и Пример регуляторов.

Документация по членам-функциям

QDial::QDial(QWidget *parent = nullptr)

Создаёт циферблат.

Аргумент parent передаётся в конструктор QAbstractSlider.

[virtual] QDial::~QDial()

Удаляет циферблат.

[override virtual protected] bool QDial::event(QEvent *e)

Переопределяет: QAbstractSlider::event(QEvent *e).

[virtual protected] void QDial::initStyleOption(QStyleOptionSlider *option) const

Инициализирует option значениями из этого QDial. Этот метод полезен для подклассов, когда им нужен QStyleOptionSlider, но они не хотят заполнять всю информацию самостоятельно.

См. также QStyleOption::initFrom().

[override virtual] QSize QDial::minimumSizeHint() const

Переопределяет функцию доступа к свойству: QWidget::minimumSizeHint.

[override virtual protected] void QDial::mouseMoveEvent(QMouseEvent *e)

Переопределяет: QWidget::mouseMoveEvent(QMouseEvent *event).

[override virtual protected] void QDial::mousePressEvent(QMouseEvent *e)

Переопределяет: QWidget::mousePressEvent(QMouseEvent *event).

[override virtual protected] void QDial::mouseReleaseEvent(QMouseEvent *e)

Переопределяет: QWidget::mouseReleaseEvent(QMouseEvent *event).

[override virtual protected] void QDial::paintEvent(QPaintEvent *pe)

Переопределяет: QWidget::paintEvent(QPaintEvent *event).

[override virtual protected] void QDial::resizeEvent(QResizeEvent *e)

Переопределяет: QWidget::resizeEvent(QResizeEvent *event).

[override virtual] QSize QDial::sizeHint() const

Переопределяет функцию доступа к свойству: QWidget::sizeHint.

[override virtual protected] void QDial::sliderChange(QAbstractSlider::SliderChange change)

Переопределяет: QAbstractSlider::sliderChange(QAbstractSlider::SliderChange change).