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