Класс QButtonGroup

Класс QButtonGroup предоставляет контейнер для организации групп виджетов кнопок. Подробнее...

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

Свойства

• exclusive : bool

• 1 свойство унаследовано от QObject

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

• 34 открытых функций унаследовано от QObject

Сигналы

• 2 сигнала унаследовано от QObject

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

• 1 открытый слот унаследован от QObject
• 1 открытая переменная унаследована от QObject
• 10 статические открытые члены унаследованы от QObject
• 9 защищенные функции унаследованы от QObject
• 2 защищенные переменные унаследованы от QObject

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

Класс QButtonGroup предоставляет контейнер для организации групп виджетов кнопок.

QButtonGroup предоставляет абстрактный контейнер, в который можно помещать виджеты кнопок. Он не предоставляет визуального представления этого контейнера (см. QGroupBox для виджета контейнера), а вместо этого управляет состояниями каждой из кнопок в группе.

Группа кнопок exclusive отключает все переключаемые (toggle) кнопки, кроме той, которая была нажата. По умолчанию группа кнопок является exclusive. Кнопки в группе кнопок обычно являются переключаемыми QPushButton, QCheckBox (обычно для не-exclusive групп кнопок) или QRadioButton. Если вы создаёте exclusive группу кнопок, вы должны убедиться, что одна из кнопок в группе изначально выбрана; в противном случае группа изначально будет в состоянии, где ни одна кнопка не выбрана.

Кнопку можно добавить в группу с помощью addButton() и удалить с помощью removeButton(). Если группа является exclusive, текущая выбранная кнопка доступна с помощью checkedButton(). Если нажата кнопка, испускается сигнал buttonClicked; для переключаемой кнопки в exclusive группе это означает, что кнопка была выбрана. Список кнопок в группе возвращается функцией buttons().

Кроме того, QButtonGroup может осуществлять отображение между целыми числами и кнопками. Вы можете присвоить целое числовой идентификатор кнопке с помощью setId(), и получить его с помощью id(). Идентификатор текущей выбранной кнопки доступен с помощью checkedId(), и есть перегруженный сигнал buttonClicked(), который испускает идентификатор кнопки. Идентификатор -1 зарезервирован QButtonGroup и означает "нет такой кнопки". Целью механизма сопоставления является упрощение представления значений перечисления в пользовательском интерфейсе.

См. также QGroupBox, QPushButton, QCheckBox и QRadioButton.

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

QButtonGroup::QButtonGroup(QObject *parent = nullptr)

Создаёт новую пустую группу кнопок с заданным parent.

См. также addButton() и setExclusive().

[virtual] QButtonGroup::~QButtonGroup()

Удаляет группу кнопок.

void QButtonGroup::addButton(QAbstractButton *button, int id = -1)

Добавляет заданную button в группу кнопок. Если id равно -1, кнопке будет присвоен идентификатор. Автоматически назначенные идентификаторы гарантированно будут отрицательными, начиная с -2. Если вы назначаете свои собственные идентификаторы, используйте положительные значения, чтобы избежать конфликтов.

См. также removeButton() и buttons().

QAbstractButton *QButtonGroup::button(int id) const

Возвращает кнопку с заданным id или 0, если такой кнопки нет.

Эта функция была добавлена в Qt 4.1.

[signal] void QButtonGroup::buttonClicked(QAbstractButton *button)

Этот сигнал испускается, когда заданная кнопка нажата. Кнопка нажимается, когда она нажата и отпущена, когда нажат её ярлык, или когда QAbstractButton::click() или QAbstractButton::animateClick() вызывается программно.

Примечание: Сигнал buttonClicked перегружен в этом классе. Для подключения к этому сигналу, используя синтаксис указателя на функцию, Qt предоставляет удобную функцию для получения указателя на функцию, как показано в этом примере:

connect(buttonGroup, QOverload<QAbstractButton *>::of(&QButtonGroup::buttonClicked),
    [=](QAbstractButton *button){ /* ... */ });

См. также checkedButton() и QAbstractButton::clicked().

[signal] void QButtonGroup::buttonClicked(int id)

Этот сигнал излучается, когда нажата кнопка с заданным id.

Примечание: Сигнал buttonClicked перегружен в этом классе. Для подключения к этому сигналу с использованием синтаксиса указателя на функцию Qt предоставляет удобную вспомогательную функцию для получения указателя на функцию, как показано в этом примере:

connect(buttonGroup, QOverload<int>::of(&QButtonGroup::buttonClicked),
    [=](int id){ /* ... */ });

См. также checkedButton() и QAbstractButton::clicked().

[signal] void QButtonGroup::buttonPressed(QAbstractButton *button)

Этот сигнал излучается, когда указанная кнопка button нажата.

Примечание: Сигнал buttonPressed перегружен в этом классе. Для подключения к этому сигналу с использованием синтаксиса указателя на функцию Qt предоставляет удобную вспомогательную функцию для получения указателя на функцию, как показано в этом примере:

connect(buttonGroup, QOverload<QAbstractButton *>::of(&QButtonGroup::buttonPressed),
    [=](QAbstractButton *button){ /* ... */ });

Эта функция была представлена в Qt 4.2.

См. также QAbstractButton::pressed().

[signal] void QButtonGroup::buttonPressed(int id)

Этот сигнал излучается, когда нажата кнопка с заданным id.

Примечание: Сигнал buttonPressed перегружен в этом классе. Для подключения к этому сигналу с использованием синтаксиса указателя на функцию Qt предоставляет удобную вспомогательную функцию для получения указателя на функцию, как показано в этом примере:

connect(buttonGroup, QOverload<int>::of(&QButtonGroup::buttonPressed),
    [=](int id){ /* ... */ });

Эта функция была представлена в Qt 4.2.

См. также QAbstractButton::pressed().

[signal] void QButtonGroup::buttonReleased(QAbstractButton *button)

Этот сигнал излучается, когда указанная кнопка button отпущена.

Примечание: Сигнал buttonReleased перегружен в этом классе. Для подключения к этому сигналу с использованием синтаксиса указателя на функцию Qt предоставляет удобную вспомогательную функцию для получения указателя на функцию, как показано в этом примере:

connect(buttonGroup, QOverload<QAbstractButton *>::of(&QButtonGroup::buttonReleased),
    [=](QAbstractButton *button){ /* ... */ });

Эта функция была представлена в Qt 4.2.

См. также QAbstractButton::released().

[signal] void QButtonGroup::buttonReleased(int id)

Этот сигнал излучается, когда кнопка с заданным id отпущена.

Примечание: Сигнал buttonReleased перегружен в этом классе. Для подключения к этому сигналу с использованием синтаксиса указателя на функцию Qt предоставляет удобную вспомогательную функцию для получения указателя на функцию, как показано в этом примере:

connect(buttonGroup, QOverload<int>::of(&QButtonGroup::buttonReleased),
    [=](int id){ /* ... */ });

Эта функция была представлена в Qt 4.2.

См. также QAbstractButton::released().

[signal] void QButtonGroup::buttonToggled(QAbstractButton *button, bool checked)

Этот сигнал излучается, когда указанная кнопка button переключается. checked равно true, если кнопка выбрана, или false, если кнопка не выбрана.

Примечание: Сигнал buttonToggled перегружен в этом классе. Для подключения к этому сигналу с использованием синтаксиса указателя на функцию Qt предоставляет удобную вспомогательную функцию для получения указателя на функцию, как показано в этом примере:

connect(buttonGroup, QOverload<QAbstractButton *, bool>::of(&QButtonGroup::buttonToggled),
    [=](QAbstractButton *button, bool checked){ /* ... */ });

Эта функция была представлена в Qt 5.2.

См. также QAbstractButton::toggled().

[signal] void QButtonGroup::buttonToggled(int id, bool checked)

Этот сигнал излучается, когда кнопка с заданным id переключается. checked равно true, если кнопка выбрана, или false, если кнопка не выбрана.

Примечание: Сигнал buttonToggled перегружен в этом классе. Для подключения к этому сигналу с использованием синтаксиса указателя на функцию Qt предоставляет удобную вспомогательную функцию для получения указателя на функцию, как показано в этом примере:

connect(buttonGroup, QOverload<int, bool>::of(&QButtonGroup::buttonToggled),
    [=](int id, bool checked){ /* ... */ });

Эта функция была представлена в Qt 5.2.

См. также QAbstractButton::toggled().

QList<QAbstractButton *> QButtonGroup::buttons() const

Возвращает список кнопок группы кнопок. Он может быть пустым.

См. также addButton() и removeButton().

QAbstractButton *QButtonGroup::checkedButton() const

Возвращает выбранную кнопку группы кнопок или 0, если кнопок нет.

См. также buttonClicked().

int QButtonGroup::checkedId() const

Возвращает идентификатор выбранной кнопки, или -1, если ни одна кнопка не выбрана.

Эта функция была представлена в Qt 4.1.

См. также setId().

int QButtonGroup::id(QAbstractButton *button) const

Возвращает идентификатор для указанной кнопки button, или -1, если такой кнопки нет.

Эта функция была представлена в Qt 4.1.

См. также setId().

void QButtonGroup::removeButton(QAbstractButton *button)

Удаляет указанную кнопку button из группы кнопок.

См. также addButton() и buttons().

void QButtonGroup::setId(QAbstractButton *button, int id)

Устанавливает id для указанной кнопки button. Обратите внимание, что id не может быть -1.

Эта функция была представлена в Qt 4.1.

См. также id().