]> git.saurik.com Git - wxWidgets.git/blob - src/msw/spinctrl.cpp
regen ReST docs
[wxWidgets.git] / src / msw / spinctrl.cpp
1 /////////////////////////////////////////////////////////////////////////////
2 // Name: src/msw/spinctrl.cpp
3 // Purpose: wxSpinCtrl class implementation for Win32
4 // Author: Vadim Zeitlin
5 // Modified by:
6 // Created: 22.07.99
7 // RCS-ID: $Id$
8 // Copyright: (c) 1999-2005 Vadim Zeitlin
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
11
12 // ============================================================================
13 // declarations
14 // ============================================================================
15
16 // ----------------------------------------------------------------------------
17 // headers
18 // ----------------------------------------------------------------------------
19
20 // for compilers that support precompilation, includes "wx.h".
21 #include "wx/wxprec.h"
22
23 #ifdef __BORLANDC__
24 #pragma hdrstop
25 #endif
26
27 #if wxUSE_SPINCTRL
28
29 #include "wx/spinctrl.h"
30
31 #ifndef WX_PRECOMP
32 #include "wx/msw/wrapcctl.h" // include <commctrl.h> "properly"
33 #include "wx/event.h"
34 #include "wx/textctrl.h"
35 #endif
36
37 #include "wx/msw/private.h"
38
39 #if wxUSE_TOOLTIPS
40 #include "wx/tooltip.h"
41 #endif // wxUSE_TOOLTIPS
42
43 #include <limits.h> // for INT_MIN
44
45 // ----------------------------------------------------------------------------
46 // macros
47 // ----------------------------------------------------------------------------
48
49 #if wxUSE_EXTENDED_RTTI
50 WX_DEFINE_FLAGS( wxSpinCtrlStyle )
51
52 wxBEGIN_FLAGS( wxSpinCtrlStyle )
53 // new style border flags, we put them first to
54 // use them for streaming out
55 wxFLAGS_MEMBER(wxBORDER_SIMPLE)
56 wxFLAGS_MEMBER(wxBORDER_SUNKEN)
57 wxFLAGS_MEMBER(wxBORDER_DOUBLE)
58 wxFLAGS_MEMBER(wxBORDER_RAISED)
59 wxFLAGS_MEMBER(wxBORDER_STATIC)
60 wxFLAGS_MEMBER(wxBORDER_NONE)
61
62 // old style border flags
63 wxFLAGS_MEMBER(wxSIMPLE_BORDER)
64 wxFLAGS_MEMBER(wxSUNKEN_BORDER)
65 wxFLAGS_MEMBER(wxDOUBLE_BORDER)
66 wxFLAGS_MEMBER(wxRAISED_BORDER)
67 wxFLAGS_MEMBER(wxSTATIC_BORDER)
68 wxFLAGS_MEMBER(wxBORDER)
69
70 // standard window styles
71 wxFLAGS_MEMBER(wxTAB_TRAVERSAL)
72 wxFLAGS_MEMBER(wxCLIP_CHILDREN)
73 wxFLAGS_MEMBER(wxTRANSPARENT_WINDOW)
74 wxFLAGS_MEMBER(wxWANTS_CHARS)
75 wxFLAGS_MEMBER(wxFULL_REPAINT_ON_RESIZE)
76 wxFLAGS_MEMBER(wxALWAYS_SHOW_SB )
77 wxFLAGS_MEMBER(wxVSCROLL)
78 wxFLAGS_MEMBER(wxHSCROLL)
79
80 wxFLAGS_MEMBER(wxSP_HORIZONTAL)
81 wxFLAGS_MEMBER(wxSP_VERTICAL)
82 wxFLAGS_MEMBER(wxSP_ARROW_KEYS)
83 wxFLAGS_MEMBER(wxSP_WRAP)
84
85 wxEND_FLAGS( wxSpinCtrlStyle )
86
87 IMPLEMENT_DYNAMIC_CLASS_XTI(wxSpinCtrl, wxControl,"wx/spinbut.h")
88
89 wxBEGIN_PROPERTIES_TABLE(wxSpinCtrl)
90 wxEVENT_RANGE_PROPERTY( Spin , wxEVT_SCROLL_TOP , wxEVT_SCROLL_ENDSCROLL , wxSpinEvent )
91 wxEVENT_PROPERTY( Updated , wxEVT_COMMAND_SPINCTRL_UPDATED , wxCommandEvent )
92 wxEVENT_PROPERTY( TextUpdated , wxEVT_COMMAND_TEXT_UPDATED , wxCommandEvent )
93 wxEVENT_PROPERTY( TextEnter , wxEVT_COMMAND_TEXT_ENTER , wxCommandEvent )
94
95 wxPROPERTY( ValueString , wxString , SetValue , GetValue , EMPTY_MACROVALUE , 0 /*flags*/ , wxT("Helpstring") , wxT("group")) ;
96 wxPROPERTY( Value , int , SetValue, GetValue, 0 , 0 /*flags*/ , wxT("Helpstring") , wxT("group"))
97 wxPROPERTY( Min , int , SetMin, GetMin, 0, 0 /*flags*/ , wxT("Helpstring") , wxT("group") )
98 wxPROPERTY( Max , int , SetMax, GetMax, 0 , 0 /*flags*/ , wxT("Helpstring") , wxT("group"))
99 wxPROPERTY_FLAGS( WindowStyle , wxSpinCtrlStyle , long , SetWindowStyleFlag , GetWindowStyleFlag , EMPTY_MACROVALUE , 0 /*flags*/ , wxT("Helpstring") , wxT("group")) // style
100 /*
101 TODO PROPERTIES
102 style wxSP_ARROW_KEYS
103 */
104 wxEND_PROPERTIES_TABLE()
105
106 wxBEGIN_HANDLERS_TABLE(wxSpinCtrl)
107 wxEND_HANDLERS_TABLE()
108
109 wxCONSTRUCTOR_6( wxSpinCtrl , wxWindow* , Parent , wxWindowID , Id , wxString , ValueString , wxPoint , Position , wxSize , Size , long , WindowStyle )
110 #else
111 IMPLEMENT_DYNAMIC_CLASS(wxSpinCtrl, wxControl)
112 #endif
113
114 //pmg EVT_KILL_FOCUS
115 BEGIN_EVENT_TABLE(wxSpinCtrl, wxSpinButton)
116 EVT_CHAR(wxSpinCtrl::OnChar)
117
118 EVT_SET_FOCUS(wxSpinCtrl::OnSetFocus)
119 EVT_KILL_FOCUS(wxSpinCtrl::OnKillFocus)
120 EVT_SPIN(wxID_ANY, wxSpinCtrl::OnSpinChange)
121 END_EVENT_TABLE()
122
123 #define GetBuddyHwnd() (HWND)(m_hwndBuddy)
124
125 // ----------------------------------------------------------------------------
126 // constants
127 // ----------------------------------------------------------------------------
128
129 // the margin between the up-down control and its buddy (can be arbitrary,
130 // choose what you like - or may be decide during run-time depending on the
131 // font size?)
132 static const int MARGIN_BETWEEN = 1;
133
134 // ============================================================================
135 // implementation
136 // ============================================================================
137
138 wxArraySpins wxSpinCtrl::ms_allSpins;
139
140 // ----------------------------------------------------------------------------
141 // wnd proc for the buddy text ctrl
142 // ----------------------------------------------------------------------------
143
144 LRESULT APIENTRY _EXPORT wxBuddyTextWndProc(HWND hwnd,
145 UINT message,
146 WPARAM wParam,
147 LPARAM lParam)
148 {
149 wxSpinCtrl *spin = (wxSpinCtrl *)wxGetWindowUserData(hwnd);
150
151 // forward some messages (the key and focus ones only so far) to
152 // the spin ctrl
153 switch ( message )
154 {
155 case WM_SETFOCUS:
156 // if the focus comes from the spin control itself, don't set it
157 // back to it -- we don't want to go into an infinite loop
158 if ( (WXHWND)wParam == spin->GetHWND() )
159 break;
160 //else: fall through
161
162 case WM_KILLFOCUS:
163 case WM_CHAR:
164 case WM_DEADCHAR:
165 case WM_KEYUP:
166 case WM_KEYDOWN:
167 spin->MSWWindowProc(message, wParam, lParam);
168
169 // The control may have been deleted at this point, so check.
170 if ( !::IsWindow(hwnd) || wxGetWindowUserData(hwnd) != spin )
171 return 0;
172 break;
173
174 case WM_GETDLGCODE:
175 // we want to get WXK_RETURN in order to generate the event for it
176 return DLGC_WANTCHARS;
177 }
178
179 return ::CallWindowProc(CASTWNDPROC spin->GetBuddyWndProc(),
180 hwnd, message, wParam, lParam);
181 }
182
183 /* static */
184 wxSpinCtrl *wxSpinCtrl::GetSpinForTextCtrl(WXHWND hwndBuddy)
185 {
186 wxSpinCtrl *spin = (wxSpinCtrl *)wxGetWindowUserData((HWND)hwndBuddy);
187
188 int i = ms_allSpins.Index(spin);
189
190 if ( i == wxNOT_FOUND )
191 return NULL;
192
193 // sanity check
194 wxASSERT_MSG( spin->m_hwndBuddy == hwndBuddy,
195 _T("wxSpinCtrl has incorrect buddy HWND!") );
196
197 return spin;
198 }
199
200 // process a WM_COMMAND generated by the buddy text control
201 bool wxSpinCtrl::ProcessTextCommand(WXWORD cmd, WXWORD WXUNUSED(id))
202 {
203 if ( cmd == EN_CHANGE )
204 {
205 wxCommandEvent event(wxEVT_COMMAND_TEXT_UPDATED, GetId());
206 event.SetEventObject(this);
207 wxString val = wxGetWindowText(m_hwndBuddy);
208 event.SetString(val);
209 event.SetInt(GetValue());
210 return GetEventHandler()->ProcessEvent(event);
211 }
212
213 // not processed
214 return false;
215 }
216
217 void wxSpinCtrl::OnChar(wxKeyEvent& event)
218 {
219 switch ( event.GetKeyCode() )
220 {
221 case WXK_RETURN:
222 {
223 wxCommandEvent event(wxEVT_COMMAND_TEXT_ENTER, m_windowId);
224 InitCommandEvent(event);
225 wxString val = wxGetWindowText(m_hwndBuddy);
226 event.SetString(val);
227 event.SetInt(GetValue());
228 if ( GetEventHandler()->ProcessEvent(event) )
229 return;
230 break;
231 }
232
233 case WXK_TAB:
234 // always produce navigation event - even if we process TAB
235 // ourselves the fact that we got here means that the user code
236 // decided to skip processing of this TAB - probably to let it
237 // do its default job.
238 {
239 wxNavigationKeyEvent eventNav;
240 eventNav.SetDirection(!event.ShiftDown());
241 eventNav.SetWindowChange(event.ControlDown());
242 eventNav.SetEventObject(this);
243
244 if ( GetParent()->GetEventHandler()->ProcessEvent(eventNav) )
245 return;
246 }
247 break;
248 }
249
250 // no, we didn't process it
251 event.Skip();
252 }
253
254 void wxSpinCtrl::OnKillFocus(wxFocusEvent& event)
255 {
256 // ensure that a correct value is shown by the control
257 NormalizeValue();
258 event.Skip();
259 }
260
261 void wxSpinCtrl::OnSetFocus(wxFocusEvent& event)
262 {
263 // when we get focus, give it to our buddy window as it needs it more than
264 // we do
265 ::SetFocus((HWND)m_hwndBuddy);
266
267 event.Skip();
268 }
269
270 void wxSpinCtrl::NormalizeValue()
271 {
272 int value = GetValue();
273 SetValue( value );
274 if (value != m_oldValue)
275 {
276 wxCommandEvent event( wxEVT_COMMAND_SPINCTRL_UPDATED, GetId() );
277 event.SetEventObject( this );
278 event.SetInt( value );
279 GetEventHandler()->ProcessEvent( event );
280 m_oldValue = value;
281 }
282 }
283
284 // ----------------------------------------------------------------------------
285 // construction
286 // ----------------------------------------------------------------------------
287
288 bool wxSpinCtrl::Create(wxWindow *parent,
289 wxWindowID id,
290 const wxString& value,
291 const wxPoint& pos,
292 const wxSize& size,
293 long style,
294 int min, int max, int initial,
295 const wxString& name)
296 {
297 // before using DoGetBestSize(), have to set style to let the base class
298 // know whether this is a horizontal or vertical control (we're always
299 // vertical)
300 style |= wxSP_VERTICAL;
301
302 if ( (style & wxBORDER_MASK) == wxBORDER_DEFAULT )
303 #ifdef __WXWINCE__
304 style |= wxBORDER_SIMPLE;
305 #else
306 style |= wxBORDER_SUNKEN;
307 #endif
308
309 SetWindowStyle(style);
310
311 WXDWORD exStyle = 0;
312 WXDWORD msStyle = MSWGetStyle(GetWindowStyle(), & exStyle) ;
313
314 // calculate the sizes: the size given is the toal size for both controls
315 // and we need to fit them both in the given width (height is the same)
316 wxSize sizeText(size), sizeBtn(size);
317 sizeBtn.x = wxSpinButton::DoGetBestSize().x;
318 if ( sizeText.x <= 0 )
319 {
320 // DEFAULT_ITEM_WIDTH is the default width for the text control
321 sizeText.x = DEFAULT_ITEM_WIDTH + MARGIN_BETWEEN + sizeBtn.x;
322 }
323
324 sizeText.x -= sizeBtn.x + MARGIN_BETWEEN;
325 if ( sizeText.x <= 0 )
326 {
327 wxLogDebug(_T("not enough space for wxSpinCtrl!"));
328 }
329
330 wxPoint posBtn(pos);
331 posBtn.x += sizeText.x + MARGIN_BETWEEN;
332
333 // we must create the text control before the spin button for the purpose
334 // of the dialog navigation: if there is a static text just before the spin
335 // control, activating it by Alt-letter should give focus to the text
336 // control, not the spin and the dialog navigation code will give focus to
337 // the next control (at Windows level), not the one after it
338
339 // create the text window
340
341 m_hwndBuddy = (WXHWND)::CreateWindowEx
342 (
343 exStyle, // sunken border
344 _T("EDIT"), // window class
345 NULL, // no window title
346 msStyle, // style (will be shown later)
347 pos.x, pos.y, // position
348 0, 0, // size (will be set later)
349 GetHwndOf(parent), // parent
350 (HMENU)-1, // control id
351 wxGetInstance(), // app instance
352 NULL // unused client data
353 );
354
355 if ( !m_hwndBuddy )
356 {
357 wxLogLastError(wxT("CreateWindow(buddy text window)"));
358
359 return false;
360 }
361
362
363 // create the spin button
364 if ( !wxSpinButton::Create(parent, id, posBtn, sizeBtn, style, name) )
365 {
366 return false;
367 }
368
369 SetRange(min, max);
370 SetValue(initial);
371
372 m_oldValue = initial;
373
374 // subclass the text ctrl to be able to intercept some events
375 wxSetWindowUserData(GetBuddyHwnd(), this);
376 m_wndProcBuddy = (WXFARPROC)wxSetWindowProc(GetBuddyHwnd(),
377 wxBuddyTextWndProc);
378
379 // set up fonts and colours (This is nomally done in MSWCreateControl)
380 InheritAttributes();
381 if (!m_hasFont)
382 SetFont(GetDefaultAttributes().font);
383
384 // set the size of the text window - can do it only now, because we
385 // couldn't call DoGetBestSize() before as font wasn't set
386 if ( sizeText.y <= 0 )
387 {
388 int cx, cy;
389 wxGetCharSize(GetHWND(), &cx, &cy, GetFont());
390
391 sizeText.y = EDIT_HEIGHT_FROM_CHAR_HEIGHT(cy);
392 }
393
394 SetBestSize(size);
395
396 (void)::ShowWindow(GetBuddyHwnd(), SW_SHOW);
397
398 // associate the text window with the spin button
399 (void)::SendMessage(GetHwnd(), UDM_SETBUDDY, (WPARAM)m_hwndBuddy, 0);
400
401 if ( !value.empty() )
402 {
403 SetValue(value);
404 }
405
406 // do it after finishing with m_hwndBuddy creation to avoid generating
407 // initial wxEVT_COMMAND_TEXT_UPDATED message
408 ms_allSpins.Add(this);
409
410 return true;
411 }
412
413 wxSpinCtrl::~wxSpinCtrl()
414 {
415 ms_allSpins.Remove(this);
416
417 // This removes spurious memory leak reporting
418 if (ms_allSpins.GetCount() == 0)
419 ms_allSpins.Clear();
420
421 // destroy the buddy window because this pointer which wxBuddyTextWndProc
422 // uses will not soon be valid any more
423 ::DestroyWindow(GetBuddyHwnd());
424 }
425
426 // ----------------------------------------------------------------------------
427 // wxTextCtrl-like methods
428 // ----------------------------------------------------------------------------
429
430 void wxSpinCtrl::SetValue(const wxString& text)
431 {
432 if ( !::SetWindowText(GetBuddyHwnd(), text.c_str()) )
433 {
434 wxLogLastError(wxT("SetWindowText(buddy)"));
435 }
436 }
437
438 void wxSpinCtrl::SetValue(int val)
439 {
440 wxSpinButton::SetValue(val);
441
442 // normally setting the value of the spin button is enough as it updates
443 // its buddy control automatically ...
444 if ( wxGetWindowText(m_hwndBuddy).empty() )
445 {
446 // ... but sometimes it doesn't, notably when the value is 0 and the
447 // text control is currently empty, the spin button seems to be happy
448 // to leave it like this, while we really want to always show the
449 // current value in the control, so do it manually
450 ::SetWindowText(GetBuddyHwnd(), wxString::Format(_T("%d"), val));
451 }
452
453 m_oldValue = GetValue();
454 }
455
456 int wxSpinCtrl::GetValue() const
457 {
458 wxString val = wxGetWindowText(m_hwndBuddy);
459
460 long n;
461 if ( (wxSscanf(val, wxT("%ld"), &n) != 1) )
462 n = INT_MIN;
463
464 if ( n < m_min )
465 n = m_min;
466 if ( n > m_max )
467 n = m_max;
468
469 return n;
470 }
471
472 void wxSpinCtrl::SetSelection(long from, long to)
473 {
474 // if from and to are both -1, it means (in wxWidgets) that all text should
475 // be selected - translate into Windows convention
476 if ( (from == -1) && (to == -1) )
477 {
478 from = 0;
479 }
480
481 ::SendMessage(GetBuddyHwnd(), EM_SETSEL, (WPARAM)from, (LPARAM)to);
482 }
483
484 // ----------------------------------------------------------------------------
485 // forward some methods to subcontrols
486 // ----------------------------------------------------------------------------
487
488 bool wxSpinCtrl::SetFont(const wxFont& font)
489 {
490 if ( !wxWindowBase::SetFont(font) )
491 {
492 // nothing to do
493 return false;
494 }
495
496 WXHANDLE hFont = GetFont().GetResourceHandle();
497 (void)::SendMessage(GetBuddyHwnd(), WM_SETFONT, (WPARAM)hFont, TRUE);
498
499 return true;
500 }
501
502 bool wxSpinCtrl::Show(bool show)
503 {
504 if ( !wxControl::Show(show) )
505 {
506 return false;
507 }
508
509 ::ShowWindow(GetBuddyHwnd(), show ? SW_SHOW : SW_HIDE);
510
511 return true;
512 }
513
514 bool wxSpinCtrl::Enable(bool enable)
515 {
516 if ( !wxControl::Enable(enable) )
517 {
518 return false;
519 }
520
521 ::EnableWindow(GetBuddyHwnd(), enable);
522
523 return true;
524 }
525
526 void wxSpinCtrl::SetFocus()
527 {
528 ::SetFocus(GetBuddyHwnd());
529 }
530
531 #if wxUSE_TOOLTIPS
532
533 void wxSpinCtrl::DoSetToolTip(wxToolTip *tip)
534 {
535 wxSpinButton::DoSetToolTip(tip);
536
537 if ( tip )
538 tip->Add(m_hwndBuddy);
539 }
540
541 #endif // wxUSE_TOOLTIPS
542
543 // ----------------------------------------------------------------------------
544 // event processing
545 // ----------------------------------------------------------------------------
546
547 void wxSpinCtrl::OnSpinChange(wxSpinEvent& eventSpin)
548 {
549 wxCommandEvent event(wxEVT_COMMAND_SPINCTRL_UPDATED, GetId());
550 event.SetEventObject(this);
551 int value = eventSpin.GetPosition();
552 event.SetInt( value );
553
554 if (value != m_oldValue)
555 (void)GetEventHandler()->ProcessEvent(event);
556
557 if ( eventSpin.GetSkipped() )
558 {
559 event.Skip();
560 }
561
562 m_oldValue = value;
563 }
564
565 // ----------------------------------------------------------------------------
566 // size calculations
567 // ----------------------------------------------------------------------------
568
569 wxSize wxSpinCtrl::DoGetBestSize() const
570 {
571 wxSize sizeBtn = wxSpinButton::DoGetBestSize();
572 sizeBtn.x += DEFAULT_ITEM_WIDTH + MARGIN_BETWEEN;
573
574 int y;
575 wxGetCharSize(GetHWND(), NULL, &y, GetFont());
576 y = EDIT_HEIGHT_FROM_CHAR_HEIGHT(y);
577
578 // JACS: we should always use the height calculated
579 // from above, because otherwise we'll get a spin control
580 // that's too big. So never use the height calculated
581 // from wxSpinButton::DoGetBestSize().
582
583 // if ( sizeBtn.y < y )
584 {
585 // make the text tall enough
586 sizeBtn.y = y;
587 }
588
589 return sizeBtn;
590 }
591
592 void wxSpinCtrl::DoMoveWindow(int x, int y, int width, int height)
593 {
594 int widthBtn = wxSpinButton::DoGetBestSize().x;
595 int widthText = width - widthBtn - MARGIN_BETWEEN;
596 if ( widthText <= 0 )
597 {
598 wxLogDebug(_T("not enough space for wxSpinCtrl!"));
599 }
600
601 // 1) The buddy window
602 DoMoveSibling(m_hwndBuddy, x, y, widthText, height);
603
604 // 2) The button window
605 x += widthText + MARGIN_BETWEEN;
606 wxSpinButton::DoMoveWindow(x, y, widthBtn, height);
607 }
608
609 // get total size of the control
610 void wxSpinCtrl::DoGetSize(int *x, int *y) const
611 {
612 RECT spinrect, textrect, ctrlrect;
613 GetWindowRect(GetHwnd(), &spinrect);
614 GetWindowRect(GetBuddyHwnd(), &textrect);
615 UnionRect(&ctrlrect,&textrect, &spinrect);
616
617 if ( x )
618 *x = ctrlrect.right - ctrlrect.left;
619 if ( y )
620 *y = ctrlrect.bottom - ctrlrect.top;
621 }
622
623 void wxSpinCtrl::DoGetPosition(int *x, int *y) const
624 {
625 // hack: pretend that our HWND is the text control just for a moment
626 WXHWND hWnd = GetHWND();
627 wxConstCast(this, wxSpinCtrl)->m_hWnd = m_hwndBuddy;
628
629 wxSpinButton::DoGetPosition(x, y);
630
631 wxConstCast(this, wxSpinCtrl)->m_hWnd = hWnd;
632 }
633
634 #endif // wxUSE_SPINCTRL