1 /////////////////////////////////////////////////////////////////////////////
3 // Purpose: wxTextCtrl class
4 // Author: Stefan Csomor
8 // Copyright: (c) Stefan Csomor
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
12 #ifndef _WX_TEXTCTRL_H_
13 #define _WX_TEXTCTRL_H_
15 #if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
16 #pragma interface "textctrl.h"
19 #include "wx/control.h"
21 WXDLLEXPORT_DATA(extern const wxChar
*) wxTextCtrlNameStr
;
23 // Single-line text item
24 class WXDLLEXPORT wxTextCtrl
: public wxTextCtrlBase
26 DECLARE_DYNAMIC_CLASS(wxTextCtrl
)
31 wxTextCtrl() { Init(); }
33 wxTextCtrl(wxWindow
*parent
, wxWindowID id
,
34 const wxString
& value
= wxEmptyString
,
35 const wxPoint
& pos
= wxDefaultPosition
,
36 const wxSize
& size
= wxDefaultSize
, long style
= 0,
37 const wxValidator
& validator
= wxDefaultValidator
,
38 const wxString
& name
= wxTextCtrlNameStr
)
42 Create(parent
, id
, value
, pos
, size
, style
, validator
, name
);
45 bool Create(wxWindow
*parent
, wxWindowID id
,
46 const wxString
& value
= wxEmptyString
,
47 const wxPoint
& pos
= wxDefaultPosition
,
48 const wxSize
& size
= wxDefaultSize
, long style
= 0,
49 const wxValidator
& validator
= wxDefaultValidator
,
50 const wxString
& name
= wxTextCtrlNameStr
);
54 virtual wxString
GetValue() const ;
55 virtual void SetValue(const wxString
& value
);
57 virtual int GetLineLength(long lineNo
) const;
58 virtual wxString
GetLineText(long lineNo
) const;
59 virtual int GetNumberOfLines() const;
61 virtual bool IsModified() const;
62 virtual bool IsEditable() const;
64 // If the return values from and to are the same, there is no selection.
65 virtual void GetSelection(long* from
, long* to
) const;
73 virtual void Replace(long from
, long to
, const wxString
& value
);
74 virtual void Remove(long from
, long to
);
76 // load the controls contents from the file
77 virtual bool LoadFile(const wxString
& file
);
79 // sets/clears the dirty flag
80 virtual void MarkDirty();
81 virtual void DiscardEdits();
83 // set the max number of characters which may be entered in a single line
85 virtual void SetMaxLength(unsigned long len
) ;
87 // text control under some platforms supports the text styles: these
88 // methods allow to apply the given text style to the given selection or to
89 // set/get the style which will be used for all appended text
90 virtual bool SetStyle(long start
, long end
, const wxTextAttr
& style
);
91 virtual bool SetDefaultStyle(const wxTextAttr
& style
);
93 // writing text inserts it at the current position, appending always
94 // inserts it at the end
95 virtual void WriteText(const wxString
& text
);
96 virtual void AppendText(const wxString
& text
);
98 // translate between the position (which is just an index in the text ctrl
99 // considering all its contents as a single strings) and (x, y) coordinates
100 // which represent column and line.
101 virtual long XYToPosition(long x
, long y
) const;
102 virtual bool PositionToXY(long pos
, long *x
, long *y
) const;
104 virtual void ShowPosition(long pos
);
106 // Clipboard operations
109 virtual void Paste();
111 virtual bool CanCopy() const;
112 virtual bool CanCut() const;
113 virtual bool CanPaste() const;
119 virtual bool CanUndo() const;
120 virtual bool CanRedo() const;
123 virtual void SetInsertionPoint(long pos
);
124 virtual void SetInsertionPointEnd();
125 virtual long GetInsertionPoint() const;
126 virtual wxTextPos
GetLastPosition() const;
128 virtual void SetSelection(long from
, long to
);
129 virtual void SetEditable(bool editable
);
131 // Implementation from now on
132 // --------------------------
136 virtual void Command(wxCommandEvent
& event
);
138 virtual bool AcceptsFocus() const;
141 void OnDropFiles(wxDropFilesEvent
& event
);
142 void OnChar(wxKeyEvent
& event
); // Process 'enter' if required
144 void OnCut(wxCommandEvent
& event
);
145 void OnCopy(wxCommandEvent
& event
);
146 void OnPaste(wxCommandEvent
& event
);
147 void OnUndo(wxCommandEvent
& event
);
148 void OnRedo(wxCommandEvent
& event
);
150 void OnUpdateCut(wxUpdateUIEvent
& event
);
151 void OnUpdateCopy(wxUpdateUIEvent
& event
);
152 void OnUpdatePaste(wxUpdateUIEvent
& event
);
153 void OnUpdateUndo(wxUpdateUIEvent
& event
);
154 void OnUpdateRedo(wxUpdateUIEvent
& event
);
156 virtual bool MacCanFocus() const { return true ; }
157 virtual bool MacSetupCursor( const wxPoint
& pt
) ;
159 virtual void MacSuperShown( bool show
) ;
160 virtual bool Show(bool show
= true) ;
163 // common part of all ctors
166 virtual wxSize
DoGetBestSize() const;
170 // flag is set to true when the user edits the controls contents
173 // one of the following objects is used for representation, the other one is NULL
178 unsigned long m_maxLength
;
180 DECLARE_EVENT_TABLE()