Класс QRadioButton

Виджет 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(const QString &text, QWidget *parent = nullptr)

Создает радиокнопку с заданным родительским виджетом и строкой текста.

Аргумент родитель передается в конструктор QAbstractButton.

QRadioButton::QRadioButton(QWidget *parent = nullptr)

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

Аргумент родитель передается в конструктор 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.

[virtual 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.