Класс QRadioButton

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

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

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

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

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

Статические открытые члены

• 5 статических открытых членов унаследовано от QWidget
• 9 статических открытых членов унаследовано от QObject

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

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

• 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 защищённый слот унаследовано от QWidget

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

Виджет 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, Руководство по проектированию графического интерфейса пользователя: Радиокнопка и Пример с групповой рамкой.

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

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