1 /////////////////////////////////////////////////////////////////////////////
3 // Purpose: wxControl common interface
4 // Author: Vadim Zeitlin
8 // Copyright: (c) wxWidgets team
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
12 #ifndef _WX_CONTROL_H_BASE_
13 #define _WX_CONTROL_H_BASE_
15 // ----------------------------------------------------------------------------
17 // ----------------------------------------------------------------------------
23 #include "wx/window.h" // base class
25 extern WXDLLIMPEXP_DATA_CORE(const char) wxControlNameStr
[];
28 // ----------------------------------------------------------------------------
29 // Ellipsize() constants
30 // ----------------------------------------------------------------------------
34 wxELLIPSIZE_FLAGS_NONE
= 0,
35 wxELLIPSIZE_FLAGS_PROCESS_MNEMONICS
= 1,
36 wxELLIPSIZE_FLAGS_EXPAND_TABS
= 2,
38 wxELLIPSIZE_FLAGS_DEFAULT
= wxELLIPSIZE_FLAGS_PROCESS_MNEMONICS
|
39 wxELLIPSIZE_FLAGS_EXPAND_TABS
49 // ----------------------------------------------------------------------------
50 // wxControl is the base class for all controls
51 // ----------------------------------------------------------------------------
53 class WXDLLIMPEXP_CORE wxControlBase
: public wxWindow
58 virtual ~wxControlBase();
60 // Create() function adds the validator parameter
61 bool Create(wxWindow
*parent
, wxWindowID id
,
62 const wxPoint
& pos
= wxDefaultPosition
,
63 const wxSize
& size
= wxDefaultSize
,
65 const wxValidator
& validator
= wxDefaultValidator
,
66 const wxString
& name
= wxControlNameStr
);
68 // get the control alignment (left/right/centre, top/bottom/centre)
69 int GetAlignment() const { return m_windowStyle
& wxALIGN_MASK
; }
71 virtual void SetLabel(const wxString
& label
)
77 wxWindow
::SetLabel(label
);
80 virtual wxString
GetLabel() const
82 // return the original string, as it was passed to SetLabel()
83 // (i.e. with wx-style mnemonics)
87 // get just the text of the label, without mnemonic characters ('&')
88 wxString
GetLabelText() const { return GetLabelText(GetLabel()); }
90 void SetLabelText(const wxString
& text
)
92 SetLabel(EscapeMnemonics(text
));
95 // controls by default inherit the colours of their parents, if a
96 // particular control class doesn't want to do it, it can override
97 // ShouldInheritColours() to return false
98 virtual bool ShouldInheritColours() const { return true; }
101 // WARNING: this doesn't work for all controls nor all platforms!
103 // simulates the event of given type (i.e. wxButton::Command() is just as
104 // if the button was clicked)
105 virtual void Command(wxCommandEvent
&event
);
107 virtual bool SetFont(const wxFont
& font
);
109 // wxControl-specific processing after processing the update event
110 virtual void DoUpdateWindowUI(wxUpdateUIEvent
& event
);
117 // replaces parts of the (multiline) string with ellipsis if needed
118 static wxString
Ellipsize(const wxString
& label
, const wxDC
& dc
,
119 wxEllipsizeMode mode
, int maxWidth
,
120 int flags
= wxELLIPSIZE_FLAGS_DEFAULT
);
122 // get the string without mnemonic characters ('&')
123 static wxString
GetLabelText(const wxString
& label
);
125 // removes the mnemonics characters
126 static wxString
RemoveMnemonics(const wxString
& str
);
128 // escapes (by doubling them) the mnemonics
129 static wxString
EscapeMnemonics(const wxString
& str
);
131 // return the accel index in the string or -1 if none and puts the modified
132 // string into second parameter if non NULL
133 static int FindAccelIndex(const wxString
& label
,
134 wxString
*labelOnly
= NULL
);
136 // this is a helper for the derived class GetClassDefaultAttributes()
137 // implementation: it returns the right colours for the classes which
138 // contain something else (e.g. wxListBox, wxTextCtrl, ...) instead of
139 // being simple controls (such as wxButton, wxCheckBox, ...)
140 static wxVisualAttributes
141 GetCompositeControlsDefaultAttributes(wxWindowVariant variant
);
144 // choose the default border for this window
145 virtual wxBorder
GetDefaultBorder() const;
147 // creates the control (calls wxWindowBase::CreateBase inside) and adds it
148 // to the list of parents children
149 bool CreateControl(wxWindowBase
*parent
,
154 const wxValidator
& validator
,
155 const wxString
& name
);
157 // initialize the common fields of wxCommandEvent
158 void InitCommandEvent(wxCommandEvent
& event
) const;
160 // Ellipsize() helper:
161 static wxString
DoEllipsizeSingleLine(const wxString
& label
, const wxDC
& dc
,
162 wxEllipsizeMode mode
, int maxWidth
,
163 int replacementWidth
, int marginWidth
);
165 // this field contains the label in wx format, i.e. with '&' mnemonics
166 wxString m_labelOrig
;
168 wxDECLARE_NO_COPY_CLASS(wxControlBase
);
171 // ----------------------------------------------------------------------------
172 // include platform-dependent wxControl declarations
173 // ----------------------------------------------------------------------------
175 #if defined(__WXUNIVERSAL__)
176 #include "wx/univ/control.h"
177 #elif defined(__WXPALMOS__)
178 #include "wx/palmos/control.h"
179 #elif defined(__WXMSW__)
180 #include "wx/msw/control.h"
181 #elif defined(__WXMOTIF__)
182 #include "wx/motif/control.h"
183 #elif defined(__WXGTK20__)
184 #include "wx/gtk/control.h"
185 #elif defined(__WXGTK__)
186 #include "wx/gtk1/control.h"
187 #elif defined(__WXMAC__)
188 #include "wx/osx/control.h"
189 #elif defined(__WXCOCOA__)
190 #include "wx/cocoa/control.h"
191 #elif defined(__WXPM__)
192 #include "wx/os2/control.h"
195 #endif // wxUSE_CONTROLS
198 // _WX_CONTROL_H_BASE_