From db4c025e423bd6bdc01c99f166e82b7b1e81d9d5 Mon Sep 17 00:00:00 2001 From: Vadim Zeitlin Date: Mon, 20 Jan 2020 13:21:44 +0100 Subject: [PATCH] Document wxRadioButton relationship with focus in wxMSW Explain that calling SetValue(true) may change the focus, as this is not really obvious (and doesn't happen in the other ports). --- interface/wx/radiobut.h | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/interface/wx/radiobut.h b/interface/wx/radiobut.h index 706f05c293..d037412e55 100644 --- a/interface/wx/radiobut.h +++ b/interface/wx/radiobut.h @@ -109,6 +109,12 @@ public: value set to @true. To uncheck a radio button in a group you must check another button in the same group. + @note Under MSW, the focused radio button is always selected, i.e. its + value is @true. And, conversely, calling @c SetValue(true) will + also set focus to the radio button if the focus had previously been + on another radio button in the same group -- as otherwise setting + it on wouldn't work. + @param value @true to check, @false to uncheck. */