1 /////////////////////////////////////////////////////////////////////////////
2 // Name: src/msw/combo.cpp
3 // Purpose: wxMSW wxComboCtrl
4 // Author: Jaakko Salli
6 // Created: Apr-30-2006
8 // Copyright: (c) 2005 Jaakko Salli
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
12 // ============================================================================
14 // ============================================================================
16 // ----------------------------------------------------------------------------
18 // ----------------------------------------------------------------------------
20 #include "wx/wxprec.h"
30 #include "wx/combobox.h"
31 #include "wx/dcclient.h"
32 #include "wx/settings.h"
33 #include "wx/dialog.h"
34 #include "wx/stopwatch.h"
37 #include "wx/dcbuffer.h"
40 #include "wx/msw/registry.h"
42 #include "wx/msw/uxtheme.h"
45 // Change to #if 1 to include tmschema.h for easier testing of theme
51 //----------------------------------
55 #define ETS_SELECTED 3
56 #define ETS_DISABLED 4
58 #define ETS_READONLY 6
60 #define TMT_FILLCOLOR 3802
61 #define TMT_TEXTCOLOR 3803
62 #define TMT_BORDERCOLOR 3801
63 #define TMT_EDGEFILLCOLOR 3808
64 #define TMT_BGTYPE 4001
66 #define BT_IMAGEFILE 0
67 #define BT_BORDERFILL 1
69 #define CP_DROPDOWNBUTTON 1
70 #define CP_BACKGROUND 2 // This and above are Vista and later only
71 #define CP_TRANSPARENTBACKGROUND 3
74 #define CP_DROPDOWNBUTTONRIGHT 6
75 #define CP_DROPDOWNBUTTONLEFT 7
76 #define CP_CUEBANNER 8
80 #define CBXS_PRESSED 3
81 #define CBXS_DISABLED 4
83 #define CBXSR_NORMAL 1
85 #define CBXSR_PRESSED 3
86 #define CBXSR_DISABLED 4
88 #define CBXSL_NORMAL 1
90 #define CBXSL_PRESSED 3
91 #define CBXSL_DISABLED 4
93 #define CBTBS_NORMAL 1
95 #define CBTBS_DISABLED 3
96 #define CBTBS_FOCUSED 4
100 #define CBB_FOCUSED 3
101 #define CBB_DISABLED 4
103 #define CBRO_NORMAL 1
105 #define CBRO_PRESSED 3
106 #define CBRO_DISABLED 4
108 #define CBCB_NORMAL 1
110 #define CBCB_PRESSED 3
111 #define CBCB_DISABLED 4
116 #define NATIVE_TEXT_INDENT_XP 4
117 #define NATIVE_TEXT_INDENT_CLASSIC 2
119 #define TEXTCTRLXADJUST_XP 1
120 #define TEXTCTRLYADJUST_XP 3
121 #define TEXTCTRLXADJUST_CLASSIC 1
122 #define TEXTCTRLYADJUST_CLASSIC 3
124 #define COMBOBOX_ANIMATION_RESOLUTION 10
126 #define COMBOBOX_ANIMATION_DURATION 200 // In milliseconds
128 #define wxMSW_DESKTOP_USERPREFERENCESMASK_COMBOBOXANIM (1<<2)
131 // ============================================================================
133 // ============================================================================
136 BEGIN_EVENT_TABLE(wxComboCtrl
, wxComboCtrlBase
)
137 EVT_PAINT(wxComboCtrl::OnPaintEvent
)
138 EVT_MOUSE_EVENTS(wxComboCtrl::OnMouseEvent
)
139 #if wxUSE_COMBOCTRL_POPUP_ANIMATION
140 EVT_TIMER(wxID_ANY
, wxComboCtrl::OnTimerEvent
)
145 IMPLEMENT_DYNAMIC_CLASS(wxComboCtrl
, wxComboCtrlBase
)
147 void wxComboCtrl::Init()
151 bool wxComboCtrl::Create(wxWindow
*parent
,
153 const wxString
& value
,
157 const wxValidator
& validator
,
158 const wxString
& name
)
162 long border
= style
& wxBORDER_MASK
;
165 wxUxThemeEngine
* theme
= wxUxThemeEngine::GetIfActive();
173 // For XP, have 1-width custom border, for older version use sunken
174 border
= wxBORDER_NONE
;
175 m_widthCustomBorder
= 1;
179 border
= wxBORDER_SUNKEN
;
181 style
= (style
& ~(wxBORDER_MASK
)) | border
;
184 // create main window
185 if ( !wxComboCtrlBase::Create(parent
,
190 style
| wxFULL_REPAINT_ON_RESIZE
,
198 if ( ::wxGetWinVersion() >= wxWinVersion_Vista
)
199 m_iFlags
|= wxCC_BUTTON_STAYS_DOWN
|wxCC_BUTTON_COVERS_BORDER
;
203 if ( style
& wxCC_STD_BUTTON
)
204 m_iFlags
|= wxCC_POPUP_ON_MOUSE_UP
;
206 // Create textctrl, if necessary
207 CreateTextCtrl( wxNO_BORDER
, validator
);
209 // Add keyboard input handlers for main control and textctrl
210 InstallInputHandlers();
212 // Prepare background for double-buffering
213 SetBackgroundStyle( wxBG_STYLE_CUSTOM
);
215 // SetInitialSize should be called last
216 SetInitialSize(size
);
221 wxComboCtrl::~wxComboCtrl()
225 void wxComboCtrl::OnThemeChange()
227 // there doesn't seem to be any way to get the text colour using themes
228 // API: TMT_TEXTCOLOR doesn't work neither for EDIT nor COMBOBOX
229 SetForegroundColour(wxSystemSettings::GetColour(wxSYS_COLOUR_WINDOWTEXT
));
232 wxUxThemeEngine
* const theme
= wxUxThemeEngine::GetIfActive();
235 // NB: use EDIT, not COMBOBOX (the latter works in XP but not Vista)
236 wxUxThemeHandle
hTheme(this, L
"EDIT");
238 HRESULT hr
= theme
->GetThemeColor
248 SetBackgroundColour(wxRGBToColour(col
));
250 // skip the call below
254 wxLogApiError(_T("GetThemeColor(EDIT, ETS_NORMAL, TMT_FILLCOLOR)"), hr
);
258 SetBackgroundColour(wxSystemSettings::GetColour(wxSYS_COLOUR_WINDOW
));
261 void wxComboCtrl::OnResize()
264 // Recalculates button and textctrl areas
270 if ( wxUxThemeEngine::GetIfActive() )
272 textCtrlXAdjust
= TEXTCTRLXADJUST_XP
;
273 textCtrlYAdjust
= TEXTCTRLYADJUST_XP
;
278 textCtrlXAdjust
= TEXTCTRLXADJUST_CLASSIC
;
279 textCtrlYAdjust
= TEXTCTRLYADJUST_CLASSIC
;
282 // Technically Classic Windows style combo has more narrow button,
283 // but the native renderer doesn't paint it well like that.
285 CalculateAreas(btnWidth
);
287 // Position textctrl using standard routine
288 PositionTextCtrl(textCtrlXAdjust
,textCtrlYAdjust
);
291 // Draws non-XP GUI dotted line around the focus area
292 static void wxMSWDrawFocusRect( wxDC
& dc
, const wxRect
& rect
)
294 #if !defined(__WXWINCE__)
297 mswRect.left = rect.x;
298 mswRect.top = rect.y;
299 mswRect.right = rect.x + rect.width;
300 mswRect.bottom = rect.y + rect.height;
301 HDC hdc = (HDC) dc.GetHDC();
302 SetMapMode(hdc,MM_TEXT); // Just in case...
303 DrawFocusRect(hdc,&mswRect);
305 // FIXME: Use DrawFocusRect code above (currently it draws solid line
306 // for caption focus but works ok for other stuff).
307 // Also, this code below may not work in future wx versions, since
308 // it employs wxCAP_BUTT hack to have line of width 1.
309 dc
.SetLogicalFunction(wxINVERT
);
311 wxPen
pen(*wxBLACK
,1,wxDOT
);
312 pen
.SetCap(wxCAP_BUTT
);
314 dc
.SetBrush(*wxTRANSPARENT_BRUSH
);
316 dc
.DrawRectangle(rect
);
318 dc
.SetLogicalFunction(wxCOPY
);
320 dc
.SetLogicalFunction(wxINVERT
);
322 dc
.SetPen(wxPen(*wxBLACK
,1,wxDOT
));
323 dc
.SetBrush(*wxTRANSPARENT_BRUSH
);
325 dc
.DrawRectangle(rect
);
327 dc
.SetLogicalFunction(wxCOPY
);
331 // draw focus background on area in a way typical on platform
333 wxComboCtrl::PrepareBackground( wxDC
& dc
, const wxRect
& rect
, int flags
) const
336 wxUxThemeHandle
hTheme(this, L
"COMBOBOX");
339 wxSize sz
= GetClientSize();
341 bool doDrawFocusRect
; // also selected
343 // For smaller size control (and for disabled background) use less spacing
347 if ( !(flags
& wxCONTROL_ISSUBMENU
) )
350 isEnabled
= IsEnabled();
351 doDrawFocusRect
= ShouldDrawFocus();
354 // Windows-style: for smaller size control (and for disabled background) use less spacing
358 focusSpacingX
= isEnabled
? 2 : 1;
359 focusSpacingY
= sz
.y
> (GetCharHeight()+2) && isEnabled
? 2 : 1;
379 // Drawing a list item
380 isEnabled
= true; // they are never disabled
381 doDrawFocusRect
= flags
& wxCONTROL_SELECTED
? true : false;
387 // Set the background sub-rectangle for selection, disabled etc
388 wxRect
selRect(rect
);
389 selRect
.y
+= focusSpacingY
;
390 selRect
.height
-= (focusSpacingY
*2);
394 if ( !(flags
& wxCONTROL_ISSUBMENU
) )
395 wcp
+= m_widthCustomPaint
;
397 selRect
.x
+= wcp
+ focusSpacingX
;
398 selRect
.width
-= wcp
+ (focusSpacingX
*2);
400 //wxUxThemeEngine* theme = (wxUxThemeEngine*) NULL;
402 // theme = wxUxThemeEngine::GetIfActive();
405 bool doDrawDottedEdge
= false;
406 bool doDrawSelRect
= true;
408 // TODO: doDrawDottedEdge = true when focus has arrived to control via tab.
409 // (and other cases which are not that apparent).
413 // If popup is hidden and this control is focused,
414 // then draw the focus-indicator (selbgcolor background etc.).
415 if ( doDrawFocusRect
)
417 // NB: We can't really use XP visual styles to get TMT_TEXTCOLOR since
418 // it is not properly defined for combo boxes. Instead, they expect
419 // you to use DrawThemeText.
421 // Here is, however, sample code how to get theme colours:
424 // theme->GetThemeColor(hTheme,EP_EDITTEXT,ETS_NORMAL,TMT_TEXTCOLOR,&cref);
425 // dc.SetTextForeground( wxRGBToColour(cref) );
426 if ( (m_iFlags
& wxCC_FULL_BUTTON
) && !(flags
& wxCONTROL_ISSUBMENU
) )
428 // Vista style read-only combo
429 doDrawSelRect
= false;
430 doDrawDottedEdge
= true;
434 dc
.SetTextForeground( wxSystemSettings::GetColour(wxSYS_COLOUR_HIGHLIGHTTEXT
) );
435 bgCol
= wxSystemSettings::GetColour(wxSYS_COLOUR_HIGHLIGHT
);
440 dc
.SetTextForeground( wxSystemSettings::GetColour(wxSYS_COLOUR_WINDOWTEXT
) );
441 bgCol
= GetBackgroundColour();
442 doDrawSelRect
= false;
447 dc
.SetTextForeground( wxSystemSettings::GetColour(wxSYS_COLOUR_GRAYTEXT
) );
448 bgCol
= wxSystemSettings::GetColour(wxSYS_COLOUR_BTNFACE
);
455 dc
.DrawRectangle(selRect
);
458 if ( doDrawDottedEdge
)
459 wxMSWDrawFocusRect(dc
, selRect
);
461 // Don't clip exactly to the selection rectangle so we can draw
462 // to the non-selected area in front of it.
463 wxRect
clipRect(rect
.x
,rect
.y
,
464 (selRect
.x
+selRect
.width
)-rect
.x
-1,rect
.height
);
465 dc
.SetClippingRegion(clipRect
);
468 void wxComboCtrl::OnPaintEvent( wxPaintEvent
& WXUNUSED(event
) )
470 // TODO: Convert drawing in this function to Windows API Code
472 wxSize sz
= GetClientSize();
473 wxAutoBufferedPaintDC
dc(this);
475 const wxRect
& rectButton
= m_btnArea
;
476 wxRect rectTextField
= m_tcArea
;
477 const bool isEnabled
= IsEnabled();
478 wxColour bgCol
= GetBackgroundColour();
480 HDC hDc
= GetHdcOf(dc
);
481 HWND hWnd
= GetHwndOf(this);
484 wxUxThemeEngine
* theme
= NULL
;
485 wxUxThemeHandle
hTheme(this, L
"COMBOBOX");
488 theme
= wxUxThemeEngine::GetIfActive();
491 wxRect
borderRect(0,0,sz
.x
,sz
.y
);
493 if ( m_iFlags
& wxCC_IFLAG_BUTTON_OUTSIDE
)
495 borderRect
= m_tcArea
;
496 borderRect
.Inflate(1);
499 int drawButFlags
= 0;
504 const bool useVistaComboBox
= ::wxGetWinVersion() >= wxWinVersion_Vista
;
507 wxCopyRectToRECT(borderRect
, rFull
);
510 wxCopyRectToRECT(rectButton
, rButton
);
513 wxCopyRectToRECT(borderRect
, rBorder
);
515 bool isNonStdButton
= (m_iFlags
& wxCC_IFLAG_BUTTON_OUTSIDE
) ||
516 (m_iFlags
& wxCC_IFLAG_HAS_NONSTANDARD_BUTTON
);
519 // Get some states for themed drawing
524 butState
= CBXS_DISABLED
;
526 // Vista will display the drop-button as depressed always
527 // when the popup window is visilbe
528 else if ( (m_btnState
& wxCONTROL_PRESSED
) ||
529 (useVistaComboBox
&& !IsPopupWindowState(Hidden
)) )
531 butState
= CBXS_PRESSED
;
533 else if ( m_btnState
& wxCONTROL_CURRENT
)
539 butState
= CBXS_NORMAL
;
542 int comboBoxPart
= 0; // For XP, use the 'default' part
543 RECT
* rUseForBg
= &rBorder
;
545 bool drawFullButton
= false;
546 int bgState
= butState
;
547 const bool isFocused
= (FindFocus() == GetMainWindowOfCompositeControl()) ? true : false;
549 if ( useVistaComboBox
)
551 // FIXME: Either SetBackgroundColour or GetBackgroundColour
552 // doesn't work under Vista, so here's a temporary
554 bgCol
= wxSystemSettings::GetColour(wxSYS_COLOUR_WINDOW
);
556 // Draw the entire control as a single button?
557 if ( !isNonStdButton
)
559 if ( HasFlag(wxCB_READONLY
) )
560 drawFullButton
= true;
563 if ( drawFullButton
)
565 comboBoxPart
= CP_READONLY
;
568 // It should be safe enough to update this flag here.
569 m_iFlags
|= wxCC_FULL_BUTTON
;
573 comboBoxPart
= CP_BORDER
;
574 m_iFlags
&= ~wxCC_FULL_BUTTON
;
577 bgState
= CBB_FOCUSED
;
579 bgState
= CBB_NORMAL
;
584 // Draw parent's background, if necessary
585 RECT
* rUseForTb
= NULL
;
587 if ( theme
->IsThemeBackgroundPartiallyTransparent( hTheme
, comboBoxPart
, bgState
) )
589 else if ( m_iFlags
& wxCC_IFLAG_BUTTON_OUTSIDE
)
590 rUseForTb
= &rButton
;
593 theme
->DrawThemeParentBackground( hWnd
, hDc
, rUseForTb
);
596 // Draw the control background (including the border)
597 if ( m_widthCustomBorder
> 0 )
599 theme
->DrawThemeBackground( hTheme
, hDc
, comboBoxPart
, bgState
, rUseForBg
, NULL
);
603 // No border. We can't use theme, since it cannot be relied on
604 // to deliver borderless drawing, even with DrawThemeBackgroundEx.
607 dc
.DrawRectangle(borderRect
);
611 // Draw the drop-button
612 if ( !isNonStdButton
)
614 drawButFlags
= Button_BitmapOnly
;
616 int butPart
= CP_DROPDOWNBUTTON
;
618 if ( useVistaComboBox
)
620 if ( drawFullButton
)
622 // We need to alter the button style slightly before
623 // drawing the actual button (but it was good above
624 // when background etc was done).
625 if ( butState
== CBXS_HOT
|| butState
== CBXS_PRESSED
)
626 butState
= CBXS_NORMAL
;
629 if ( m_btnSide
== wxRIGHT
)
630 butPart
= CP_DROPDOWNBUTTONRIGHT
;
632 butPart
= CP_DROPDOWNBUTTONLEFT
;
635 theme
->DrawThemeBackground( hTheme
, hDc
, butPart
, butState
, &rButton
, NULL
);
637 else if ( useVistaComboBox
&&
638 (m_iFlags
& wxCC_IFLAG_BUTTON_OUTSIDE
) )
640 // We'll do this, because DrawThemeParentBackground
641 // doesn't seem to be reliable on Vista.
642 drawButFlags
|= Button_PaintBackground
;
648 // Windows 2000 and earlier
649 drawButFlags
= Button_PaintBackground
;
653 dc
.DrawRectangle(borderRect
);
656 // Button rendering (may only do the bitmap on button, depending on the flags)
657 DrawButton( dc
, rectButton
, drawButFlags
);
659 // Paint required portion of the custom image on the control
660 if ( (!m_text
|| m_widthCustomPaint
) )
662 wxASSERT( m_widthCustomPaint
>= 0 );
664 // this is intentionally here to allow drawed rectangle's
665 // right edge to be hidden
667 rectTextField
.width
= m_widthCustomPaint
;
669 dc
.SetFont( GetFont() );
671 dc
.SetClippingRegion(rectTextField
);
672 if ( m_popupInterface
)
673 m_popupInterface
->PaintComboControl(dc
,rectTextField
);
675 wxComboPopup::DefaultPaintComboControl(this,dc
,rectTextField
);
679 void wxComboCtrl::OnMouseEvent( wxMouseEvent
& event
)
682 bool isOnButtonArea
= m_btnArea
.Contains(mx
,event
.m_y
);
683 int handlerFlags
= isOnButtonArea
? wxCC_MF_ON_BUTTON
: 0;
685 if ( PreprocessMouseEvent(event
,isOnButtonArea
) )
688 if ( (m_windowStyle
& (wxCC_SPECIAL_DCLICK
|wxCB_READONLY
)) == wxCB_READONLY
)
690 // if no textctrl and no special double-click, then the entire control acts
692 handlerFlags
|= wxCC_MF_ON_BUTTON
;
693 if ( HandleButtonMouseEvent(event
,handlerFlags
) )
698 if ( isOnButtonArea
|| HasCapture() ||
699 (m_widthCustomPaint
&& mx
< (m_tcArea
.x
+m_widthCustomPaint
)) )
701 handlerFlags
|= wxCC_MF_ON_CLICK_AREA
;
703 if ( HandleButtonMouseEvent(event
,handlerFlags
) )
706 else if ( m_btnState
)
708 // otherwise need to clear the hover status
710 RefreshRect(m_btnArea
);
715 // This will handle left_down and left_dclick events outside button in a Windows-like manner.
716 // See header file for further information on this method.
717 HandleNormalMouseEvent(event
);
721 #if wxUSE_COMBOCTRL_POPUP_ANIMATION
722 static wxUint32
GetUserPreferencesMask()
724 static wxUint32 userPreferencesMask
= 0;
725 static bool valueSet
= false;
728 return userPreferencesMask
;
730 wxRegKey
* pKey
= NULL
;
731 wxRegKey
key1(wxRegKey::HKCU
, wxT("Software\\Policies\\Microsoft\\Control Panel"));
732 wxRegKey
key2(wxRegKey::HKCU
, wxT("Software\\Policies\\Microsoft\\Windows\\Control Panel"));
733 wxRegKey
key3(wxRegKey::HKCU
, wxT("Control Panel\\Desktop"));
737 else if ( key2
.Exists() )
739 else if ( key3
.Exists() )
742 if ( pKey
&& pKey
->Open(wxRegKey::Read
) )
745 if ( pKey
->HasValue(wxT("UserPreferencesMask")) &&
746 pKey
->QueryValue(wxT("UserPreferencesMask"), buf
) )
748 if ( buf
.GetDataLen() >= 4 )
750 wxUint32
* p
= (wxUint32
*) buf
.GetData();
751 userPreferencesMask
= *p
;
758 return userPreferencesMask
;
762 #if wxUSE_COMBOCTRL_POPUP_ANIMATION
763 void wxComboCtrl::OnTimerEvent( wxTimerEvent
& WXUNUSED(event
) )
765 bool stopTimer
= false;
767 wxWindow
* popup
= GetPopupControl()->GetControl();
769 // Popup was hidden before it was fully shown?
770 if ( IsPopupWindowState(Hidden
) )
776 wxLongLong t
= ::wxGetLocalTimeMillis();
777 const wxRect
& rect
= m_animRect
;
778 wxWindow
* win
= GetPopupWindow();
780 int pos
= (int) (t
-m_animStart
).GetLo();
781 if ( pos
< COMBOBOX_ANIMATION_DURATION
)
783 int height
= rect
.height
;
784 //int h0 = rect.height;
785 int h
= (((pos
*256)/COMBOBOX_ANIMATION_DURATION
)*height
)/256;
786 int y
= (height
- h
);
790 if ( m_animFlags
& ShowAbove
)
792 win
->SetSize( rect
.x
, rect
.y
+ height
- h
, rect
.width
, h
);
796 popup
->Move( 0, -y
);
797 win
->SetSize( rect
.x
, rect
.y
, rect
.width
, h
);
810 DoShowPopup( m_animRect
, m_animFlags
);
815 #if wxUSE_COMBOCTRL_POPUP_ANIMATION
816 bool wxComboCtrl::AnimateShow( const wxRect
& rect
, int flags
)
818 if ( GetUserPreferencesMask() & wxMSW_DESKTOP_USERPREFERENCESMASK_COMBOBOXANIM
)
820 m_animStart
= ::wxGetLocalTimeMillis();
824 wxWindow
* win
= GetPopupWindow();
825 win
->SetSize( rect
.x
, rect
.y
, rect
.width
, 0 );
828 m_animTimer
.SetOwner( this, wxID_ANY
);
829 m_animTimer
.Start( COMBOBOX_ANIMATION_RESOLUTION
, wxTIMER_CONTINUOUS
);
831 OnTimerEvent(*((wxTimerEvent
*)NULL
)); // Event is never used, so we can give NULL
840 wxCoord
wxComboCtrl::GetNativeTextIndent() const
843 if ( wxUxThemeEngine::GetIfActive() )
844 return NATIVE_TEXT_INDENT_XP
;
846 return NATIVE_TEXT_INDENT_CLASSIC
;
849 bool wxComboCtrl::IsKeyPopupToggle(const wxKeyEvent
& event
) const
851 const bool isPopupShown
= IsPopupShown();
853 switch ( event
.GetKeyCode() )
856 // F4 toggles the popup in the native comboboxes, so emulate them
857 if ( !event
.AltDown() )
868 // On XP or with writable combo in Classic, arrows don't open the
869 // popup but Alt-arrow does
870 if ( event
.AltDown() ||
872 HasFlag(wxCB_READONLY
)
874 && !wxUxThemeEngine::GetIfActive()
886 #endif // wxUSE_COMBOCTRL