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

[protected] void QRadioButton::initStyleOption(QStyleOptionButton *option) const

Инициализирует option значениями из этой QRadioButton. Этот метод полезен для подклассов, когда им требуется QStyleOptionButton, но они не хотят заполнять всю информацию самостоятельно.

См. также QStyleOption::initFrom().

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

Переопределяет: QWidget::minimumSizeHint() const.

[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() const.