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

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

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.