Класс QDial

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

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

Свойства

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

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

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

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

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

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

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

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

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

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

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

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

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

Клавишная навигация регулятора довольно проста: клавиши со стрелками влево/вверх и вправо/вниз изменяют значение регулятора на определенный singleStep, Page Up и Page Down — на определенный pageStep, а клавиши Home и End устанавливают значение на определённые минимальные и максимальные значения.

Если вы используете колесо мыши для изменения значения регулятора, значение приращения определяется меньшим значением 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).