Класс 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)

Создаёт радиокнопку с заданным 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.

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