Класс QDial

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

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

Свойства

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

• 11 свойств унаследовано от QAbstractSlider
• 59 свойств унаследовано от QWidget
• 1 свойство унаследовано от QObject

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

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

• 21 открытая функция унаследована от QAbstractSlider
• 214 открытых функций унаследовано от QWidget
• 34 открытых функций унаследовано от QObject
• 14 открытых функций унаследовано от QPaintDevice

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

• 3 открытых слота унаследовано от QAbstractSlider
• 19 открытых слотов унаследовано от QWidget
• 1 открытый слот унаследовано от QObject

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

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

• 8 защищённых функций унаследовано от QAbstractSlider
• 35 защищённых функций унаследовано от QWidget
• 9 защищённых функций унаследовано от QObject
• 1 защищённая функция унаследовано от QPaintDevice

Дополнительные унаследованные члены

• 6 сигналов унаследовано от QAbstractSlider
• 3 сигнала унаследовано от QWidget
• 2 сигнала унаследовано от QObject
• 1 открытая переменная унаследована от QObject
• 5 статических открытых членов унаследовано от QWidget
• 10 статических открытых членов унаследовано от QObject
• 1 защищённый слот унаследовано от QWidget
• 2 защищённых переменных унаследовано от QObject
• 1 защищённый тип унаследовано от QPaintDevice

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

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

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

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

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

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

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

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

Интерфейс клавиатуры диска довольно прост: клавиши влево/вверх и вправо/вниз изменяют значение диска на заданный 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().

[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().

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

Переопределено из QWidget::mousePressEvent().

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

Переопределено из QWidget::mouseReleaseEvent().

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

Переопределено из QWidget::paintEvent().

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

Переопределено из QWidget::resizeEvent().

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

Переопределено из QWidget::sizeHint().

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

Переопределено из QAbstractSlider::sliderChange().