1 /////////////////////////////////////////////////////////////////////////////
2 // Program: wxWidgets Widgets Sample
4 // Purpose: Part of the widgets sample showing wxSlider
5 // Author: Vadim Zeitlin
8 // Copyright: (c) 2001 Vadim Zeitlin
9 // License: wxWindows license
10 /////////////////////////////////////////////////////////////////////////////
12 // ============================================================================
14 // ============================================================================
16 // ----------------------------------------------------------------------------
18 // ----------------------------------------------------------------------------
20 // for compilers that support precompilation, includes "wx/wx.h".
21 #include "wx/wxprec.h"
29 // for all others, include the necessary headers
33 #include "wx/bitmap.h"
34 #include "wx/button.h"
35 #include "wx/checkbox.h"
36 #include "wx/radiobox.h"
37 #include "wx/slider.h"
38 #include "wx/statbox.h"
39 #include "wx/textctrl.h"
43 #include "wx/tooltip.h"
50 #include "icons/slider.xpm"
52 // ----------------------------------------------------------------------------
54 // ----------------------------------------------------------------------------
59 SliderPage_Reset
= wxID_HIGHEST
,
62 SliderPage_SetMinAndMax
,
63 SliderPage_SetLineSize
,
64 SliderPage_SetPageSize
,
65 SliderPage_SetTickFreq
,
66 SliderPage_SetThumbLen
,
67 SliderPage_CurValueText
,
71 SliderPage_LineSizeText
,
72 SliderPage_PageSizeText
,
73 SliderPage_TickFreqText
,
74 SliderPage_ThumbLenText
,
75 SliderPage_RadioSides
,
80 // sides radiobox values
89 // ----------------------------------------------------------------------------
91 // ----------------------------------------------------------------------------
93 class SliderWidgetsPage
: public WidgetsPage
96 SliderWidgetsPage(WidgetsBookCtrl
*book
, wxImageList
*imaglist
);
97 virtual ~SliderWidgetsPage(){};
99 virtual wxControl
*GetWidget() const { return m_slider
; }
100 virtual void RecreateWidget() { CreateSlider(); }
102 // lazy creation of the content
103 virtual void CreateContent();
107 void OnButtonReset(wxCommandEvent
& event
);
108 void OnButtonClear(wxCommandEvent
& event
);
109 void OnButtonSetValue(wxCommandEvent
& event
);
110 void OnButtonSetMinAndMax(wxCommandEvent
& event
);
111 void OnButtonSetLineSize(wxCommandEvent
& event
);
112 void OnButtonSetPageSize(wxCommandEvent
& event
);
113 void OnButtonSetTickFreq(wxCommandEvent
& event
);
114 void OnButtonSetThumbLen(wxCommandEvent
& event
);
116 void OnCheckOrRadioBox(wxCommandEvent
& event
);
118 void OnSlider(wxScrollEvent
& event
);
120 void OnUpdateUIValueButton(wxUpdateUIEvent
& event
);
121 void OnUpdateUIMinMaxButton(wxUpdateUIEvent
& event
);
122 void OnUpdateUILineSize(wxUpdateUIEvent
& event
);
123 void OnUpdateUIPageSize(wxUpdateUIEvent
& event
);
124 void OnUpdateUITickFreq(wxUpdateUIEvent
& event
);
125 void OnUpdateUIThumbLen(wxUpdateUIEvent
& event
);
126 void OnUpdateUIRadioSides(wxUpdateUIEvent
& event
);
127 void OnUpdateUIBothSides(wxUpdateUIEvent
& event
);
129 void OnUpdateUIResetButton(wxUpdateUIEvent
& event
);
131 void OnUpdateUICurValueText(wxUpdateUIEvent
& event
);
133 // reset the slider parameters
136 // (re)create the slider
139 // set the line size from the text field value
140 void DoSetLineSize();
142 // set the page size from the text field value
143 void DoSetPageSize();
145 // set the tick frequency from the text field value
146 void DoSetTickFreq();
148 // set the thumb len from the text field value
149 void DoSetThumbLen();
151 // is this slider value in range?
152 bool IsValidValue(int val
) const
153 { return (val
>= m_min
) && (val
<= m_max
); }
161 // the check/radio boxes for styles
162 wxCheckBox
*m_chkMinMaxLabels
,
168 wxRadioBox
*m_radioSides
;
170 // the slider itself and the sizer it is in
172 wxSizer
*m_sizerSlider
;
174 // the text entries for set value/range
175 wxTextCtrl
*m_textValue
,
184 DECLARE_EVENT_TABLE()
185 DECLARE_WIDGETS_PAGE(SliderWidgetsPage
)
188 // ----------------------------------------------------------------------------
190 // ----------------------------------------------------------------------------
192 BEGIN_EVENT_TABLE(SliderWidgetsPage
, WidgetsPage
)
193 EVT_BUTTON(SliderPage_Reset
, SliderWidgetsPage::OnButtonReset
)
194 EVT_BUTTON(SliderPage_SetValue
, SliderWidgetsPage::OnButtonSetValue
)
195 EVT_BUTTON(SliderPage_SetMinAndMax
, SliderWidgetsPage::OnButtonSetMinAndMax
)
196 EVT_BUTTON(SliderPage_SetLineSize
, SliderWidgetsPage::OnButtonSetLineSize
)
197 EVT_BUTTON(SliderPage_SetPageSize
, SliderWidgetsPage::OnButtonSetPageSize
)
198 EVT_BUTTON(SliderPage_SetTickFreq
, SliderWidgetsPage::OnButtonSetTickFreq
)
199 EVT_BUTTON(SliderPage_SetThumbLen
, SliderWidgetsPage::OnButtonSetThumbLen
)
201 EVT_UPDATE_UI(SliderPage_SetValue
, SliderWidgetsPage::OnUpdateUIValueButton
)
202 EVT_UPDATE_UI(SliderPage_SetMinAndMax
, SliderWidgetsPage::OnUpdateUIMinMaxButton
)
203 EVT_UPDATE_UI(SliderPage_SetLineSize
, SliderWidgetsPage::OnUpdateUILineSize
)
204 EVT_UPDATE_UI(SliderPage_SetPageSize
, SliderWidgetsPage::OnUpdateUIPageSize
)
205 EVT_UPDATE_UI(SliderPage_SetTickFreq
, SliderWidgetsPage::OnUpdateUITickFreq
)
206 EVT_UPDATE_UI(SliderPage_SetThumbLen
, SliderWidgetsPage::OnUpdateUIThumbLen
)
207 EVT_UPDATE_UI(SliderPage_RadioSides
, SliderWidgetsPage::OnUpdateUIRadioSides
)
208 EVT_UPDATE_UI(SliderPage_BothSides
, SliderWidgetsPage::OnUpdateUIBothSides
)
210 EVT_UPDATE_UI(SliderPage_Reset
, SliderWidgetsPage::OnUpdateUIResetButton
)
212 EVT_UPDATE_UI(SliderPage_CurValueText
, SliderWidgetsPage::OnUpdateUICurValueText
)
214 EVT_COMMAND_SCROLL(SliderPage_Slider
, SliderWidgetsPage::OnSlider
)
216 EVT_CHECKBOX(wxID_ANY
, SliderWidgetsPage::OnCheckOrRadioBox
)
217 EVT_RADIOBOX(wxID_ANY
, SliderWidgetsPage::OnCheckOrRadioBox
)
220 // ============================================================================
222 // ============================================================================
224 #if defined(__WXUNIVERSAL__)
225 #define FAMILY_CTRLS UNIVERSAL_CTRLS
227 #define FAMILY_CTRLS NATIVE_CTRLS
230 IMPLEMENT_WIDGETS_PAGE(SliderWidgetsPage
, wxT("Slider"), FAMILY_CTRLS
);
232 SliderWidgetsPage::SliderWidgetsPage(WidgetsBookCtrl
*book
,
233 wxImageList
*imaglist
)
234 : WidgetsPage(book
, imaglist
, slider_xpm
)
244 m_chkBothSides
= (wxCheckBox
*)NULL
;
246 m_radioSides
= (wxRadioBox
*)NULL
;
248 m_slider
= (wxSlider
*)NULL
;
249 m_sizerSlider
= (wxSizer
*)NULL
;
252 void SliderWidgetsPage::CreateContent()
254 wxSizer
*sizerTop
= new wxBoxSizer(wxHORIZONTAL
);
257 wxStaticBox
*box
= new wxStaticBox(this, wxID_ANY
, wxT("&Set style"));
258 wxSizer
*sizerLeft
= new wxStaticBoxSizer(box
, wxVERTICAL
);
260 m_chkInverse
= CreateCheckBoxAndAddToSizer(sizerLeft
, wxT("&Inverse"));
261 m_chkTicks
= CreateCheckBoxAndAddToSizer(sizerLeft
, wxT("Show &ticks"));
262 m_chkMinMaxLabels
= CreateCheckBoxAndAddToSizer(sizerLeft
, wxT("Show min/max &labels"));
263 m_chkValueLabel
= CreateCheckBoxAndAddToSizer(sizerLeft
, wxT("Show &value label"));
264 static const wxString sides
[] =
271 m_radioSides
= new wxRadioBox(this, SliderPage_RadioSides
, wxT("&Ticks/Labels"),
272 wxDefaultPosition
, wxDefaultSize
,
273 WXSIZEOF(sides
), sides
,
274 1, wxRA_SPECIFY_COLS
);
275 sizerLeft
->Add(m_radioSides
, 0, wxGROW
| wxALL
, 5);
276 m_chkBothSides
= CreateCheckBoxAndAddToSizer
277 (sizerLeft
, wxT("&Both sides"), SliderPage_BothSides
);
279 m_chkBothSides
->SetToolTip( wxT("\"Both sides\" is only supported \nin Win95 and Universal") );
280 #endif // wxUSE_TOOLTIPS
282 sizerLeft
->Add(5, 5, 0, wxGROW
| wxALL
, 5); // spacer
284 wxButton
*btn
= new wxButton(this, SliderPage_Reset
, wxT("&Reset"));
285 sizerLeft
->Add(btn
, 0, wxALIGN_CENTRE_HORIZONTAL
| wxALL
, 15);
288 wxStaticBox
*box2
= new wxStaticBox(this, wxID_ANY
, wxT("&Change slider value"));
289 wxSizer
*sizerMiddle
= new wxStaticBoxSizer(box2
, wxVERTICAL
);
292 wxSizer
*sizerRow
= CreateSizerWithTextAndLabel(wxT("Current value"),
293 SliderPage_CurValueText
,
295 text
->SetEditable(false);
297 sizerMiddle
->Add(sizerRow
, 0, wxALL
| wxGROW
, 5);
299 sizerRow
= CreateSizerWithTextAndButton(SliderPage_SetValue
,
301 SliderPage_ValueText
,
303 sizerMiddle
->Add(sizerRow
, 0, wxALL
| wxGROW
, 5);
305 sizerRow
= CreateSizerWithTextAndButton(SliderPage_SetMinAndMax
,
310 m_textMax
= new wxTextCtrl(this, SliderPage_MaxText
, wxEmptyString
);
311 sizerRow
->Add(m_textMax
, 1, wxLEFT
| wxALIGN_CENTRE_VERTICAL
, 5);
313 m_textMin
->SetValue( wxString::Format(wxT("%d"), m_min
) );
314 m_textMax
->SetValue( wxString::Format(wxT("%d"), m_max
) );
316 sizerMiddle
->Add(sizerRow
, 0, wxALL
| wxGROW
, 5);
318 sizerRow
= CreateSizerWithTextAndButton(SliderPage_SetLineSize
,
320 SliderPage_LineSizeText
,
323 sizerMiddle
->Add(sizerRow
, 0, wxALL
| wxGROW
, 5);
325 sizerRow
= CreateSizerWithTextAndButton(SliderPage_SetPageSize
,
327 SliderPage_PageSizeText
,
330 sizerMiddle
->Add(sizerRow
, 0, wxALL
| wxGROW
, 5);
332 sizerRow
= CreateSizerWithTextAndButton(SliderPage_SetTickFreq
,
333 wxT("Tick &frequency"),
334 SliderPage_TickFreqText
,
337 m_textTickFreq
->SetValue(wxT("10"));
339 sizerMiddle
->Add(sizerRow
, 0, wxALL
| wxGROW
, 5);
341 sizerRow
= CreateSizerWithTextAndButton(SliderPage_SetThumbLen
,
342 wxT("Thumb &length"),
343 SliderPage_ThumbLenText
,
346 sizerMiddle
->Add(sizerRow
, 0, wxALL
| wxGROW
, 5);
349 wxSizer
*sizerRight
= new wxBoxSizer(wxHORIZONTAL
);
350 sizerRight
->SetMinSize(150, 40);
351 m_sizerSlider
= sizerRight
; // save it to modify it later
356 m_textLineSize
->SetValue(wxString::Format(wxT("%d"), m_slider
->GetLineSize()));
357 m_textPageSize
->SetValue(wxString::Format(wxT("%d"), m_slider
->GetPageSize()));
359 // the 3 panes panes compose the window
360 sizerTop
->Add(sizerLeft
, 0, wxGROW
| (wxALL
& ~wxLEFT
), 10);
361 sizerTop
->Add(sizerMiddle
, 0, wxGROW
| wxALL
, 10);
362 sizerTop
->Add(sizerRight
, 1, wxGROW
| (wxALL
& ~wxRIGHT
), 10);
364 // final initializations
368 // ----------------------------------------------------------------------------
370 // ----------------------------------------------------------------------------
372 void SliderWidgetsPage::Reset()
374 m_chkInverse
->SetValue(false);
375 m_chkTicks
->SetValue(true);
376 m_chkValueLabel
->SetValue(true);
377 m_chkMinMaxLabels
->SetValue(true);
378 m_chkBothSides
->SetValue(false);
380 m_radioSides
->SetSelection(SliderTicks_Top
);
383 void SliderWidgetsPage::CreateSlider()
385 int flags
= ms_defaultFlags
;
387 if ( m_chkInverse
->GetValue() )
389 flags
|= wxSL_INVERSE
;
392 if ( m_chkMinMaxLabels
->GetValue() )
394 flags
|= wxSL_MIN_MAX_LABELS
;
397 if ( m_chkValueLabel
->GetValue() )
399 flags
|= wxSL_VALUE_LABEL
;
402 if ( m_chkTicks
->GetValue() )
404 flags
|= wxSL_AUTOTICKS
;
407 switch ( m_radioSides
->GetSelection() )
409 case SliderTicks_Top
:
413 case SliderTicks_Left
:
414 flags
|= wxSL_LEFT
| wxSL_VERTICAL
;
417 case SliderTicks_Bottom
:
418 flags
|= wxSL_BOTTOM
;
421 case SliderTicks_Right
:
422 flags
|= wxSL_RIGHT
| wxSL_VERTICAL
;
426 wxFAIL_MSG(wxT("unexpected radiobox selection"));
430 if ( m_chkBothSides
->GetValue() )
438 int valOld
= m_slider
->GetValue();
439 if ( !IsValidValue(valOld
) )
444 m_sizerSlider
->Detach( m_slider
);
446 if ( m_sizerSlider
->GetChildren().GetCount() )
448 // we have 2 spacers, remove them too
449 m_sizerSlider
->Remove( 0 );
450 m_sizerSlider
->Remove( 0 );
456 m_slider
= new wxSlider(this, SliderPage_Slider
,
458 wxDefaultPosition
, wxDefaultSize
,
461 if ( m_slider
->HasFlag(wxSL_VERTICAL
) )
463 m_sizerSlider
->Add(0, 0, 1);
464 m_sizerSlider
->Add(m_slider
, 0, wxGROW
| wxALL
, 5);
465 m_sizerSlider
->Add(0, 0, 1);
469 m_sizerSlider
->Add(m_slider
, 1, wxCENTRE
| wxALL
, 5);
472 if ( m_chkTicks
->GetValue() )
477 m_sizerSlider
->Layout();
480 void SliderWidgetsPage::DoSetLineSize()
483 if ( !m_textLineSize
->GetValue().ToLong(&lineSize
) )
485 wxLogWarning(wxT("Invalid slider line size"));
490 m_slider
->SetLineSize(lineSize
);
492 if ( m_slider
->GetLineSize() != lineSize
)
494 wxLogWarning(wxT("Invalid line size in slider."));
498 void SliderWidgetsPage::DoSetPageSize()
501 if ( !m_textPageSize
->GetValue().ToLong(&pageSize
) )
503 wxLogWarning(wxT("Invalid slider page size"));
508 m_slider
->SetPageSize(pageSize
);
510 if ( m_slider
->GetPageSize() != pageSize
)
512 wxLogWarning(wxT("Invalid page size in slider."));
516 void SliderWidgetsPage::DoSetTickFreq()
519 if ( !m_textTickFreq
->GetValue().ToLong(&freq
) )
521 wxLogWarning(wxT("Invalid slider tick frequency"));
526 m_slider
->SetTickFreq(freq
, 0 /* unused */);
529 void SliderWidgetsPage::DoSetThumbLen()
532 if ( !m_textThumbLen
->GetValue().ToLong(&len
) )
534 wxLogWarning(wxT("Invalid slider thumb length"));
539 m_slider
->SetThumbLength(len
);
542 // ----------------------------------------------------------------------------
544 // ----------------------------------------------------------------------------
546 void SliderWidgetsPage::OnButtonReset(wxCommandEvent
& WXUNUSED(event
))
553 void SliderWidgetsPage::OnButtonSetLineSize(wxCommandEvent
& WXUNUSED(event
))
558 void SliderWidgetsPage::OnButtonSetPageSize(wxCommandEvent
& WXUNUSED(event
))
563 void SliderWidgetsPage::OnButtonSetTickFreq(wxCommandEvent
& WXUNUSED(event
))
568 void SliderWidgetsPage::OnButtonSetThumbLen(wxCommandEvent
& WXUNUSED(event
))
573 void SliderWidgetsPage::OnButtonSetMinAndMax(wxCommandEvent
& WXUNUSED(event
))
576 maxNew
= 0; // init to suppress compiler warning
577 if ( !m_textMin
->GetValue().ToLong(&minNew
) ||
578 !m_textMax
->GetValue().ToLong(&maxNew
) ||
581 wxLogWarning(wxT("Invalid min/max values for the slider."));
589 m_slider
->SetRange(minNew
, maxNew
);
591 if ( m_slider
->GetMin() != m_min
||
592 m_slider
->GetMax() != m_max
)
594 wxLogWarning(wxT("Invalid range in slider."));
598 void SliderWidgetsPage::OnButtonSetValue(wxCommandEvent
& WXUNUSED(event
))
601 if ( !m_textValue
->GetValue().ToLong(&val
) || !IsValidValue(val
) )
603 wxLogWarning(wxT("Invalid slider value."));
608 m_slider
->SetValue(val
);
611 void SliderWidgetsPage::OnUpdateUIValueButton(wxUpdateUIEvent
& event
)
614 event
.Enable( m_textValue
->GetValue().ToLong(&val
) && IsValidValue(val
) );
617 void SliderWidgetsPage::OnUpdateUILineSize(wxUpdateUIEvent
& event
)
620 event
.Enable( m_textLineSize
->GetValue().ToLong(&lineSize
) &&
621 (lineSize
> 0) && (lineSize
<= m_max
- m_min
) );
624 void SliderWidgetsPage::OnUpdateUIPageSize(wxUpdateUIEvent
& event
)
627 event
.Enable( m_textPageSize
->GetValue().ToLong(&pageSize
) &&
628 (pageSize
> 0) && (pageSize
<= m_max
- m_min
) );
631 void SliderWidgetsPage::OnUpdateUITickFreq(wxUpdateUIEvent
& event
)
634 event
.Enable( m_chkTicks
->GetValue() &&
635 m_textTickFreq
->GetValue().ToLong(&freq
) &&
636 (freq
> 0) && (freq
<= m_max
- m_min
) );
639 void SliderWidgetsPage::OnUpdateUIThumbLen(wxUpdateUIEvent
& event
)
642 event
.Enable( m_textThumbLen
->GetValue().ToLong(&val
));
645 void SliderWidgetsPage::OnUpdateUIMinMaxButton(wxUpdateUIEvent
& event
)
648 event
.Enable( m_textMin
->GetValue().ToLong(&mn
) &&
649 m_textMax
->GetValue().ToLong(&mx
) &&
653 void SliderWidgetsPage::OnUpdateUIResetButton(wxUpdateUIEvent
& event
)
655 event
.Enable( m_chkInverse
->GetValue() ||
656 !m_chkTicks
->GetValue() ||
657 !m_chkValueLabel
->GetValue() ||
658 !m_chkMinMaxLabels
->GetValue() ||
659 m_chkBothSides
->GetValue() ||
660 m_radioSides
->GetSelection() != SliderTicks_Top
);
663 void SliderWidgetsPage::OnCheckOrRadioBox(wxCommandEvent
& WXUNUSED(event
))
668 void SliderWidgetsPage::OnUpdateUICurValueText(wxUpdateUIEvent
& event
)
670 event
.SetText( wxString::Format(wxT("%d"), m_slider
->GetValue()) );
673 void SliderWidgetsPage::OnUpdateUIRadioSides(wxUpdateUIEvent
& event
)
675 event
.Enable( m_chkValueLabel
->GetValue() || m_chkTicks
->GetValue() );
678 void SliderWidgetsPage::OnUpdateUIBothSides(wxUpdateUIEvent
& event
)
680 #if defined(__WXMSW__) || defined(__WXUNIVERSAL__)
681 event
.Enable( m_chkTicks
->GetValue() );
683 event
.Enable( false );
684 #endif // defined(__WXMSW__) || defined(__WXUNIVERSAL__)
687 void SliderWidgetsPage::OnSlider(wxScrollEvent
& event
)
689 wxASSERT_MSG( event
.GetInt() == m_slider
->GetValue(),
690 wxT("slider value should be the same") );
692 wxEventType eventType
= event
.GetEventType();
695 This array takes the EXACT order of the declarations in
697 (section "wxScrollBar and wxSlider event identifiers")
699 static const wxChar
*eventNames
[] =
701 wxT("wxEVT_SCROLL_TOP"),
702 wxT("wxEVT_SCROLL_BOTTOM"),
703 wxT("wxEVT_SCROLL_LINEUP"),
704 wxT("wxEVT_SCROLL_LINEDOWN"),
705 wxT("wxEVT_SCROLL_PAGEUP"),
706 wxT("wxEVT_SCROLL_PAGEDOWN"),
707 wxT("wxEVT_SCROLL_THUMBTRACK"),
708 wxT("wxEVT_SCROLL_THUMBRELEASE"),
709 wxT("wxEVT_SCROLL_CHANGED")
712 int index
= eventType
- wxEVT_SCROLL_TOP
;
715 If this assert is triggered, there is an unknown slider event which
716 should be added to the above eventNames array.
718 wxASSERT_MSG(index
>= 0 && (size_t)index
< WXSIZEOF(eventNames
),
719 wxT("Unknown slider event") );
722 static int s_numSliderEvents
= 0;
724 wxLogMessage(wxT("Slider event #%d: %s (pos = %d, int value = %d)"),
731 #endif // wxUSE_SLIDER