src/msw/combo.cpp

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        src/msw/combo.cpp
   3 // Purpose:     wxMSW wxComboCtrl
   4 // Author:      Jaakko Salli
   5 // Modified by:
   6 // Created:     Apr-30-2006
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) 2005 Jaakko Salli
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 // ============================================================================
  13 // declarations
  14 // ============================================================================
  15
  16 // ----------------------------------------------------------------------------
  17 // headers
  18 // ----------------------------------------------------------------------------
  19
  20 #include "wx/wxprec.h"
  21
  22 #ifdef __BORLANDC__
  23     #pragma hdrstop
  24 #endif
  25
  26 #if wxUSE_COMBOCTRL
  27
  28 #ifndef WX_PRECOMP
  29     #include "wx/log.h"
  30     #include "wx/combobox.h"
  31     #include "wx/dcclient.h"
  32     #include "wx/settings.h"
  33     #include "wx/dialog.h"
  34 #endif
  35
  36 #include "wx/dcbuffer.h"
  37
  38 #include "wx/combo.h"
  39
  40
  41 #include "wx/msw/uxtheme.h"
  42
  43 // Change to #if 1 to include tmschema.h for easier testing of theme
  44 // parameters.
  45 #if 0
  46     #include <tmschema.h>
  47 #else
  48     //----------------------------------
  49     #define EP_EDITTEXT         1
  50     #define ETS_NORMAL          1
  51     #define ETS_HOT             2
  52     #define ETS_SELECTED        3
  53     #define ETS_DISABLED        4
  54     #define ETS_FOCUSED         5
  55     #define ETS_READONLY        6
  56     #define ETS_ASSIST          7
  57     #define TMT_FILLCOLOR       3802
  58     #define TMT_TEXTCOLOR       3803
  59     #define TMT_BORDERCOLOR     3801
  60     #define TMT_EDGEFILLCOLOR   3808
  61     //----------------------------------
  62 #endif
  63
  64
  65 #define NATIVE_TEXT_INDENT_XP       4
  66 #define NATIVE_TEXT_INDENT_CLASSIC  2
  67
  68 #define TEXTCTRLXADJUST_XP          1
  69 #define TEXTCTRLYADJUST_XP          3
  70 #define TEXTCTRLXADJUST_CLASSIC     1
  71 #define TEXTCTRLYADJUST_CLASSIC     2
  72
  73
  74 // ============================================================================
  75 // implementation
  76 // ============================================================================
  77
  78
  79 BEGIN_EVENT_TABLE(wxComboCtrl, wxComboCtrlBase)
  80     EVT_PAINT(wxComboCtrl::OnPaintEvent)
  81     EVT_MOUSE_EVENTS(wxComboCtrl::OnMouseEvent)
  82 END_EVENT_TABLE()
  83
  84
  85 IMPLEMENT_DYNAMIC_CLASS(wxComboCtrl, wxComboCtrlBase)
  86
  87 void wxComboCtrl::Init()
  88 {
  89 }
  90
  91 bool wxComboCtrl::Create(wxWindow *parent,
  92                             wxWindowID id,
  93                             const wxString& value,
  94                             const wxPoint& pos,
  95                             const wxSize& size,
  96                             long style,
  97                             const wxValidator& validator,
  98                             const wxString& name)
  99 {
 100
 101     // Set border
 102     long border = style & wxBORDER_MASK;
 103
 104     wxUxThemeEngine* theme = wxUxThemeEngine::GetIfActive();
 105
 106     if ( !border )
 107     {
 108         // For XP, have 1-width custom border, for older version use sunken
 109         if ( theme )
 110         {
 111             border = wxBORDER_NONE;
 112             m_widthCustomBorder = 1;
 113         }
 114         else
 115             border = wxBORDER_SUNKEN;
 116
 117         style = (style & ~(wxBORDER_MASK)) | border;
 118     }
 119
 120     // create main window
 121     if ( !wxComboCtrlBase::Create(parent,
 122                            id,
 123                            value,
 124                            pos,
 125                            size,
 126                            style | wxFULL_REPAINT_ON_RESIZE,
 127                            wxDefaultValidator,
 128                            name) )
 129         return false;
 130
 131     if ( style & wxCC_STD_BUTTON )
 132         m_iFlags |= wxCC_POPUP_ON_MOUSE_UP;
 133
 134     // Create textctrl, if necessary
 135     CreateTextCtrl( wxNO_BORDER, validator );
 136
 137     // Add keyboard input handlers for main control and textctrl
 138     InstallInputHandlers( true );
 139
 140     // Prepare background for double-buffering
 141     SetBackgroundStyle( wxBG_STYLE_CUSTOM );
 142
 143     // SetBestSize should be called last
 144     SetBestSize(size);
 145
 146     return true;
 147 }
 148
 149 wxComboCtrl::~wxComboCtrl()
 150 {
 151 }
 152
 153 void wxComboCtrl::OnThemeChange()
 154 {
 155     wxUxThemeEngine* theme = wxUxThemeEngine::GetIfActive();
 156     if ( theme )
 157     {
 158         wxUxThemeHandle hTheme(this, L"COMBOBOX");
 159
 160         COLORREF col;
 161         theme->GetThemeColor(hTheme,EP_EDITTEXT,ETS_NORMAL,TMT_FILLCOLOR,&col);
 162         SetBackgroundColour(wxRGBToColour(col));
 163         theme->GetThemeColor(hTheme,EP_EDITTEXT,ETS_NORMAL,TMT_TEXTCOLOR,&col);
 164         SetForegroundColour(wxRGBToColour(col));
 165     }
 166     else
 167     {
 168         SetBackgroundColour(wxSystemSettings::GetColour(wxSYS_COLOUR_WINDOW));
 169         SetForegroundColour(wxSystemSettings::GetColour(wxSYS_COLOUR_WINDOWTEXT));
 170     }
 171 }
 172
 173 void wxComboCtrl::OnResize()
 174 {
 175     //
 176     // Recalculates button and textctrl areas
 177
 178     int textCtrlXAdjust;
 179     int textCtrlYAdjust;
 180
 181     if ( wxUxThemeEngine::GetIfActive() )
 182     {
 183         textCtrlXAdjust = TEXTCTRLXADJUST_XP;
 184         textCtrlYAdjust = TEXTCTRLYADJUST_XP;
 185     }
 186     else
 187     {
 188         textCtrlXAdjust = TEXTCTRLXADJUST_CLASSIC;
 189         textCtrlYAdjust = TEXTCTRLYADJUST_CLASSIC;
 190     }
 191
 192     // Technically Classic Windows style combo has more narrow button,
 193     // but the native renderer doesn't paint it well like that.
 194     int btnWidth = 17;
 195     CalculateAreas(btnWidth);
 196
 197     // Position textctrl using standard routine
 198     PositionTextCtrl(textCtrlXAdjust,textCtrlYAdjust);
 199 }
 200
 201 // Draws non-XP GUI dotted line around the focus area
 202 static void wxMSWDrawFocusRect( wxDC& dc, const wxRect& rect )
 203 {
 204 #if !defined(__WXWINCE__)
 205     /*
 206     RECT mswRect;
 207     mswRect.left = rect.x;
 208     mswRect.top = rect.y;
 209     mswRect.right = rect.x + rect.width;
 210     mswRect.bottom = rect.y + rect.height;
 211     HDC hdc = (HDC) dc.GetHDC();
 212     SetMapMode(hdc,MM_TEXT); // Just in case...
 213     DrawFocusRect(hdc,&mswRect);
 214     */
 215     // FIXME: Use DrawFocusRect code above (currently it draws solid line
 216     //   for caption focus but works ok for other stuff).
 217     //   Also, this code below may not work in future wx versions, since
 218     //   it employs wxCAP_BUTT hack to have line of width 1.
 219     dc.SetLogicalFunction(wxINVERT);
 220
 221     wxPen pen(*wxBLACK,1,wxDOT);
 222     pen.SetCap(wxCAP_BUTT);
 223     dc.SetPen(pen);
 224     dc.SetBrush(*wxTRANSPARENT_BRUSH);
 225
 226     dc.DrawRectangle(rect);
 227
 228     dc.SetLogicalFunction(wxCOPY);
 229 #else
 230     dc.SetLogicalFunction(wxINVERT);
 231
 232     dc.SetPen(wxPen(*wxBLACK,1,wxDOT));
 233     dc.SetBrush(*wxTRANSPARENT_BRUSH);
 234
 235     dc.DrawRectangle(rect);
 236
 237     dc.SetLogicalFunction(wxCOPY);
 238 #endif
 239 }
 240
 241 // draw focus background on area in a way typical on platform
 242 void wxComboCtrl::DrawFocusBackground( wxDC& dc, const wxRect& rect, int flags ) const
 243 {
 244     wxUxThemeEngine* theme = (wxUxThemeEngine*) NULL;
 245
 246     // Constructor only calls GetHWND() const, so it should be safe
 247     // to cast "this" to const.
 248     wxUxThemeHandle hTheme(this, L"COMBOBOX");
 249     //COLORREF cref;
 250
 251     wxSize sz = GetClientSize();
 252     bool isEnabled;
 253     bool isFocused; // also selected
 254
 255     // For smaller size control (and for disabled background) use less spacing
 256     int focusSpacingX;
 257     int focusSpacingY;
 258
 259     if ( !(flags & wxCONTROL_ISSUBMENU) )
 260     {
 261         // Drawing control
 262         isEnabled = IsEnabled();
 263         isFocused = ShouldDrawFocus();
 264
 265         // Windows-style: for smaller size control (and for disabled background) use less spacing
 266         if ( hTheme )
 267         {
 268             // WinXP  Theme
 269             focusSpacingX = isEnabled ? 2 : 1;
 270             focusSpacingY = sz.y > (GetCharHeight()+2) && isEnabled ? 2 : 1;
 271         }
 272         else
 273         {
 274             // Classic Theme
 275             if ( isEnabled )
 276             {
 277                 focusSpacingX = 1;
 278                 focusSpacingY = 1;
 279             }
 280             else
 281             {
 282                 focusSpacingX = 0;
 283                 focusSpacingY = 0;
 284             }
 285         }
 286     }
 287     else
 288     {
 289         // Drawing a list item
 290         isEnabled = true; // they are never disabled
 291         isFocused = flags & wxCONTROL_SELECTED ? true : false;
 292
 293         focusSpacingX = 0;
 294         focusSpacingY = 0;
 295     }
 296
 297     // Set the background sub-rectangle for selection, disabled etc
 298     wxRect selRect(rect);
 299     selRect.y += focusSpacingY;
 300     selRect.height -= (focusSpacingY*2);
 301     selRect.x += m_widthCustomPaint + focusSpacingX;
 302     selRect.width -= m_widthCustomPaint + (focusSpacingX*2);
 303
 304     if ( hTheme )
 305         theme = wxUxThemeEngine::GetIfActive();
 306
 307     wxColour bgCol;
 308     bool drawDottedEdge = false;
 309
 310     if ( isEnabled )
 311     {
 312         // If popup is hidden and this control is focused,
 313         // then draw the focus-indicator (selbgcolor background etc.).
 314         if ( isFocused )
 315         {
 316         #if 0
 317             // TODO: Proper theme color getting (JMS: I don't know which parts/colors to use,
 318             //       those below don't work)
 319             if ( hTheme )
 320             {
 321                 theme->GetThemeColor(hTheme,EP_EDITTEXT,ETS_SELECTED,TMT_TEXTCOLOR,&cref);
 322                 dc.SetTextForeground( wxRGBToColour(cref) );
 323                 theme->GetThemeColor(hTheme,EP_EDITTEXT,ETS_SELECTED,TMT_FILLCOLOR,&cref);
 324                 bgCol = wxRGBToColour(cref);
 325             }
 326             else
 327         #endif
 328             {
 329                 dc.SetTextForeground( wxSystemSettings::GetColour(wxSYS_COLOUR_HIGHLIGHTTEXT) );
 330                 bgCol = wxSystemSettings::GetColour(wxSYS_COLOUR_HIGHLIGHT);
 331                 if ( m_windowStyle & wxCB_READONLY )
 332                     drawDottedEdge = true;
 333             }
 334         }
 335         else
 336         {
 337             /*if ( hTheme )
 338             {
 339                 theme->GetThemeColor(hTheme,EP_EDITTEXT,ETS_NORMAL,TMT_TEXTCOLOR,&cref);
 340                 dc.SetTextForeground( wxRGBToColour(cref) );
 341                 theme->GetThemeColor(hTheme,EP_EDITTEXT,ETS_NORMAL,TMT_FILLCOLOR,&cref);
 342                 bgCol = wxRGBToColour(cref);
 343             }
 344             else
 345             {*/
 346                 dc.SetTextForeground( wxSystemSettings::GetColour(wxSYS_COLOUR_WINDOWTEXT) );
 347                 bgCol = GetBackgroundColour();
 348             //}
 349         }
 350     }
 351     else
 352     {
 353         /*if ( hTheme )
 354         {
 355             theme->GetThemeColor(hTheme,EP_EDITTEXT,ETS_DISABLED,TMT_TEXTCOLOR,&cref);
 356             dc.SetTextForeground( wxRGBToColour(cref) );
 357             theme->GetThemeColor(hTheme,EP_EDITTEXT,ETS_DISABLED,TMT_EDGEFILLCOLOR,&cref);
 358             bgCol = wxRGBToColour(cref);
 359         }
 360         else
 361         {*/
 362             dc.SetTextForeground( wxSystemSettings::GetColour(wxSYS_COLOUR_GRAYTEXT) );
 363             bgCol = wxSystemSettings::GetColour(wxSYS_COLOUR_BTNFACE);
 364         //}
 365     }
 366
 367     dc.SetBrush(bgCol);
 368     dc.SetPen(bgCol);
 369     dc.DrawRectangle(selRect);
 370     if ( drawDottedEdge )
 371         wxMSWDrawFocusRect(dc,selRect);
 372
 373 }
 374
 375 void wxComboCtrl::OnPaintEvent( wxPaintEvent& WXUNUSED(event) )
 376 {
 377     // TODO: Convert drawing in this function to Windows API Code
 378
 379     wxSize sz = GetClientSize();
 380     wxBufferedPaintDC dc(this,GetBufferBitmap(sz));
 381
 382     const wxRect& rectb = m_btnArea;
 383     wxRect rect = m_tcArea;
 384     bool isEnabled = IsEnabled();
 385     wxColour bgCol = GetBackgroundColour();
 386     wxColour fgCol;
 387
 388     wxUxThemeEngine* theme = NULL;
 389     wxUxThemeHandle hTheme(this, L"COMBOBOX");
 390     int etsState;
 391
 392     // area around both controls
 393     wxRect rect2(0,0,sz.x,sz.y);
 394     if ( m_iFlags & wxCC_IFLAG_BUTTON_OUTSIDE )
 395     {
 396         rect2 = m_tcArea;
 397         rect2.Inflate(1);
 398     }
 399
 400     // Use theme to draw border on XP
 401     if ( hTheme )
 402     {
 403         theme = wxUxThemeEngine::GetIfActive();
 404         COLORREF cref;
 405
 406         // Select correct border colour
 407         if ( !isEnabled )
 408             etsState = ETS_DISABLED;
 409         else
 410             etsState = ETS_NORMAL;
 411
 412         if ( m_widthCustomBorder )
 413         {
 414             theme->GetThemeColor(hTheme,EP_EDITTEXT,etsState,TMT_BORDERCOLOR,&cref);
 415
 416             // Set border colour
 417             dc.SetPen( wxRGBToColour(cref) );
 418
 419             dc.SetBrush( *wxTRANSPARENT_BRUSH );
 420             dc.DrawRectangle(rect2);
 421         }
 422
 423         theme->GetThemeColor(hTheme,EP_EDITTEXT,etsState,TMT_TEXTCOLOR,&cref);
 424         fgCol = wxRGBToColour(cref);
 425     }
 426     else
 427     {
 428         // draw regular background
 429         fgCol = GetForegroundColour();
 430     }
 431
 432     rect2.Deflate(m_widthCustomBorder);
 433
 434     dc.SetBrush(bgCol);
 435     dc.SetPen(bgCol);
 436
 437     // clear main background
 438     dc.DrawRectangle(rect);
 439
 440     // Button background with theme?
 441     bool drawButBg = true;
 442     if ( hTheme && m_blankButtonBg )
 443     {
 444         RECT r;
 445         wxCopyRectToRECT(rectb, r);
 446
 447         // Draw parent background if needed (since button looks like its out of
 448         // the combo, this is preferred).
 449         theme->DrawThemeParentBackground(GetHwndOf(this),
 450                                          GetHdcOf(dc),
 451                                          &r);
 452
 453         drawButBg = false;
 454     }
 455
 456     // Standard button rendering
 457     DrawButton(dc,rectb,drawButBg);
 458
 459     // paint required portion on the control
 460     if ( (!m_text || m_widthCustomPaint) )
 461     {
 462         wxASSERT( m_widthCustomPaint >= 0 );
 463
 464         // this is intentionally here to allow drawed rectangle's
 465         // right edge to be hidden
 466         if ( m_text )
 467             rect.width = m_widthCustomPaint;
 468
 469         dc.SetFont( GetFont() );
 470
 471         dc.SetClippingRegion(rect);
 472         if ( m_popupInterface )
 473             m_popupInterface->PaintComboControl(dc,rect);
 474         else
 475             wxComboPopup::DefaultPaintComboControl(this,dc,rect);
 476     }
 477 }
 478
 479 void wxComboCtrl::OnMouseEvent( wxMouseEvent& event )
 480 {
 481     bool isOnButtonArea = m_btnArea.Inside(event.m_x,event.m_y);
 482     int handlerFlags = isOnButtonArea ? wxCC_MF_ON_BUTTON : 0;
 483
 484     // Preprocessing fabricates double-clicks and prevents
 485     // (it may also do other common things in future)
 486     if ( PreprocessMouseEvent(event,isOnButtonArea) )
 487         return;
 488
 489     if ( (m_windowStyle & (wxCC_SPECIAL_DCLICK|wxCB_READONLY)) == wxCB_READONLY )
 490     {
 491         // if no textctrl and no special double-click, then the entire control acts
 492         // as a button
 493         handlerFlags |= wxCC_MF_ON_BUTTON;
 494         if ( HandleButtonMouseEvent(event,handlerFlags) )
 495             return;
 496     }
 497     else
 498     {
 499         if ( isOnButtonArea || HasCapture() )
 500         {
 501             if ( HandleButtonMouseEvent(event,handlerFlags) )
 502                 return;
 503         }
 504         else if ( m_btnState )
 505         {
 506             // otherwise need to clear the hover status
 507             m_btnState = 0;
 508             RefreshRect(m_btnArea);
 509         }
 510     }
 511
 512     //
 513     // This will handle left_down and left_dclick events outside button in a Windows-like manner.
 514     // See header file for further information on this method.
 515     HandleNormalMouseEvent(event);
 516
 517 }
 518
 519 wxCoord wxComboCtrl::GetNativeTextIndent() const
 520 {
 521     if ( wxUxThemeEngine::GetIfActive() )
 522         return NATIVE_TEXT_INDENT_XP;
 523     return NATIVE_TEXT_INDENT_CLASSIC;
 524 }
 525
 526
 527 #endif // wxUSE_COMBOCTRL