]> git.saurik.com Git - wxWidgets.git/blame - samples/widgets/radiobox.cpp
extending docs according #9713
[wxWidgets.git] / samples / widgets / radiobox.cpp
CommitLineData
32b8ec41 1/////////////////////////////////////////////////////////////////////////////
be5a51fb 2// Program: wxWidgets Widgets Sample
32b8ec41
VZ
3// Name: radiobox.cpp
4// Purpose: Part of the widgets sample showing wxRadioBox
5// Author: Vadim Zeitlin
6// Created: 15.04.01
7// Id: $Id$
8// Copyright: (c) 2001 Vadim Zeitlin
9// License: wxWindows license
10/////////////////////////////////////////////////////////////////////////////
11
12// ============================================================================
13// declarations
14// ============================================================================
15
16// ----------------------------------------------------------------------------
17// headers
18// ----------------------------------------------------------------------------
19
20// for compilers that support precompilation, includes "wx/wx.h".
21#include "wx/wxprec.h"
22
23#ifdef __BORLANDC__
24 #pragma hdrstop
25#endif
26
61c083e7
WS
27#if wxUSE_RADIOBOX
28
32b8ec41
VZ
29// for all others, include the necessary headers
30#ifndef WX_PRECOMP
31 #include "wx/log.h"
32
3bb70c40 33 #include "wx/bitmap.h"
32b8ec41
VZ
34 #include "wx/button.h"
35 #include "wx/checkbox.h"
36 #include "wx/radiobox.h"
37 #include "wx/statbox.h"
38 #include "wx/textctrl.h"
39#endif
40
41#include "wx/sizer.h"
42
43#include "widgets.h"
61c083e7 44
32b8ec41
VZ
45#include "icons/radiobox.xpm"
46
47// ----------------------------------------------------------------------------
48// constants
49// ----------------------------------------------------------------------------
50
51// control ids
52enum
53{
f0fa4312 54 RadioPage_Reset = wxID_HIGHEST,
32b8ec41
VZ
55 RadioPage_Update,
56 RadioPage_Selection,
57 RadioPage_Label,
58 RadioPage_LabelBtn,
3bfa7be9
VZ
59 RadioPage_EnableItem,
60 RadioPage_ShowItem,
32b8ec41
VZ
61 RadioPage_Radio
62};
63
64// layout direction radiobox selections
65enum
66{
67 RadioDir_Default,
68 RadioDir_LtoR,
69 RadioDir_TtoB
70};
71
72// default values for the number of radiobox items
0c61716c
VZ
73static const unsigned int DEFAULT_NUM_ENTRIES = 12;
74static const unsigned int DEFAULT_MAJOR_DIM = 3;
32b8ec41 75
3bfa7be9
VZ
76// this item is enabled/disabled shown/hidden by the test checkboxes
77static const int TEST_BUTTON = 1;
78
32b8ec41
VZ
79// ----------------------------------------------------------------------------
80// RadioWidgetsPage
81// ----------------------------------------------------------------------------
82
83class RadioWidgetsPage : public WidgetsPage
84{
85public:
f2fdc4d5 86 RadioWidgetsPage(WidgetsBookCtrl *book, wxImageList *imaglist);
8f6eaec9 87 virtual ~RadioWidgetsPage(){};
32b8ec41 88
195df7a7 89 virtual wxControl *GetWidget() const { return m_radio; }
1301e228 90 virtual void RecreateWidget() { CreateRadio(); }
195df7a7 91
453535a7
WS
92 // lazy creation of the content
93 virtual void CreateContent();
94
32b8ec41
VZ
95protected:
96 // event handlers
97 void OnCheckOrRadioBox(wxCommandEvent& event);
98 void OnRadioBox(wxCommandEvent& event);
99
100 void OnButtonReset(wxCommandEvent& event);
101 void OnButtonRecreate(wxCommandEvent& event);
102
103 void OnButtonSelection(wxCommandEvent& event);
104 void OnButtonSetLabel(wxCommandEvent& event);
105
3bfa7be9
VZ
106 void OnEnableItem(wxCommandEvent& event);
107 void OnShowItem(wxCommandEvent& event);
108
32b8ec41
VZ
109 void OnUpdateUIReset(wxUpdateUIEvent& event);
110 void OnUpdateUIUpdate(wxUpdateUIEvent& event);
111 void OnUpdateUISelection(wxUpdateUIEvent& event);
3bfa7be9
VZ
112 void OnUpdateUIEnableItem(wxUpdateUIEvent& event);
113 void OnUpdateUIShowItem(wxUpdateUIEvent& event);
32b8ec41
VZ
114
115 // reset the wxRadioBox parameters
116 void Reset();
117
118 // (re)create the wxRadioBox
119 void CreateRadio();
120
121 // the controls
122 // ------------
123
124 // the check/radio boxes for styles
125 wxCheckBox *m_chkVert;
3bfa7be9
VZ
126 wxCheckBox *m_chkEnableItem;
127 wxCheckBox *m_chkShowItem;
32b8ec41
VZ
128 wxRadioBox *m_radioDir;
129
130 // the gauge itself and the sizer it is in
131 wxRadioBox *m_radio;
132 wxSizer *m_sizerRadio;
133
134 // the text entries for command parameters
135 wxTextCtrl *m_textNumBtns,
136 *m_textMajorDim,
137 *m_textCurSel,
138 *m_textSel,
139 *m_textLabel,
140 *m_textLabelBtns;
141
142private:
5e173f35
GD
143 DECLARE_EVENT_TABLE()
144 DECLARE_WIDGETS_PAGE(RadioWidgetsPage)
32b8ec41
VZ
145};
146
147// ----------------------------------------------------------------------------
148// event tables
149// ----------------------------------------------------------------------------
150
151BEGIN_EVENT_TABLE(RadioWidgetsPage, WidgetsPage)
152 EVT_BUTTON(RadioPage_Reset, RadioWidgetsPage::OnButtonReset)
153
154 EVT_BUTTON(RadioPage_Update, RadioWidgetsPage::OnButtonRecreate)
155 EVT_BUTTON(RadioPage_LabelBtn, RadioWidgetsPage::OnButtonRecreate)
156
157 EVT_BUTTON(RadioPage_Selection, RadioWidgetsPage::OnButtonSelection)
158 EVT_BUTTON(RadioPage_Label, RadioWidgetsPage::OnButtonSetLabel)
159
160 EVT_UPDATE_UI(RadioPage_Update, RadioWidgetsPage::OnUpdateUIUpdate)
161 EVT_UPDATE_UI(RadioPage_Selection, RadioWidgetsPage::OnUpdateUISelection)
162
163 EVT_RADIOBOX(RadioPage_Radio, RadioWidgetsPage::OnRadioBox)
164
3bfa7be9
VZ
165 EVT_CHECKBOX(RadioPage_EnableItem, RadioWidgetsPage::OnEnableItem)
166 EVT_CHECKBOX(RadioPage_ShowItem, RadioWidgetsPage::OnShowItem)
167
168 EVT_UPDATE_UI(RadioPage_EnableItem, RadioWidgetsPage::OnUpdateUIEnableItem)
169 EVT_UPDATE_UI(RadioPage_ShowItem, RadioWidgetsPage::OnUpdateUIShowItem)
170
206d3a16
JS
171 EVT_CHECKBOX(wxID_ANY, RadioWidgetsPage::OnCheckOrRadioBox)
172 EVT_RADIOBOX(wxID_ANY, RadioWidgetsPage::OnCheckOrRadioBox)
32b8ec41
VZ
173END_EVENT_TABLE()
174
175// ============================================================================
176// implementation
177// ============================================================================
178
f0fa4312
WS
179#if defined(__WXUNIVERSAL__)
180 #define FAMILY_CTRLS UNIVERSAL_CTRLS
181#else
182 #define FAMILY_CTRLS NATIVE_CTRLS
183#endif
184
f2fdc4d5 185IMPLEMENT_WIDGETS_PAGE(RadioWidgetsPage, _T("Radio"),
f0fa4312 186 FAMILY_CTRLS | WITH_ITEMS_CTRLS
f2fdc4d5 187 );
32b8ec41 188
f2fdc4d5 189RadioWidgetsPage::RadioWidgetsPage(WidgetsBookCtrl *book,
61c083e7 190 wxImageList *imaglist)
261357eb 191 : WidgetsPage(book, imaglist, radio_xpm)
32b8ec41 192{
32b8ec41
VZ
193 // init everything
194 m_chkVert = (wxCheckBox *)NULL;
3bfa7be9
VZ
195 m_chkEnableItem = (wxCheckBox *)NULL;
196 m_chkShowItem = (wxCheckBox *)NULL;
32b8ec41
VZ
197
198 m_textNumBtns =
199 m_textLabelBtns =
200 m_textLabel = (wxTextCtrl *)NULL;
201
202 m_radio =
203 m_radioDir = (wxRadioBox *)NULL;
204 m_sizerRadio = (wxSizer *)NULL;
453535a7 205}
32b8ec41 206
453535a7
WS
207void RadioWidgetsPage::CreateContent()
208{
32b8ec41
VZ
209 wxSizer *sizerTop = new wxBoxSizer(wxHORIZONTAL);
210
211 // left pane
206d3a16 212 wxStaticBox *box = new wxStaticBox(this, wxID_ANY, _T("&Set style"));
32b8ec41
VZ
213
214 wxSizer *sizerLeft = new wxStaticBoxSizer(box, wxVERTICAL);
215
216 m_chkVert = CreateCheckBoxAndAddToSizer(sizerLeft, _T("&Vertical layout"));
217
218 static const wxString layoutDir[] =
219 {
220 _T("default"),
221 _T("left to right"),
222 _T("top to bottom")
223 };
224
206d3a16 225 m_radioDir = new wxRadioBox(this, wxID_ANY, _T("Numbering:"),
32b8ec41 226 wxDefaultPosition, wxDefaultSize,
7b127900
JS
227 WXSIZEOF(layoutDir), layoutDir,
228 1, wxRA_SPECIFY_COLS);
32b8ec41
VZ
229 sizerLeft->Add(m_radioDir, 0, wxGROW | wxALL, 5);
230
231 // if it's not defined, we can't change the radiobox direction
232#ifndef wxRA_LEFTTORIGHT
233 m_radioDir->Disable();
234#endif // wxRA_LEFTTORIGHT
235
236 wxSizer *sizerRow;
7b127900 237 sizerRow = CreateSizerWithTextAndLabel(_T("&Major dimension:"),
206d3a16 238 wxID_ANY,
32b8ec41
VZ
239 &m_textMajorDim);
240 sizerLeft->Add(sizerRow, 0, wxGROW | wxALL, 5);
241
7b127900 242 sizerRow = CreateSizerWithTextAndLabel(_T("&Number of buttons:"),
206d3a16 243 wxID_ANY,
32b8ec41
VZ
244 &m_textNumBtns);
245 sizerLeft->Add(sizerRow, 0, wxGROW | wxALL, 5);
246
247 wxButton *btn;
248 btn = new wxButton(this, RadioPage_Update, _T("&Update"));
249 sizerLeft->Add(btn, 0, wxALIGN_CENTRE_HORIZONTAL | wxALL, 5);
250
251 sizerLeft->Add(5, 5, 0, wxGROW | wxALL, 5); // spacer
252
253 btn = new wxButton(this, RadioPage_Reset, _T("&Reset"));
254 sizerLeft->Add(btn, 0, wxALIGN_CENTRE_HORIZONTAL | wxALL, 15);
255
256 // middle pane
206d3a16 257 wxStaticBox *box2 = new wxStaticBox(this, wxID_ANY, _T("&Change parameters"));
32b8ec41
VZ
258 wxSizer *sizerMiddle = new wxStaticBoxSizer(box2, wxVERTICAL);
259
7b127900 260 sizerRow = CreateSizerWithTextAndLabel(_T("Current selection:"),
206d3a16 261 wxID_ANY,
32b8ec41
VZ
262 &m_textCurSel);
263 sizerMiddle->Add(sizerRow, 0, wxGROW | wxALL, 5);
264
265 sizerRow = CreateSizerWithTextAndButton(RadioPage_Selection,
7b127900 266 _T("&Change selection:"),
206d3a16 267 wxID_ANY,
32b8ec41
VZ
268 &m_textSel);
269 sizerMiddle->Add(sizerRow, 0, wxGROW | wxALL, 5);
270
271 sizerRow = CreateSizerWithTextAndButton(RadioPage_Label,
7b127900 272 _T("&Label for box:"),
206d3a16 273 wxID_ANY,
32b8ec41
VZ
274 &m_textLabel);
275 sizerMiddle->Add(sizerRow, 0, wxGROW | wxALL, 5);
276
277 sizerRow = CreateSizerWithTextAndButton(RadioPage_LabelBtn,
7b127900 278 _T("&Label for buttons:"),
206d3a16 279 wxID_ANY,
32b8ec41
VZ
280 &m_textLabelBtns);
281 sizerMiddle->Add(sizerRow, 0, wxGROW | wxALL, 5);
282
3bfa7be9
VZ
283 m_chkEnableItem = CreateCheckBoxAndAddToSizer(sizerMiddle,
284 _T("Disable &2nd item"),
285 RadioPage_EnableItem);
286 m_chkShowItem = CreateCheckBoxAndAddToSizer(sizerMiddle,
287 _T("Hide 2nd &item"),
288 RadioPage_ShowItem);
8b6d589d 289
32b8ec41
VZ
290 // right pane
291 wxSizer *sizerRight = new wxBoxSizer(wxHORIZONTAL);
7b127900 292 sizerRight->SetMinSize(150, 0);
32b8ec41
VZ
293 m_sizerRadio = sizerRight; // save it to modify it later
294
295 Reset();
296 CreateRadio();
297
298 // the 3 panes panes compose the window
299 sizerTop->Add(sizerLeft, 0, wxGROW | (wxALL & ~wxLEFT), 10);
300 sizerTop->Add(sizerMiddle, 1, wxGROW | wxALL, 10);
7b127900 301 sizerTop->Add(sizerRight, 0, wxGROW | (wxALL & ~wxRIGHT), 10);
32b8ec41
VZ
302
303 // final initializations
32b8ec41 304 SetSizer(sizerTop);
32b8ec41
VZ
305}
306
32b8ec41
VZ
307// ----------------------------------------------------------------------------
308// operations
309// ----------------------------------------------------------------------------
310
311void RadioWidgetsPage::Reset()
312{
0c61716c
VZ
313 m_textMajorDim->SetValue(wxString::Format(_T("%u"), DEFAULT_MAJOR_DIM));
314 m_textNumBtns->SetValue(wxString::Format(_T("%u"), DEFAULT_NUM_ENTRIES));
32b8ec41
VZ
315 m_textLabel->SetValue(_T("I'm a radiobox"));
316 m_textLabelBtns->SetValue(_T("item"));
317
206d3a16 318 m_chkVert->SetValue(false);
3bfa7be9
VZ
319 m_chkEnableItem->SetValue(true);
320 m_chkShowItem->SetValue(true);
32b8ec41
VZ
321 m_radioDir->SetSelection(RadioDir_Default);
322}
323
324void RadioWidgetsPage::CreateRadio()
325{
326 int sel;
327 if ( m_radio )
328 {
329 sel = m_radio->GetSelection();
330
12a3f227 331 m_sizerRadio->Detach( m_radio );
32b8ec41
VZ
332
333 delete m_radio;
334 }
335 else // first time creation, no old selection to preserve
336 {
337 sel = -1;
338 }
339
340 unsigned long count;
341 if ( !m_textNumBtns->GetValue().ToULong(&count) )
342 {
343 wxLogWarning(_T("Should have a valid number for number of items."));
344
345 // fall back to default
346 count = DEFAULT_NUM_ENTRIES;
347 }
348
349 unsigned long majorDim;
350 if ( !m_textMajorDim->GetValue().ToULong(&majorDim) )
351 {
352 wxLogWarning(_T("Should have a valid major dimension number."));
353
354 // fall back to default
355 majorDim = DEFAULT_MAJOR_DIM;
356 }
357
358 wxString *items = new wxString[count];
359
360 wxString labelBtn = m_textLabelBtns->GetValue();
361 for ( size_t n = 0; n < count; n++ )
362 {
0c61716c
VZ
363 items[n] = wxString::Format(_T("%s %lu"),
364 labelBtn.c_str(), (unsigned long)n + 1);
32b8ec41
VZ
365 }
366
367 int flags = m_chkVert->GetValue() ? wxRA_VERTICAL
368 : wxRA_HORIZONTAL;
369
1301e228
VZ
370 flags |= ms_defaultFlags;
371
32b8ec41
VZ
372#ifdef wxRA_LEFTTORIGHT
373 switch ( m_radioDir->GetSelection() )
374 {
375 default:
376 wxFAIL_MSG( _T("unexpected wxRadioBox layout direction") );
377 // fall through
378
379 case RadioDir_Default:
380 break;
381
382 case RadioDir_LtoR:
383 flags |= wxRA_LEFTTORIGHT;
384 break;
385
386 case RadioDir_TtoB:
387 flags |= wxRA_TOPTOBOTTOM;
388 break;
389 }
390#endif // wxRA_LEFTTORIGHT
391
392 m_radio = new wxRadioBox(this, RadioPage_Radio,
393 m_textLabel->GetValue(),
394 wxDefaultPosition, wxDefaultSize,
395 count, items,
396 majorDim,
397 flags);
398
399 delete [] items;
400
401 if ( sel >= 0 && (size_t)sel < count )
402 {
403 m_radio->SetSelection(sel);
404 }
405
406 m_sizerRadio->Add(m_radio, 1, wxGROW);
407 m_sizerRadio->Layout();
8b6d589d 408
3bfa7be9
VZ
409 m_chkEnableItem->SetValue(true);
410 m_chkEnableItem->SetValue(true);
32b8ec41
VZ
411}
412
413// ----------------------------------------------------------------------------
414// event handlers
415// ----------------------------------------------------------------------------
416
417void RadioWidgetsPage::OnButtonReset(wxCommandEvent& WXUNUSED(event))
418{
419 Reset();
420
421 CreateRadio();
422}
423
c02e5a31 424void RadioWidgetsPage::OnCheckOrRadioBox(wxCommandEvent& WXUNUSED(event))
32b8ec41
VZ
425{
426 CreateRadio();
427}
428
429void RadioWidgetsPage::OnRadioBox(wxCommandEvent& event)
430{
431 int sel = m_radio->GetSelection();
dacaa6f1
JS
432 int event_sel = event.GetSelection();
433 wxUnusedVar(event_sel);
32b8ec41
VZ
434
435 wxLogMessage(_T("Radiobox selection changed, now %d"), sel);
436
dacaa6f1 437 wxASSERT_MSG( sel == event_sel,
32b8ec41
VZ
438 _T("selection should be the same in event and radiobox") );
439
440 m_textCurSel->SetValue(wxString::Format(_T("%d"), sel));
441}
442
443void RadioWidgetsPage::OnButtonRecreate(wxCommandEvent& WXUNUSED(event))
444{
445 CreateRadio();
446}
447
448void RadioWidgetsPage::OnButtonSetLabel(wxCommandEvent& WXUNUSED(event))
449{
450 m_radio->wxControl::SetLabel(m_textLabel->GetValue());
451}
452
453void RadioWidgetsPage::OnButtonSelection(wxCommandEvent& WXUNUSED(event))
454{
455 unsigned long sel;
456 if ( !m_textSel->GetValue().ToULong(&sel) ||
457 (sel >= (size_t)m_radio->GetCount()) )
458 {
459 wxLogWarning(_T("Invalid number specified as new selection."));
460 }
461 else
462 {
463 m_radio->SetSelection(sel);
464 }
465}
466
3bfa7be9
VZ
467void RadioWidgetsPage::OnEnableItem(wxCommandEvent& event)
468{
469 m_radio->Enable(TEST_BUTTON, event.IsChecked());
470}
471
472void RadioWidgetsPage::OnShowItem(wxCommandEvent& event)
473{
474 m_radio->Show(TEST_BUTTON, event.IsChecked());
475}
476
32b8ec41
VZ
477void RadioWidgetsPage::OnUpdateUIUpdate(wxUpdateUIEvent& event)
478{
479 unsigned long n;
480 event.Enable( m_textNumBtns->GetValue().ToULong(&n) &&
481 m_textMajorDim->GetValue().ToULong(&n) );
482}
483
484void RadioWidgetsPage::OnUpdateUISelection(wxUpdateUIEvent& event)
485{
486 unsigned long n;
487 event.Enable( m_textSel->GetValue().ToULong(&n) &&
488 (n < (size_t)m_radio->GetCount()) );
489}
490
491void RadioWidgetsPage::OnUpdateUIReset(wxUpdateUIEvent& event)
492{
493 // only enable it if something is not set to default
494 bool enable = m_chkVert->GetValue();
495
496 if ( !enable )
497 {
498 unsigned long numEntries;
499
500 enable = !m_textNumBtns->GetValue().ToULong(&numEntries) ||
501 numEntries != DEFAULT_NUM_ENTRIES;
502
503 if ( !enable )
504 {
505 unsigned long majorDim;
506
507 enable = !m_textMajorDim->GetValue().ToULong(&majorDim) ||
508 majorDim != DEFAULT_MAJOR_DIM;
509 }
510 }
511
512 event.Enable(enable);
513}
514
3bfa7be9
VZ
515void RadioWidgetsPage::OnUpdateUIEnableItem(wxUpdateUIEvent& event)
516{
517 event.SetText(m_radio->IsItemEnabled(TEST_BUTTON) ? _T("Disable &2nd item")
518 : _T("Enable &2nd item"));
519}
520
521void RadioWidgetsPage::OnUpdateUIShowItem(wxUpdateUIEvent& event)
522{
523 event.SetText(m_radio->IsItemShown(TEST_BUTTON) ? _T("Hide 2nd &item")
524 : _T("Show 2nd &item"));
525}
526
61c083e7 527#endif // wxUSE_RADIOBOX