Класс 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).