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

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