Класс QRadioButton

Виджет QRadioButton предоставляет радиокнопку с текстовой меткой. Подробнее...

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

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

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

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

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

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

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

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

• 11 свойств, унаследованных от QAbstractButton
• 59 свойств, унаследованных от QWidget
• 1 свойства, унаследованного от QObject
• 5 слотов, унаследованных от QAbstractButton
• 19 слотов, унаследованных от QWidget
• 1 слот, унаследованный от QObject
• 4 сигналов, унаследованных от QAbstractButton
• 3 сигналов, унаследованных от QWidget
• 2 сигналов, унаследованных от QObject
• 1 открытой переменной, унаследованной от QObject
• 5 статических открытых членов, унаследованных от QWidget
• 10 статических открытых членов, унаследованных от QObject
• 1 защищённого слота, унаследованного от QWidget
• 2 защищённых переменных, унаследованных от QObject
• 1 защищённого типа, унаследованного от QPaintDevice

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

Виджет QRadioButton предоставляет радиокнопку с текстовой меткой.

QRadioButton — это кнопка выбора, которая может быть включённой (выбранной) или выключённой (не выбранной). Радиокнопки обычно предоставляют пользователю выбор «одно из многих». В группе радиокнопок одновременно может быть выбрана только одна радиокнопка; если пользователь выбирает другую кнопку, ранее выбранная кнопка выключается.

Радиокнопки по умолчанию являются автоматически взаимоисключающими. Если автоматическое взаимоисключение включено, радиокнопки, принадлежащие одному и тому же родительскому виджету, ведут себя так, как если бы они были частью одной и той же группы взаимоисключающих кнопок. Если вам нужны несколько групп взаимоисключающих кнопок для радиокнопок, принадлежащих одному и тому же родительскому виджету, поместите их в QButtonGroup.

Всякий раз, когда кнопка включается или выключается, она испускает сигнал toggled(). Подключитесь к этому сигналу, если хотите выполнить действие каждый раз, когда состояние кнопки меняется. Используйте isChecked(), чтобы узнать, выбрана ли определённая кнопка.

Как и QPushButton, радиокнопка отображает текст и, по желанию, небольшой значок. Значок устанавливается с помощью setIcon(). Текст можно установить в конструкторе или с помощью setText(). Краткую клавишу можно указать, добавив амперсанд (&) перед предпочтительным символом в тексте. Например:

QRadioButton *button = new QRadioButton("Search from the &cursor", this);

В этом примере сочетание клавиш — Alt+c. Подробности см. в документации QShortcut. Чтобы отобразить фактический амперсанд, используйте '&&'.

Важные унаследованные члены: text(), setText(), text(), setDown(), isDown(), autoRepeat(), group(), setAutoRepeat(), toggle(), pressed(), released(), clicked() и toggled().

См. также QPushButton, QToolButton, QCheckBox, Руководство по проектированию пользовательского интерфейса: Радиокнопки и Пример виджета Group Box.

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

QRadioButton::QRadioButton(QWidget *parent = nullptr)

Конструирует радиокнопку с заданным parent, но без текста или пиксельного изображения.

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

QRadioButton::QRadioButton(const QString &text, QWidget *parent = nullptr)

Конструирует радиокнопку с заданным parent и строкой text.

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

[virtual] QRadioButton::~QRadioButton()

Деструктор.

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

Переопределено из QAbstractButton::event().

[override virtual protected] bool QRadioButton::hitButton(const QPoint &pos) const

Переопределено из QAbstractButton::hitButton().

[protected] void QRadioButton::initStyleOption(QStyleOptionButton *option) const

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

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

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

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

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

Переопределено из QAbstractButton::mouseMoveEvent().

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

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

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

Реализовано повторно из QWidget::sizeHint().