1 /////////////////////////////////////////////////////////////////////////////
2 // Name: src/msw/combobox.cpp
3 // Purpose: wxComboBox class
4 // Author: Julian Smart
8 // Copyright: (c) Julian Smart
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
12 // ============================================================================
14 // ============================================================================
16 // ----------------------------------------------------------------------------
18 // ----------------------------------------------------------------------------
20 // For compilers that support precompilation, includes "wx.h".
21 #include "wx/wxprec.h"
29 #include "wx/combobox.h"
32 #include "wx/settings.h"
34 // for wxEVT_COMMAND_TEXT_ENTER
35 #include "wx/textctrl.h"
40 #include "wx/clipbrd.h"
41 #include "wx/msw/private.h"
43 // include <commctrl.h> "properly"
44 #include "wx/msw/wrapcctl.h"
45 #include "wx/msw/wrapshl.h"
48 #include "wx/tooltip.h"
49 #endif // wxUSE_TOOLTIPS
51 // ----------------------------------------------------------------------------
53 // ----------------------------------------------------------------------------
55 #if wxUSE_EXTENDED_RTTI
56 WX_DEFINE_FLAGS( wxComboBoxStyle
)
58 wxBEGIN_FLAGS( wxComboBoxStyle
)
59 // new style border flags, we put them first to
60 // use them for streaming out
61 wxFLAGS_MEMBER(wxBORDER_SIMPLE
)
62 wxFLAGS_MEMBER(wxBORDER_SUNKEN
)
63 wxFLAGS_MEMBER(wxBORDER_DOUBLE
)
64 wxFLAGS_MEMBER(wxBORDER_RAISED
)
65 wxFLAGS_MEMBER(wxBORDER_STATIC
)
66 wxFLAGS_MEMBER(wxBORDER_NONE
)
68 // old style border flags
69 wxFLAGS_MEMBER(wxSIMPLE_BORDER
)
70 wxFLAGS_MEMBER(wxSUNKEN_BORDER
)
71 wxFLAGS_MEMBER(wxDOUBLE_BORDER
)
72 wxFLAGS_MEMBER(wxRAISED_BORDER
)
73 wxFLAGS_MEMBER(wxSTATIC_BORDER
)
74 wxFLAGS_MEMBER(wxBORDER
)
76 // standard window styles
77 wxFLAGS_MEMBER(wxTAB_TRAVERSAL
)
78 wxFLAGS_MEMBER(wxCLIP_CHILDREN
)
79 wxFLAGS_MEMBER(wxTRANSPARENT_WINDOW
)
80 wxFLAGS_MEMBER(wxWANTS_CHARS
)
81 wxFLAGS_MEMBER(wxFULL_REPAINT_ON_RESIZE
)
82 wxFLAGS_MEMBER(wxALWAYS_SHOW_SB
)
83 wxFLAGS_MEMBER(wxVSCROLL
)
84 wxFLAGS_MEMBER(wxHSCROLL
)
86 wxFLAGS_MEMBER(wxCB_SIMPLE
)
87 wxFLAGS_MEMBER(wxCB_SORT
)
88 wxFLAGS_MEMBER(wxCB_READONLY
)
89 wxFLAGS_MEMBER(wxCB_DROPDOWN
)
91 wxEND_FLAGS( wxComboBoxStyle
)
93 IMPLEMENT_DYNAMIC_CLASS_XTI(wxComboBox
, wxControl
,"wx/combobox.h")
95 wxBEGIN_PROPERTIES_TABLE(wxComboBox
)
96 wxEVENT_PROPERTY( Select
, wxEVT_COMMAND_COMBOBOX_SELECTED
, wxCommandEvent
)
97 wxEVENT_PROPERTY( TextEnter
, wxEVT_COMMAND_TEXT_ENTER
, wxCommandEvent
)
100 wxPROPERTY( Font
, wxFont
, SetFont
, GetFont
, EMPTY_MACROVALUE
, 0 /*flags*/ , wxT("Helpstring") , wxT("group"))
101 wxPROPERTY_COLLECTION( Choices
, wxArrayString
, wxString
, AppendString
, GetStrings
, 0 /*flags*/ , wxT("Helpstring") , wxT("group"))
102 wxPROPERTY( Value
,wxString
, SetValue
, GetValue
, EMPTY_MACROVALUE
, 0 /*flags*/ , wxT("Helpstring") , wxT("group"))
103 wxPROPERTY( Selection
,int, SetSelection
, GetSelection
, EMPTY_MACROVALUE
, 0 /*flags*/ , wxT("Helpstring") , wxT("group"))
104 wxPROPERTY_FLAGS( WindowStyle
, wxComboBoxStyle
, long , SetWindowStyleFlag
, GetWindowStyleFlag
, EMPTY_MACROVALUE
, 0 /*flags*/ , wxT("Helpstring") , wxT("group")) // style
105 wxEND_PROPERTIES_TABLE()
107 wxBEGIN_HANDLERS_TABLE(wxComboBox
)
108 wxEND_HANDLERS_TABLE()
110 wxCONSTRUCTOR_5( wxComboBox
, wxWindow
* , Parent
, wxWindowID
, Id
, wxString
, Value
, wxPoint
, Position
, wxSize
, Size
)
114 IMPLEMENT_DYNAMIC_CLASS(wxComboBox
, wxControl
)
118 BEGIN_EVENT_TABLE(wxComboBox
, wxControl
)
119 EVT_MENU(wxID_CUT
, wxComboBox::OnCut
)
120 EVT_MENU(wxID_COPY
, wxComboBox::OnCopy
)
121 EVT_MENU(wxID_PASTE
, wxComboBox::OnPaste
)
122 EVT_MENU(wxID_UNDO
, wxComboBox::OnUndo
)
123 EVT_MENU(wxID_REDO
, wxComboBox::OnRedo
)
124 EVT_MENU(wxID_CLEAR
, wxComboBox::OnDelete
)
125 EVT_MENU(wxID_SELECTALL
, wxComboBox::OnSelectAll
)
127 EVT_UPDATE_UI(wxID_CUT
, wxComboBox::OnUpdateCut
)
128 EVT_UPDATE_UI(wxID_COPY
, wxComboBox::OnUpdateCopy
)
129 EVT_UPDATE_UI(wxID_PASTE
, wxComboBox::OnUpdatePaste
)
130 EVT_UPDATE_UI(wxID_UNDO
, wxComboBox::OnUpdateUndo
)
131 EVT_UPDATE_UI(wxID_REDO
, wxComboBox::OnUpdateRedo
)
132 EVT_UPDATE_UI(wxID_CLEAR
, wxComboBox::OnUpdateDelete
)
133 EVT_UPDATE_UI(wxID_SELECTALL
, wxComboBox::OnUpdateSelectAll
)
136 // ----------------------------------------------------------------------------
137 // function prototypes
138 // ----------------------------------------------------------------------------
140 LRESULT APIENTRY _EXPORT
wxComboEditWndProc(HWND hWnd
,
145 // ---------------------------------------------------------------------------
147 // ---------------------------------------------------------------------------
149 // the pointer to standard radio button wnd proc
150 static WNDPROC gs_wndprocEdit
= (WNDPROC
)NULL
;
152 // ============================================================================
154 // ============================================================================
156 // ----------------------------------------------------------------------------
157 // wnd proc for subclassed edit control
158 // ----------------------------------------------------------------------------
160 LRESULT APIENTRY _EXPORT
wxComboEditWndProc(HWND hWnd
,
165 HWND hwndCombo
= ::GetParent(hWnd
);
166 wxWindow
*win
= wxFindWinFromHandle((WXHWND
)hwndCombo
);
170 // forward some messages to the combobox to generate the appropriate
171 // wxEvents from them
181 wxComboBox
*combo
= wxDynamicCast(win
, wxComboBox
);
184 // we can get WM_KILLFOCUS while our parent is already half
185 // destroyed and hence doesn't look like a combobx any
186 // longer, check for it to avoid bogus assert failures
187 if ( !win
->IsBeingDeleted() )
189 wxFAIL_MSG( _T("should have combo as parent") );
192 else if ( combo
->MSWProcessEditMsg(message
, wParam
, lParam
) )
202 wxCHECK_MSG( win
, 0, _T("should have a parent") );
204 if ( win
->GetWindowStyle() & wxTE_PROCESS_ENTER
)
206 // need to return a custom dlg code or we'll never get it
207 return DLGC_WANTMESSAGE
;
215 if( win
->HandleClipboardEvent( message
) )
220 return ::CallWindowProc(CASTWNDPROC gs_wndprocEdit
, hWnd
, message
, wParam
, lParam
);
223 // ----------------------------------------------------------------------------
224 // wxComboBox callbacks
225 // ----------------------------------------------------------------------------
227 WXLRESULT
wxComboBox::MSWWindowProc(WXUINT nMsg
, WXWPARAM wParam
, WXLPARAM lParam
)
229 // TODO: handle WM_CTLCOLOR messages from our EDIT control to be able to
230 // set its colour correctly (to be the same as our own one)
235 // wxStaticBox can generate this message, when modifying the control's style.
236 // This causes the content of the combobox to be selected, for some reason.
237 case WM_STYLECHANGED
:
239 // combobox selection sometimes spontaneously changes when its
240 // size changes, restore it to the old value if necessary
242 GetSelection(&fromOld
, &toOld
);
243 WXLRESULT result
= wxChoice::MSWWindowProc(nMsg
, wParam
, lParam
);
246 GetSelection(&fromNew
, &toNew
);
248 if ( fromOld
!= fromNew
|| toOld
!= toNew
)
250 SetSelection(fromOld
, toOld
);
257 return wxChoice::MSWWindowProc(nMsg
, wParam
, lParam
);
260 bool wxComboBox::MSWProcessEditMsg(WXUINT msg
, WXWPARAM wParam
, WXLPARAM lParam
)
265 // for compatibility with wxTextCtrl, generate a special message
266 // when Enter is pressed
267 if ( wParam
== VK_RETURN
)
269 wxCommandEvent
event(wxEVT_COMMAND_TEXT_ENTER
, m_windowId
);
271 const int sel
= GetSelection();
273 event
.SetString(GetValue());
274 InitCommandEventWithItems(event
, sel
);
276 if ( ProcessCommand(event
) )
278 // don't let the event through to the native control
279 // because it doesn't need it and may generate an annoying
280 // beep if it gets it
287 return HandleChar(wParam
, lParam
, true /* isASCII */);
291 return HandleKeyDown(wParam
, lParam
);
295 return HandleKeyUp(wParam
, lParam
);
298 return HandleSetFocus((WXHWND
)wParam
);
301 return HandleKillFocus((WXHWND
)wParam
);
307 bool wxComboBox::MSWCommand(WXUINT param
, WXWORD id
)
315 #ifndef __SMARTPHONE__
316 // we need to reset this to prevent the selection from being undone
317 // by wxChoice, see wxChoice::MSWCommand() and comments there
318 m_lastAcceptedSelection
= wxID_NONE
;
321 // set these variables so that they could be also fixed in
322 // CBN_EDITCHANGE below
323 sel
= GetSelection();
324 value
= GetStringSelection();
326 // this string is going to become the new combobox value soon but
327 // we need it to be done right now, otherwise the event handler
328 // could get a wrong value when it calls our GetValue()
329 ::SetWindowText(GetHwnd(), value
);
332 wxCommandEvent
event(wxEVT_COMMAND_COMBOBOX_SELECTED
, GetId());
334 event
.SetString(value
);
335 InitCommandEventWithItems(event
, sel
);
337 ProcessCommand(event
);
340 // fall through: for compability with wxGTK, also send the text
341 // update event when the selection changes (this also seems more
342 // logical as the text does change)
346 wxCommandEvent
event(wxEVT_COMMAND_TEXT_UPDATED
, GetId());
348 // if sel != -1, value was already initialized above
351 value
= wxGetWindowText(GetHwnd());
354 event
.SetString(value
);
355 InitCommandEventWithItems(event
, sel
);
357 ProcessCommand(event
);
362 return wxChoice::MSWCommand(param
, id
);
365 // skip wxChoice version as it would generate its own events for
367 return wxControl::MSWCommand(param
, id
);
370 WXHWND
wxComboBox::GetEditHWND() const
372 // this function should not be called for wxCB_READONLY controls, it is
373 // the callers responsability to check this
374 wxASSERT_MSG( !(GetWindowStyle() & wxCB_READONLY
),
375 _T("read-only combobox doesn't have any edit control") );
379 HWND hwndEdit
= ::ChildWindowFromPoint(GetHwnd(), pt
);
380 if ( !hwndEdit
|| hwndEdit
== GetHwnd() )
382 wxFAIL_MSG(_T("not read only combobox without edit control?"));
385 return (WXHWND
)hwndEdit
;
388 // ----------------------------------------------------------------------------
389 // wxComboBox creation
390 // ----------------------------------------------------------------------------
392 bool wxComboBox::Create(wxWindow
*parent
, wxWindowID id
,
393 const wxString
& value
,
396 int n
, const wxString choices
[],
398 const wxValidator
& validator
,
399 const wxString
& name
)
401 // pretend that wxComboBox is hidden while it is positioned and resized and
402 // show it only right before leaving this method because otherwise there is
403 // some noticeable flicker while the control rearranges itself
406 if ( !CreateAndInit(parent
, id
, pos
, size
, n
, choices
, style
,
410 // we shouldn't call SetValue() for an empty string because this would
411 // (correctly) result in an assert with a read only combobox and is useless
412 // for the other ones anyhow
413 if ( !value
.empty() )
416 // a (not read only) combobox is, in fact, 2 controls: the combobox itself
417 // and an edit control inside it and if we want to catch events from this
418 // edit control, we must subclass it as well
419 if ( !(style
& wxCB_READONLY
) )
421 const HWND hwndEdit
= (HWND
)GetEditHWND();
423 gs_wndprocEdit
= wxSetWindowProc(hwndEdit
, wxComboEditWndProc
);
425 if ( style
& wxCB_FILENAME
)
427 wxEnableFileNameAutoComplete(hwndEdit
);
431 // and finally, show the control
437 bool wxComboBox::Create(wxWindow
*parent
, wxWindowID id
,
438 const wxString
& value
,
441 const wxArrayString
& choices
,
443 const wxValidator
& validator
,
444 const wxString
& name
)
446 wxCArrayString
chs(choices
);
447 return Create(parent
, id
, value
, pos
, size
, chs
.GetCount(),
448 chs
.GetStrings(), style
, validator
, name
);
451 WXDWORD
wxComboBox::MSWGetStyle(long style
, WXDWORD
*exstyle
) const
453 // we never have an external border
454 WXDWORD msStyle
= wxChoice::MSWGetStyle
456 (style
& ~wxBORDER_MASK
) | wxBORDER_NONE
, exstyle
459 // usually WS_TABSTOP is added by wxControl::MSWGetStyle() but as we're
460 // created hidden (see Create() above), it is not done for us but we still
461 // want to have this style
462 msStyle
|= WS_TABSTOP
;
464 // remove the style always added by wxChoice
465 msStyle
&= ~CBS_DROPDOWNLIST
;
467 if ( style
& wxCB_READONLY
)
468 msStyle
|= CBS_DROPDOWNLIST
;
470 else if ( style
& wxCB_SIMPLE
)
471 msStyle
|= CBS_SIMPLE
; // A list (shown always) and edit control
474 msStyle
|= CBS_DROPDOWN
;
476 // there is no reason to not always use CBS_AUTOHSCROLL, so do use it
477 msStyle
|= CBS_AUTOHSCROLL
;
479 // NB: we used to also add CBS_NOINTEGRALHEIGHT here but why?
484 // ----------------------------------------------------------------------------
485 // wxComboBox text control-like methods
486 // ----------------------------------------------------------------------------
488 wxString
wxComboBox::GetValue() const
490 return wxGetWindowText(m_hWnd
);
493 void wxComboBox::SetValue(const wxString
& value
)
495 if ( HasFlag(wxCB_READONLY
) )
496 SetStringSelection(value
);
498 SetWindowText(GetHwnd(), value
.c_str());
501 // Clipboard operations
502 void wxComboBox::Copy()
504 SendMessage(GetHwnd(), WM_COPY
, 0, 0L);
507 void wxComboBox::Cut()
509 SendMessage(GetHwnd(), WM_CUT
, 0, 0L);
512 void wxComboBox::Paste()
514 SendMessage(GetHwnd(), WM_PASTE
, 0, 0L);
517 void wxComboBox::Undo()
521 HWND hEditWnd
= (HWND
) GetEditHWND();
523 ::SendMessage(hEditWnd
, EM_UNDO
, 0, 0);
527 void wxComboBox::Redo()
531 // Same as Undo, since Undo undoes the undo, i.e. a redo.
532 HWND hEditWnd
= (HWND
) GetEditHWND();
534 ::SendMessage(hEditWnd
, EM_UNDO
, 0, 0);
538 void wxComboBox::SelectAll()
540 SetSelection(0, GetLastPosition());
543 bool wxComboBox::CanUndo() const
548 HWND hEditWnd
= (HWND
) GetEditHWND();
550 return ::SendMessage(hEditWnd
, EM_CANUNDO
, 0, 0) != 0;
555 bool wxComboBox::CanRedo() const
560 HWND hEditWnd
= (HWND
) GetEditHWND();
562 return ::SendMessage(hEditWnd
, EM_CANUNDO
, 0, 0) != 0;
567 bool wxComboBox::HasSelection() const
570 GetSelection(&from
, &to
);
574 bool wxComboBox::CanCopy() const
576 // Can copy if there's a selection
577 return HasSelection();
580 bool wxComboBox::CanCut() const
582 return IsEditable() && CanCopy();
585 bool wxComboBox::CanPaste() const
590 // Standard edit control: check for straight text on clipboard
591 if ( !::OpenClipboard(GetHwndOf(wxTheApp
->GetTopWindow())) )
594 bool isTextAvailable
= ::IsClipboardFormatAvailable(CF_TEXT
) != 0;
597 return isTextAvailable
;
600 bool wxComboBox::IsEditable() const
602 return !HasFlag(wxCB_READONLY
);
605 void wxComboBox::SetEditable(bool WXUNUSED(editable
))
607 // Can't implement in MSW?
608 // HWND hWnd = GetHwnd();
609 // SendMessage(hWnd, EM_SETREADONLY, (WPARAM)!editable, (LPARAM)0L);
612 void wxComboBox::SetInsertionPoint(long pos
)
614 if ( GetWindowStyle() & wxCB_READONLY
)
618 HWND hWnd
= GetHwnd();
619 ::SendMessage(hWnd
, CB_SETEDITSEL
, 0, MAKELPARAM(pos
, pos
));
620 HWND hEditWnd
= (HWND
) GetEditHWND();
623 // Scroll insertion point into view
624 SendMessage(hEditWnd
, EM_SCROLLCARET
, (WPARAM
)0, (LPARAM
)0);
625 // Why is this necessary? (Copied from wxTextCtrl::SetInsertionPoint)
626 SendMessage(hEditWnd
, EM_REPLACESEL
, 0, (LPARAM
) wxEmptyString
);
631 void wxComboBox::SetInsertionPointEnd()
633 // setting insertion point doesn't make sense for read only comboboxes
634 if ( !(GetWindowStyle() & wxCB_READONLY
) )
636 wxTextPos pos
= GetLastPosition();
637 SetInsertionPoint(pos
);
641 long wxComboBox::GetInsertionPoint() const
643 // CB_GETEDITSEL returns the index of the first character of the selection in
644 // its low-order word
645 DWORD pos
= (DWORD
)::SendMessage(GetHwnd(), CB_GETEDITSEL
, 0, 0L);
649 wxTextPos
wxComboBox::GetLastPosition() const
651 HWND hEditWnd
= (HWND
) GetEditHWND();
653 // Get number of characters in the last (only) line. We'll add this to the character
654 // index for the last line, 1st position.
655 wxTextPos lineLength
= (wxTextPos
)SendMessage(hEditWnd
, EM_LINELENGTH
, (WPARAM
) 0, (LPARAM
)0L);
660 void wxComboBox::Replace(long from
, long to
, const wxString
& value
)
665 // Now replace with 'value', by pasting.
666 wxSetClipboardData(wxDF_TEXT
, (wxObject
*)(const wxChar
*)value
, 0, 0);
668 // Paste into edit control
669 SendMessage(GetHwnd(), WM_PASTE
, (WPARAM
)0, (LPARAM
)0L);
677 void wxComboBox::Remove(long from
, long to
)
679 // Set selection and remove it
680 SetSelection(from
, to
);
681 SendMessage(GetHwnd(), WM_CUT
, (WPARAM
)0, (LPARAM
)0);
684 void wxComboBox::SetSelection(long from
, long to
)
686 // if from and to are both -1, it means (in wxWidgets) that all text should
687 // be selected, translate this into Windows convention
688 if ( (from
== -1) && (to
== -1) )
693 if ( SendMessage(GetHwnd(), CB_SETEDITSEL
,
694 0, (LPARAM
)MAKELONG(from
, to
)) == CB_ERR
)
696 wxLogDebug(_T("CB_SETEDITSEL failed"));
700 void wxComboBox::GetSelection(long* from
, long* to
) const
702 DWORD dwStart
, dwEnd
;
703 if ( ::SendMessage(GetHwnd(), CB_GETEDITSEL
,
704 (WPARAM
)&dwStart
, (LPARAM
)&dwEnd
) == CB_ERR
)
716 // ----------------------------------------------------------------------------
717 // standard event handling
718 // ----------------------------------------------------------------------------
720 void wxComboBox::OnCut(wxCommandEvent
& WXUNUSED(event
))
725 void wxComboBox::OnCopy(wxCommandEvent
& WXUNUSED(event
))
730 void wxComboBox::OnPaste(wxCommandEvent
& WXUNUSED(event
))
735 void wxComboBox::OnUndo(wxCommandEvent
& WXUNUSED(event
))
740 void wxComboBox::OnRedo(wxCommandEvent
& WXUNUSED(event
))
745 void wxComboBox::OnDelete(wxCommandEvent
& WXUNUSED(event
))
748 GetSelection(& from
, & to
);
749 if (from
!= -1 && to
!= -1)
753 void wxComboBox::OnSelectAll(wxCommandEvent
& WXUNUSED(event
))
755 SetSelection(-1, -1);
758 void wxComboBox::OnUpdateCut(wxUpdateUIEvent
& event
)
760 event
.Enable( CanCut() );
763 void wxComboBox::OnUpdateCopy(wxUpdateUIEvent
& event
)
765 event
.Enable( CanCopy() );
768 void wxComboBox::OnUpdatePaste(wxUpdateUIEvent
& event
)
770 event
.Enable( CanPaste() );
773 void wxComboBox::OnUpdateUndo(wxUpdateUIEvent
& event
)
775 event
.Enable( CanUndo() );
778 void wxComboBox::OnUpdateRedo(wxUpdateUIEvent
& event
)
780 event
.Enable( CanRedo() );
783 void wxComboBox::OnUpdateDelete(wxUpdateUIEvent
& event
)
785 event
.Enable(HasSelection() && IsEditable());
788 void wxComboBox::OnUpdateSelectAll(wxUpdateUIEvent
& event
)
790 event
.Enable(GetLastPosition() > 0);
793 #endif // wxUSE_COMBOBOX