Класс QRadioButton

Виджет QRadioButton предоставляет радиокнопку с текстовой меткой. Подробнее...

• Список всех членов, включая унаследованные

Открытые функции

Переопределенные открытые функции

• 21 открытая функция унаследована от QAbstractButton
• 214 открытых функций унаследовано от QWidget
• 32 открытых функций унаследовано от QObject
• 14 открытых функций унаследовано от QPaintDevice

Защищенные функции

Переопределенные защищенные функции

• 14 защищенных функций унаследовано от QAbstractButton
• 35 защищенных функций унаследовано от QWidget
• 9 защищенных функций унаследовано от QObject
• 1 защищенная функция унаследована от QPaintDevice

Дополнительные унаследованные члены

• 11 свойств унаследовано от QAbstractButton
• 59 свойств унаследовано от QWidget
• 1 свойства унаследовано от QObject
• 5 открытых слотов унаследовано от QAbstractButton
• 19 открытых слотов унаследовано от QWidget
• 1 открытый слот унаследовано от QObject
• 4 сигналов унаследовано от QAbstractButton
• 3 сигналов унаследовано от QWidget
• 2 сигналов унаследовано от QObject
• 5 статических открытых членов унаследовано от QWidget
• 11 статических открытых членов унаследовано от QObject
• 1 защищенный слот унаследовано от QWidget

Подробное описание

Виджет 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(QWidget *parent = Q_NULLPTR)

Создаёт радиокнопку с заданным parent, но без текста или пиктограммы.

Аргумент parent передаётся конструктору QAbstractButton.

QRadioButton::QRadioButton(const QString &text, QWidget *parent = Q_NULLPTR)

Создаёт радиокнопку с заданным parent и строкой text.

Аргумент parent передаётся конструктору QAbstractButton.

QRadioButton::~QRadioButton()

Деструктор.

[virtual protected] bool QRadioButton::event(QEvent *e)

Переопределено из QObject::event().

[virtual protected] bool QRadioButton::hitButton(const QPoint &pos) const

Переопределено из QAbstractButton::hitButton().

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

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

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

[virtual] QSize QRadioButton::minimumSizeHint() const

Переопределено из QWidget::minimumSizeHint().

[virtual protected] void QRadioButton::mouseMoveEvent(QMouseEvent *e)

Переопределено из QWidget::mouseMoveEvent().

[virtual protected] void QRadioButton::paintEvent(QPaintEvent *)

Переопределено из QWidget::paintEvent().

[virtual] QSize QRadioButton::sizeHint() const

Переопределено из QWidget::sizeHint().