Класс QRadioButton

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

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

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

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

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

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

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

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

Радиокнопки по умолчанию являются autoExclusive. Если автоматическое исключение включено, радиокнопки, принадлежащие одному родительскому виджету, ведут себя так, как если бы они были частью одной группы взаимоисключающих кнопок. Если вам нужны несколько групп взаимоисключающих кнопок для радиокнопок, принадлежащих одному родительскому виджету, поместите их в 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(const QString &text, QWidget *parent = nullptr)

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

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

QRadioButton::QRadioButton(QWidget *parent = nullptr)

Создаёт радиокнопку с заданным parent, но без текста или пиксельной карты.

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

[virtual] QRadioButton::~QRadioButton()

Деструктор.

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

Переопределяет: QAbstractButton::event(QEvent *e).

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

Переопределяет: QAbstractButton::hitButton(const QPoint &pos) const.

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

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

Переопределяет: QAbstractButton::paintEvent(QPaintEvent *e).

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

Переопределяет функцию доступа к свойству: QWidget::sizeHint.