Change event names to clarify that they are only fired by button clicks, and note...
[wxWidgets.git] / include / wx / srchctrl.h
1 /////////////////////////////////////////////////////////////////////////////
2 // Name: srchctrl.h
3 // Purpose: wxSearchCtrlBase class
4 // Author: Vince Harron
5 // Created: 2006-02-18
6 // RCS-ID: $Id$
7 // Copyright: (c) Vince Harron
8 // Licence: wxWindows licence
9 /////////////////////////////////////////////////////////////////////////////
10
11 #ifndef _WX_SEARCHCTRL_H_BASE_
12 #define _WX_SEARCHCTRL_H_BASE_
13
14 #include "wx/defs.h"
15
16 #if wxUSE_SEARCHCTRL
17
18 #include "wx/textctrl.h"
19
20 #if !defined(__WXUNIVERSAL__) && defined(__WXMAC__) && defined(__WXMAC_OSX__) \
21 && (MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_3)
22 // search control was introduced in Mac OS X 10.3 Panther
23 #define wxUSE_NATIVE_SEARCH_CONTROL 1
24
25 #define wxSearchCtrlBaseBaseClass wxTextCtrl
26 #else
27 // no native version, use the generic one
28 #define wxUSE_NATIVE_SEARCH_CONTROL 0
29
30 #define wxSearchCtrlBaseBaseClass wxTextCtrlBase
31 #endif
32
33 // ----------------------------------------------------------------------------
34 // constants
35 // ----------------------------------------------------------------------------
36
37 extern WXDLLEXPORT_DATA(const wxChar) wxSearchCtrlNameStr[];
38
39 BEGIN_DECLARE_EVENT_TYPES()
40 DECLARE_EVENT_TYPE(wxEVT_COMMAND_SEARCHCTRL_CANCEL_BTN, 1119)
41 DECLARE_EVENT_TYPE(wxEVT_COMMAND_SEARCHCTRL_SEARCH_BTN, 1120)
42 END_DECLARE_EVENT_TYPES()
43
44 // ----------------------------------------------------------------------------
45 // a search ctrl is a text control with a search button and a cancel button
46 // it is based on the MacOSX 10.3 control HISearchFieldCreate
47 // ----------------------------------------------------------------------------
48
49 class WXDLLEXPORT wxSearchCtrlBase : public wxSearchCtrlBaseBaseClass
50 {
51 public:
52 wxSearchCtrlBase() { }
53 virtual ~wxSearchCtrlBase() { }
54
55 // search control
56 virtual void SetMenu(wxMenu *menu) = 0;
57 virtual wxMenu *GetMenu() = 0;
58
59 // get/set options
60 virtual void ShowSearchButton( bool show ) = 0;
61 virtual bool IsSearchButtonVisible() const = 0;
62
63 virtual void ShowCancelButton( bool show ) = 0;
64 virtual bool IsCancelButtonVisible() const = 0;
65 };
66
67
68 // include the platform-dependent class implementation
69 #if wxUSE_NATIVE_SEARCH_CONTROL
70 #if defined(__WXMAC__)
71 #include "wx/mac/srchctrl.h"
72 #endif
73 #else
74 #include "wx/generic/srchctlg.h"
75 #endif
76
77 // ----------------------------------------------------------------------------
78 // macros for handling search events
79 // ----------------------------------------------------------------------------
80
81 #define EVT_SEARCHCTRL_CANCEL_BTN(id, fn) \
82 wx__DECLARE_EVT1(wxEVT_COMMAND_SEARCHCTRL_CANCEL_BTN, id, wxCommandEventHandler(fn))
83
84 #define EVT_SEARCHCTRL_SEARCH_BTN(id, fn) \
85 wx__DECLARE_EVT1(wxEVT_COMMAND_SEARCHCTRL_SEARCH_BTN, id, wxCommandEventHandler(fn))
86
87 #endif // wxUSE_SEARCHCTRL
88
89 #endif // _WX_SEARCHCTRL_H_BASE_