]> git.saurik.com Git - wxWidgets.git/blame - include/wx/msw/textctrl.h
no changes, just remove #if'd out code
[wxWidgets.git] / include / wx / msw / textctrl.h
CommitLineData
2bda0e17 1/////////////////////////////////////////////////////////////////////////////
d7eee191 2// Name: wx/msw/textctrl.h
2bda0e17
KB
3// Purpose: wxTextCtrl class
4// Author: Julian Smart
5// Modified by:
6// Created: 01/02/97
7// RCS-ID: $Id$
bbcdf8bc 8// Copyright: (c) Julian Smart
65571936 9// Licence: wxWindows licence
2bda0e17
KB
10/////////////////////////////////////////////////////////////////////////////
11
bbcdf8bc
JS
12#ifndef _WX_TEXTCTRL_H_
13#define _WX_TEXTCTRL_H_
2bda0e17 14
53a2db12 15class WXDLLIMPEXP_CORE wxTextCtrl : public wxTextCtrlBase
2bda0e17 16{
ae29de83 17public:
bfc6fde4
VZ
18 // creation
19 // --------
a1b82138 20
aac7e7fe 21 wxTextCtrl() { Init(); }
bfc6fde4 22 wxTextCtrl(wxWindow *parent, wxWindowID id,
a1b82138
VZ
23 const wxString& value = wxEmptyString,
24 const wxPoint& pos = wxDefaultPosition,
25 const wxSize& size = wxDefaultSize,
26 long style = 0,
27 const wxValidator& validator = wxDefaultValidator,
28 const wxString& name = wxTextCtrlNameStr)
29 {
aac7e7fe
VZ
30 Init();
31
a1b82138
VZ
32 Create(parent, id, value, pos, size, style, validator, name);
33 }
d3c7fc99 34 virtual ~wxTextCtrl();
bfc6fde4
VZ
35
36 bool Create(wxWindow *parent, wxWindowID id,
a1b82138
VZ
37 const wxString& value = wxEmptyString,
38 const wxPoint& pos = wxDefaultPosition,
39 const wxSize& size = wxDefaultSize,
40 long style = 0,
41 const wxValidator& validator = wxDefaultValidator,
42 const wxString& name = wxTextCtrlNameStr);
bfc6fde4 43
fa2f57be
VZ
44 // overridden wxTextEntry methods
45 // ------------------------------
4438caf4
VZ
46
47 virtual wxString GetValue() const;
fa2f57be
VZ
48 virtual wxString GetRange(long from, long to) const;
49
28fdd8db 50 virtual bool IsEmpty() const;
bfc6fde4 51
fa2f57be
VZ
52 virtual void WriteText(const wxString& text);
53 virtual void AppendText(const wxString& text);
54 virtual void Clear();
a5aa8086 55
bfc6fde4
VZ
56 virtual int GetLineLength(long lineNo) const;
57 virtual wxString GetLineText(long lineNo) const;
58 virtual int GetNumberOfLines() const;
59
fa2f57be 60 virtual void SetMaxLength(unsigned long len);
a1b82138 61
fa2f57be 62 virtual void GetSelection(long *from, long *to) const;
a1b82138 63
fa2f57be
VZ
64 virtual void Redo();
65 virtual bool CanRedo() const;
bfc6fde4 66
fa2f57be
VZ
67 virtual void SetInsertionPointEnd();
68 virtual long GetInsertionPoint() const;
69 virtual wxTextPos GetLastPosition() const;
70
71 // implement base class pure virtuals
72 // ----------------------------------
a1b82138 73
fa2f57be 74 virtual bool IsModified() const;
3a9fa0d6 75 virtual void MarkDirty();
a1b82138
VZ
76 virtual void DiscardEdits();
77
94af7d45
VZ
78#ifdef __WIN32__
79 virtual bool EmulateKeyPress(const wxKeyEvent& event);
80#endif // __WIN32__
81
4bc1afd5
VZ
82#if wxUSE_RICHEDIT
83 // apply text attribute to the range of text (only works with richedit
84 // controls)
85 virtual bool SetStyle(long start, long end, const wxTextAttr& style);
5bf75ae7 86 virtual bool SetDefaultStyle(const wxTextAttr& style);
e00a5d3c 87 virtual bool GetStyle(long position, wxTextAttr& style);
4bc1afd5
VZ
88#endif // wxUSE_RICHEDIT
89
a1b82138
VZ
90 // translate between the position (which is just an index in the text ctrl
91 // considering all its contents as a single strings) and (x, y) coordinates
92 // which represent column and line.
93 virtual long XYToPosition(long x, long y) const;
0efe5ba7 94 virtual bool PositionToXY(long pos, long *x, long *y) const;
a1b82138
VZ
95
96 virtual void ShowPosition(long pos);
6726a6b0 97 virtual wxTextCtrlHitTestResult HitTest(const wxPoint& pt, long *pos) const;
3b830ce0
VZ
98 virtual wxTextCtrlHitTestResult HitTest(const wxPoint& pt,
99 wxTextCoord *col,
100 wxTextCoord *row) const
101 {
102 return wxTextCtrlBase::HitTest(pt, col, row);
103 }
a1b82138 104
e3a6a6b2 105 // Caret handling (Windows only)
e3a6a6b2
VZ
106 bool ShowNativeCaret(bool show = true);
107 bool HideNativeCaret() { return ShowNativeCaret(false); }
108
4438caf4
VZ
109 // Implementation from now on
110 // --------------------------
20a0e999
VZ
111
112#if wxUSE_DRAG_AND_DROP && wxUSE_RICHEDIT
113 virtual void SetDropTarget(wxDropTarget *dropTarget);
114#endif // wxUSE_DRAG_AND_DROP && wxUSE_RICHEDIT
e702ff0f 115
b2d5a7ee
VZ
116 virtual void SetWindowStyleFlag(long style);
117
bfc6fde4
VZ
118 virtual void Command(wxCommandEvent& event);
119 virtual bool MSWCommand(WXUINT param, WXWORD id);
2bae4332 120 virtual WXHBRUSH MSWControlColor(WXHDC hDC, WXHWND hWnd);
f6bcfd97 121
396bdd5a 122#if wxUSE_RICHEDIT
c57e3339
VZ
123 virtual bool MSWOnNotify(int idCtrl, WXLPARAM lParam, WXLPARAM *result);
124
aac7e7fe
VZ
125 int GetRichVersion() const { return m_verRichEdit; }
126 bool IsRich() const { return m_verRichEdit != 0; }
f6bcfd97
BP
127
128 // rich edit controls are not compatible with normal ones and wem ust set
129 // the colours for them otherwise
130 virtual bool SetBackgroundColour(const wxColour& colour);
131 virtual bool SetForegroundColour(const wxColour& colour);
715ce94d
JS
132#else
133 bool IsRich() const { return false; }
a1b82138 134#endif // wxUSE_RICHEDIT
396bdd5a 135
8ef51d67
JS
136#if wxUSE_INKEDIT && wxUSE_RICHEDIT
137 bool IsInkEdit() const { return m_isInkEdit != 0; }
138#else
139 bool IsInkEdit() const { return false; }
140#endif
141
bfc6fde4 142 virtual void AdoptAttributesFromHWND();
5fb9fcfc 143
fa2f57be 144 virtual bool AcceptsFocusFromKeyboard() const;
c50f1fb9 145
a047aff2
JS
146 // returns true if the platform should explicitly apply a theme border
147 virtual bool CanApplyThemeBorder() const;
148
4438caf4 149 // callbacks
4438caf4
VZ
150 void OnDropFiles(wxDropFilesEvent& event);
151 void OnChar(wxKeyEvent& event); // Process 'enter' if required
152
153 void OnCut(wxCommandEvent& event);
154 void OnCopy(wxCommandEvent& event);
155 void OnPaste(wxCommandEvent& event);
156 void OnUndo(wxCommandEvent& event);
157 void OnRedo(wxCommandEvent& event);
2b5f62a0
VZ
158 void OnDelete(wxCommandEvent& event);
159 void OnSelectAll(wxCommandEvent& event);
4438caf4
VZ
160
161 void OnUpdateCut(wxUpdateUIEvent& event);
162 void OnUpdateCopy(wxUpdateUIEvent& event);
163 void OnUpdatePaste(wxUpdateUIEvent& event);
164 void OnUpdateUndo(wxUpdateUIEvent& event);
165 void OnUpdateRedo(wxUpdateUIEvent& event);
2b5f62a0
VZ
166 void OnUpdateDelete(wxUpdateUIEvent& event);
167 void OnUpdateSelectAll(wxUpdateUIEvent& event);
168
169 // Show a context menu for Rich Edit controls (the standard
170 // EDIT control has one already)
26f60eb6 171 void OnContextMenu(wxContextMenuEvent& event);
4438caf4 172
e3a6a6b2
VZ
173 // be sure the caret remains invisible if the user
174 // called HideNativeCaret() before
175 void OnSetFocus(wxFocusEvent& event);
176
6f02a879
VZ
177 // intercept WM_GETDLGCODE
178 virtual WXLRESULT MSWWindowProc(WXUINT nMsg, WXWPARAM wParam, WXLPARAM lParam);
179
180 virtual bool MSWShouldPreProcessMessage(WXMSG* pMsg);
181 virtual WXDWORD MSWGetStyle(long style, WXDWORD *exstyle) const;
182 virtual wxVisualAttributes GetDefaultAttributes() const;
183
2bda0e17 184protected:
aac7e7fe
VZ
185 // common part of all ctors
186 void Init();
187
3c75d8ba
PC
188 virtual bool DoLoadFile(const wxString& file, int fileType);
189
9b99c1e3
VZ
190 // creates the control of appropriate class (plain or rich edit) with the
191 // styles corresponding to m_windowStyle
192 //
193 // this is used by ctor/Create() and when we need to recreate the control
194 // later
195 bool MSWCreateText(const wxString& value,
196 const wxPoint& pos,
197 const wxSize& size);
198
ee2ec18e 199 virtual void DoSetValue(const wxString &value, int flags = 0);
f6519b40 200
4fa80851
VZ
201 // return true if this control has a user-set limit on amount of text (i.e.
202 // the limit is due to a previous call to SetMaxLength() and not built in)
203 bool HasSpaceLimit(unsigned int *len) const;
204
789295bf
VZ
205 // call this to increase the size limit (will do nothing if the current
206 // limit is big enough)
d7eee191
VZ
207 //
208 // returns true if we increased the limit to allow entering more text,
209 // false if we hit the limit set by SetMaxLength() and so didn't change it
210 bool AdjustSpaceLimit();
789295bf 211
7411f983 212#if wxUSE_RICHEDIT && (!wxUSE_UNICODE || wxUSE_UNICODE_MSLU)
79d26b32
VZ
213 // replace the selection or the entire control contents with the given text
214 // in the specified encoding
7411f983
VZ
215 bool StreamIn(const wxString& value, wxFontEncoding encoding, bool selOnly);
216
217 // get the contents of the control out as text in the given encoding
218 wxString StreamOut(wxFontEncoding encoding, bool selOnly = false) const;
aac7e7fe
VZ
219#endif // wxUSE_RICHEDIT
220
79d26b32
VZ
221 // replace the contents of the selection or of the entire control with the
222 // given text
dd1c1631
VZ
223 void DoWriteText(const wxString& text,
224 int flags = SetValue_SendEvent | SetValue_SelectionOnly);
79d26b32 225
fa2f57be
VZ
226 // set the selection (possibly without scrolling the caret into view)
227 void DoSetSelection(long from, long to, int flags);
aac7e7fe 228
a5aa8086
VZ
229 // get the length of the line containing the character at the given
230 // position
231 long GetLengthOfLineContainingPos(long pos) const;
232
bfbb0b4c 233 // send TEXT_UPDATED event, return true if it was handled, false otherwise
5036ea90
VZ
234 bool SendUpdateEvent();
235
f68586e5 236 virtual wxSize DoGetBestSize() const;
bfc6fde4 237
d7eee191 238#if wxUSE_RICHEDIT
aac7e7fe
VZ
239 // we're using RICHEDIT (and not simple EDIT) control if this field is not
240 // 0, it also gives the version of the RICHEDIT control being used (1, 2 or
241 // 3 so far)
242 int m_verRichEdit;
2b5f62a0 243#endif // wxUSE_RICHEDIT
5036ea90 244
2c62dd25
VZ
245 // number of EN_UPDATE events sent by Windows when we change the controls
246 // text ourselves: we want this to be exactly 1
247 int m_updatesCount;
d7eee191 248
3c75d8ba 249private:
fa2f57be
VZ
250 virtual void EnableTextChangedEvents(bool enable)
251 {
252 m_updatesCount = enable ? -1 : -2;
253 }
254
3c75d8ba
PC
255 // implement wxTextEntry pure virtual: it implements all the operations for
256 // the simple EDIT controls
257 virtual WXHWND GetEditHWND() const { return m_hWnd; }
258
e2cf30aa
VS
259 void OnKeyDown(wxKeyEvent& event);
260
bfc6fde4 261 DECLARE_EVENT_TABLE()
fc7a2a60 262 DECLARE_DYNAMIC_CLASS_NO_COPY(wxTextCtrl)
2b5f62a0
VZ
263
264 wxMenu* m_privateContextMenu;
e3a6a6b2
VZ
265
266 bool m_isNativeCaretShown;
8ef51d67
JS
267
268#if wxUSE_INKEDIT && wxUSE_RICHEDIT
269 int m_isInkEdit;
270#endif
271
2bda0e17
KB
272};
273
fa2f57be 274#endif // _WX_TEXTCTRL_H_