src/msw/spinctrl.cpp

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        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) Vadim Zeitlin
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 // ============================================================================
  13 // declarations
  14 // ============================================================================
  15
  16 #ifdef __GNUG__
  17     #pragma implementation "spinctrlbase.h"
  18     #pragma implementation "spinctrl.h"
  19 #endif
  20
  21 // ----------------------------------------------------------------------------
  22 // headers
  23 // ----------------------------------------------------------------------------
  24
  25 // for compilers that support precompilation, includes "wx.h".
  26 #include "wx/wxprec.h"
  27
  28 #ifdef __BORLANDC__
  29     #pragma hdrstop
  30 #endif
  31
  32 #ifndef WX_PRECOMP
  33     #include "wx/wx.h"
  34 #endif
  35
  36 #if wxUSE_SPINCTRL
  37
  38 #if defined(__WIN95__)
  39
  40 #include "wx/spinctrl.h"
  41 #include "wx/msw/private.h"
  42
  43 #if defined(__WIN95__) && !((defined(__GNUWIN32_OLD__) || defined(__TWIN32__)) && !defined(__CYGWIN10__))
  44     #include <commctrl.h>
  45 #endif
  46
  47 #include <limits.h>         // for INT_MIN
  48
  49 // ----------------------------------------------------------------------------
  50 // macros
  51 // ----------------------------------------------------------------------------
  52
  53 IMPLEMENT_DYNAMIC_CLASS(wxSpinCtrl, wxControl)
  54
  55 BEGIN_EVENT_TABLE(wxSpinCtrl, wxSpinButton)
  56     EVT_CHAR(wxSpinCtrl::OnChar)
  57
  58     EVT_SET_FOCUS(wxSpinCtrl::OnSetFocus)
  59
  60     EVT_SPIN(-1, wxSpinCtrl::OnSpinChange)
  61 END_EVENT_TABLE()
  62
  63 #define GetBuddyHwnd()      (HWND)(m_hwndBuddy)
  64
  65 // ----------------------------------------------------------------------------
  66 // constants
  67 // ----------------------------------------------------------------------------
  68
  69 // the margin between the up-down control and its buddy (can be arbitrary,
  70 // choose what you like - or may be decide during run-time depending on the
  71 // font size?)
  72 static const int MARGIN_BETWEEN = 1;
  73
  74 // ============================================================================
  75 // implementation
  76 // ============================================================================
  77
  78 wxArraySpins wxSpinCtrl::ms_allSpins;
  79
  80 // ----------------------------------------------------------------------------
  81 // wnd proc for the buddy text ctrl
  82 // ----------------------------------------------------------------------------
  83
  84 LRESULT APIENTRY _EXPORT wxBuddyTextWndProc(HWND hwnd,
  85                                             UINT message,
  86                                             WPARAM wParam,
  87                                             LPARAM lParam)
  88 {
  89     wxSpinCtrl *spin = (wxSpinCtrl *)::GetWindowLong(hwnd, GWL_USERDATA);
  90
  91     // forward some messages (the key and focus ones only so far) to
  92     // the spin ctrl
  93     switch ( message )
  94     {
  95         case WM_SETFOCUS:
  96             // if the focus comes from the spin control itself, don't set it
  97             // back to it -- we don't want to go into an infinite loop
  98             if ( wParam == spin->GetHWND() )
  99                 break;
 100             //else: fall through
 101
 102         case WM_KILLFOCUS:
 103         case WM_CHAR:
 104         case WM_DEADCHAR:
 105         case WM_KEYUP:
 106         case WM_KEYDOWN:
 107             spin->MSWWindowProc(message, wParam, lParam);
 108
 109             // The control may have been deleted at this point, so check.
 110             if (!(::IsWindow(hwnd) && ((wxSpinCtrl *)::GetWindowLong(hwnd, GWL_USERDATA)) == spin))
 111                 return 0;
 112             break;
 113
 114         case WM_GETDLGCODE:
 115             // we want to get WXK_RETURN in order to generate the event for it
 116             return DLGC_WANTCHARS;
 117     }
 118
 119     return ::CallWindowProc(CASTWNDPROC spin->GetBuddyWndProc(),
 120                             hwnd, message, wParam, lParam);
 121 }
 122
 123 /* static */
 124 wxSpinCtrl *wxSpinCtrl::GetSpinForTextCtrl(WXHWND hwndBuddy)
 125 {
 126     wxSpinCtrl *spin = (wxSpinCtrl *)::GetWindowLong((HWND)hwndBuddy,
 127                                                      GWL_USERDATA);
 128
 129     int i = ms_allSpins.Index(spin);
 130
 131     if ( i == wxNOT_FOUND )
 132         return NULL;
 133
 134     // sanity check
 135     wxASSERT_MSG( spin->m_hwndBuddy == hwndBuddy,
 136                   _T("wxSpinCtrl has incorrect buddy HWND!") );
 137
 138     return spin;
 139 }
 140
 141 // process a WM_COMMAND generated by the buddy text control
 142 bool wxSpinCtrl::ProcessTextCommand(WXWORD cmd, WXWORD WXUNUSED(id))
 143 {
 144     switch (cmd)
 145     {
 146     case EN_CHANGE:
 147         {
 148             wxCommandEvent event(wxEVT_COMMAND_TEXT_UPDATED, GetId());
 149             event.SetEventObject(this);
 150             wxString val = wxGetWindowText(m_hwndBuddy);
 151             event.SetString(val);
 152             event.SetInt(GetValue());
 153             return GetEventHandler()->ProcessEvent(event);
 154         }
 155     case EN_SETFOCUS:
 156     case EN_KILLFOCUS:
 157         {
 158             wxFocusEvent event(cmd == EN_KILLFOCUS ? wxEVT_KILL_FOCUS
 159                     : wxEVT_SET_FOCUS,
 160                     m_windowId);
 161             event.SetEventObject( this );
 162             return GetEventHandler()->ProcessEvent(event);
 163         }
 164      default:
 165         break;
 166     }
 167
 168     // not processed
 169     return FALSE;
 170 }
 171
 172 void wxSpinCtrl::OnChar(wxKeyEvent& event)
 173 {
 174     switch ( event.GetKeyCode() )
 175     {
 176         case WXK_RETURN:
 177             {
 178                 wxCommandEvent event(wxEVT_COMMAND_TEXT_ENTER, m_windowId);
 179                 InitCommandEvent(event);
 180                 wxString val = wxGetWindowText(m_hwndBuddy);
 181                 event.SetString(val);
 182                 event.SetInt(GetValue());
 183                 if ( GetEventHandler()->ProcessEvent(event) )
 184                     return;
 185                 break;
 186             }
 187
 188         case WXK_TAB:
 189             // always produce navigation event - even if we process TAB
 190             // ourselves the fact that we got here means that the user code
 191             // decided to skip processing of this TAB - probably to let it
 192             // do its default job.
 193             {
 194                 wxNavigationKeyEvent eventNav;
 195                 eventNav.SetDirection(!event.ShiftDown());
 196                 eventNav.SetWindowChange(event.ControlDown());
 197                 eventNav.SetEventObject(this);
 198
 199                 if ( GetParent()->GetEventHandler()->ProcessEvent(eventNav) )
 200                     return;
 201             }
 202             break;
 203     }
 204
 205     // no, we didn't process it
 206     event.Skip();
 207 }
 208
 209 void wxSpinCtrl::OnSetFocus(wxFocusEvent& event)
 210 {
 211     // when we get focus, give it to our buddy window as it needs it more than
 212     // we do
 213     ::SetFocus((HWND)m_hwndBuddy);
 214
 215     event.Skip();
 216 }
 217
 218 // ----------------------------------------------------------------------------
 219 // construction
 220 // ----------------------------------------------------------------------------
 221
 222 bool wxSpinCtrl::Create(wxWindow *parent,
 223                         wxWindowID id,
 224                         const wxString& value,
 225                         const wxPoint& pos,
 226                         const wxSize& size,
 227                         long style,
 228                         int min, int max, int initial,
 229                         const wxString& name)
 230 {
 231     // before using DoGetBestSize(), have to set style to let the base class
 232     // know whether this is a horizontal or vertical control (we're always
 233     // vertical)
 234     style |= wxSP_VERTICAL;
 235
 236     if ( (style & wxBORDER_MASK) == wxBORDER_DEFAULT )
 237         style |= wxBORDER_SUNKEN;
 238
 239     SetWindowStyle(style);
 240
 241     // calculate the sizes: the size given is the toal size for both controls
 242     // and we need to fit them both in the given width (height is the same)
 243     wxSize sizeText(size), sizeBtn(size);
 244     sizeBtn.x = wxSpinButton::DoGetBestSize().x;
 245     if ( sizeText.x <= 0 )
 246     {
 247         // DEFAULT_ITEM_WIDTH is the default width for the text control
 248         sizeText.x = DEFAULT_ITEM_WIDTH + MARGIN_BETWEEN + sizeBtn.x;
 249     }
 250
 251     sizeText.x -= sizeBtn.x + MARGIN_BETWEEN;
 252     if ( sizeText.x <= 0 )
 253     {
 254         wxLogDebug(_T("not enough space for wxSpinCtrl!"));
 255     }
 256
 257     wxPoint posBtn(pos);
 258     posBtn.x += sizeText.x + MARGIN_BETWEEN;
 259
 260     // we must create the text control before the spin button for the purpose
 261     // of the dialog navigation: if there is a static text just before the spin
 262     // control, activating it by Alt-letter should give focus to the text
 263     // control, not the spin and the dialog navigation code will give focus to
 264     // the next control (at Windows level), not the one after it
 265
 266     // create the text window
 267
 268     bool want3D;
 269     WXDWORD exStyle = Determine3DEffects(WS_EX_CLIENTEDGE, &want3D);
 270     int msStyle = WS_CHILD;
 271
 272     // Even with extended styles, need to combine with WS_BORDER for them to
 273     // look right.
 274     if ( want3D || wxStyleHasBorder(style) )
 275         msStyle |= WS_BORDER;
 276
 277     if ( style & wxCLIP_SIBLINGS )
 278         msStyle |= WS_CLIPSIBLINGS;
 279
 280     m_hwndBuddy = (WXHWND)::CreateWindowEx
 281                     (
 282                      exStyle,                // sunken border
 283                      _T("EDIT"),             // window class
 284                      NULL,                   // no window title
 285                      msStyle,                // style (will be shown later)
 286                      pos.x, pos.y,           // position
 287                      0, 0,                   // size (will be set later)
 288                      GetHwndOf(parent),      // parent
 289                      (HMENU)-1,              // control id
 290                      wxGetInstance(),        // app instance
 291                      NULL                    // unused client data
 292                     );
 293
 294     if ( !m_hwndBuddy )
 295     {
 296         wxLogLastError(wxT("CreateWindow(buddy text window)"));
 297
 298         return FALSE;
 299     }
 300
 301
 302     // create the spin button
 303     if ( !wxSpinButton::Create(parent, id, posBtn, sizeBtn, style, name) )
 304     {
 305         return FALSE;
 306     }
 307
 308     SetRange(min, max);
 309     SetValue(initial);
 310
 311     // subclass the text ctrl to be able to intercept some events
 312     m_wndProcBuddy = (WXFARPROC)::GetWindowLong(GetBuddyHwnd(), GWL_WNDPROC);
 313     ::SetWindowLong(GetBuddyHwnd(), GWL_USERDATA, (LONG)this);
 314     ::SetWindowLong(GetBuddyHwnd(), GWL_WNDPROC, (LONG)wxBuddyTextWndProc);
 315
 316     // should have the same font as the other controls
 317     SetFont(GetParent()->GetFont());
 318
 319     // set the size of the text window - can do it only now, because we
 320     // couldn't call DoGetBestSize() before as font wasn't set
 321     if ( sizeText.y <= 0 )
 322     {
 323         int cx, cy;
 324         wxGetCharSize(GetHWND(), &cx, &cy, &GetFont());
 325
 326         sizeText.y = EDIT_HEIGHT_FROM_CHAR_HEIGHT(cy);
 327     }
 328
 329     DoMoveWindow(pos.x, pos.y,
 330                  sizeText.x + sizeBtn.x + MARGIN_BETWEEN, sizeText.y);
 331
 332     (void)::ShowWindow(GetBuddyHwnd(), SW_SHOW);
 333
 334     // associate the text window with the spin button
 335     (void)::SendMessage(GetHwnd(), UDM_SETBUDDY, (WPARAM)m_hwndBuddy, 0);
 336
 337     if ( !value.IsEmpty() )
 338     {
 339         SetValue(value);
 340     }
 341
 342     // do it after finishing with m_hwndBuddy creation to avoid generating
 343     // initial wxEVT_COMMAND_TEXT_UPDATED message
 344     ms_allSpins.Add(this);
 345
 346     return TRUE;
 347 }
 348
 349 wxSpinCtrl::~wxSpinCtrl()
 350 {
 351     ms_allSpins.Remove(this);
 352
 353     // This removes spurious memory leak reporting
 354     if (ms_allSpins.GetCount() == 0)
 355         ms_allSpins.Clear();
 356
 357     // destroy the buddy window because this pointer which wxBuddyTextWndProc
 358     // uses will not soon be valid any more
 359     ::DestroyWindow(GetBuddyHwnd());
 360 }
 361
 362 // ----------------------------------------------------------------------------
 363 // wxTextCtrl-like methods
 364 // ----------------------------------------------------------------------------
 365
 366 void wxSpinCtrl::SetValue(const wxString& text)
 367 {
 368     if ( !::SetWindowText(GetBuddyHwnd(), text.c_str()) )
 369     {
 370         wxLogLastError(wxT("SetWindowText(buddy)"));
 371     }
 372 }
 373
 374 int wxSpinCtrl::GetValue() const
 375 {
 376     wxString val = wxGetWindowText(m_hwndBuddy);
 377
 378     long n;
 379     if ( (wxSscanf(val, wxT("%lu"), &n) != 1) )
 380         n = INT_MIN;
 381
 382     return n;
 383 }
 384
 385 void wxSpinCtrl::SetSelection(long from, long to)
 386 {
 387     // if from and to are both -1, it means (in wxWindows) that all text should
 388     // be selected - translate into Windows convention
 389     if ( (from == -1) && (to == -1) )
 390     {
 391         from = 0;
 392     }
 393
 394     ::SendMessage((HWND)m_hwndBuddy, EM_SETSEL, (WPARAM)from, (LPARAM)to);
 395 }
 396
 397 // ----------------------------------------------------------------------------
 398 // forward some methods to subcontrols
 399 // ----------------------------------------------------------------------------
 400
 401 bool wxSpinCtrl::SetFont(const wxFont& font)
 402 {
 403     if ( !wxWindowBase::SetFont(font) )
 404     {
 405         // nothing to do
 406         return FALSE;
 407     }
 408
 409     WXHANDLE hFont = GetFont().GetResourceHandle();
 410     (void)::SendMessage(GetBuddyHwnd(), WM_SETFONT, (WPARAM)hFont, TRUE);
 411
 412     return TRUE;
 413 }
 414
 415 bool wxSpinCtrl::Show(bool show)
 416 {
 417     if ( !wxControl::Show(show) )
 418     {
 419         return FALSE;
 420     }
 421
 422     ::ShowWindow(GetBuddyHwnd(), show ? SW_SHOW : SW_HIDE);
 423
 424     return TRUE;
 425 }
 426
 427 bool wxSpinCtrl::Enable(bool enable)
 428 {
 429     if ( !wxControl::Enable(enable) )
 430     {
 431         return FALSE;
 432     }
 433
 434     ::EnableWindow(GetBuddyHwnd(), enable);
 435
 436     return TRUE;
 437 }
 438
 439 void wxSpinCtrl::SetFocus()
 440 {
 441     ::SetFocus(GetBuddyHwnd());
 442 }
 443
 444 // ----------------------------------------------------------------------------
 445 // event processing
 446 // ----------------------------------------------------------------------------
 447
 448 void wxSpinCtrl::OnSpinChange(wxSpinEvent& eventSpin)
 449 {
 450     wxCommandEvent event(wxEVT_COMMAND_SPINCTRL_UPDATED, GetId());
 451     event.SetEventObject(this);
 452     event.SetInt(eventSpin.GetPosition());
 453
 454     (void)GetEventHandler()->ProcessEvent(event);
 455
 456     if ( eventSpin.GetSkipped() )
 457     {
 458         event.Skip();
 459     }
 460 }
 461
 462 // ----------------------------------------------------------------------------
 463 // size calculations
 464 // ----------------------------------------------------------------------------
 465
 466 wxSize wxSpinCtrl::DoGetBestSize() const
 467 {
 468     wxSize sizeBtn = wxSpinButton::DoGetBestSize();
 469     sizeBtn.x += DEFAULT_ITEM_WIDTH + MARGIN_BETWEEN;
 470
 471     int y;
 472     wxGetCharSize(GetHWND(), NULL, &y, &GetFont());
 473     y = EDIT_HEIGHT_FROM_CHAR_HEIGHT(y);
 474
 475     if ( sizeBtn.y < y )
 476     {
 477         // make the text tall enough
 478         sizeBtn.y = y;
 479     }
 480
 481     return sizeBtn;
 482 }
 483
 484 void wxSpinCtrl::DoMoveWindow(int x, int y, int width, int height)
 485 {
 486     int widthBtn = wxSpinButton::DoGetBestSize().x;
 487     int widthText = width - widthBtn - MARGIN_BETWEEN;
 488     if ( widthText <= 0 )
 489     {
 490         wxLogDebug(_T("not enough space for wxSpinCtrl!"));
 491     }
 492
 493     if ( !::MoveWindow(GetBuddyHwnd(), x, y, widthText, height, TRUE) )
 494     {
 495         wxLogLastError(wxT("MoveWindow(buddy)"));
 496     }
 497
 498     x += widthText + MARGIN_BETWEEN;
 499     if ( !::MoveWindow(GetHwnd(), x, y, widthBtn, height, TRUE) )
 500     {
 501         wxLogLastError(wxT("MoveWindow"));
 502     }
 503 }
 504
 505 // get total size of the control
 506 void wxSpinCtrl::DoGetSize(int *x, int *y) const
 507 {
 508     RECT spinrect, textrect, ctrlrect;
 509     GetWindowRect(GetHwnd(), &spinrect);
 510     GetWindowRect(GetBuddyHwnd(), &textrect);
 511     UnionRect(&ctrlrect,&textrect, &spinrect);
 512
 513     if ( x )
 514         *x = ctrlrect.right - ctrlrect.left;
 515     if ( y )
 516         *y = ctrlrect.bottom - ctrlrect.top;
 517 }
 518
 519 void wxSpinCtrl::DoGetPosition(int *x, int *y) const
 520 {
 521     // hack: pretend that our HWND is the text control just for a moment
 522     WXHWND hWnd = GetHWND();
 523     wxConstCast(this, wxSpinCtrl)->m_hWnd = m_hwndBuddy;
 524
 525     wxSpinButton::DoGetPosition(x, y);
 526
 527     wxConstCast(this, wxSpinCtrl)->m_hWnd = hWnd;
 528 }
 529
 530 #endif // __WIN95__
 531
 532 #endif
 533        // wxUSE_SPINCTRL
 534