Project

General

Profile

Improvements #9264

Document that WRadioButton does not emit unChecked

Added by Roel Standaert about 1 month ago.

Status:
New
Priority:
Normal
Assignee:
-
Target version:
Start date:
10/28/2021
Due date:
% Done:

0%

Estimated time:

Description

When one WRadioButton A is checked, and the user clicks on another WRadioButton B in the same WButtonGroup, this will emit WAbstractToggleButton::checked() for B, but not unChecked() for A.

This was an observation made by Stefan on the forum: https://redmine.emweb.be/boards/2/topics/17259

This is a consequence of the fact that the browser only emits the change event for the radio button that was clicked, not the one that is now automatically unchecked as a result.

I also looked at Qt's behavior:

  • clicked is emitted only for the one that has been clicked
  • toggled is emitted whenever the checked state changes

Since it's not straightforward to make WRadioButton emit unChecked (an EventSignal), and since this would be a change in existing behavior we should simply add some documentation to clarify that unChecked will not be emitted, and suggest using WButtonGroup::checkedChanged.

No data to display

Also available in: Atom PDF