Класс QRadioButton

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

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

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

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

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

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

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

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

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

• 11 свойств унаследовано от QAbstractButton
• 58 свойств унаследовано от 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().

	Радиокнопка, показанная в стиле виджета Fusion.
	Радиокнопка, показанная в стиле виджета Windows Vista.
	Радиокнопка, показанная в стиле виджета Macintosh.

См. также 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().