include/wx/x11/textctrl.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        textctrl.h
   3 // Purpose:
   4 // Author:      Robert Roebling
   5 // Created:     01/02/97
   6 // Id:          $Id$
   7 // Copyright:   (c) 1998 Robert Roebling
   8 // Licence:     wxWindows licence
   9 /////////////////////////////////////////////////////////////////////////////
  10
  11 #ifndef __X11TEXTCTRLH__
  12 #define __X11TEXTCTRLH__
  13
  14 #ifdef __GNUG__
  15     #pragma interface "textctrl.h"
  16 #endif
  17
  18 #include "wx/scrolwin.h"
  19 #include "wx/dynarray.h"
  20 #include "wx/datetime.h"
  21
  22 //-----------------------------------------------------------------------------
  23 // classes
  24 //-----------------------------------------------------------------------------
  25
  26 class wxTextCtrl;
  27
  28 //-----------------------------------------------------------------------------
  29 // helpers
  30 //-----------------------------------------------------------------------------
  31
  32 enum wxSourceUndo
  33 {
  34     wxSOURCE_UNDO_LINE,
  35     wxSOURCE_UNDO_ENTER,
  36     wxSOURCE_UNDO_BACK,
  37     wxSOURCE_UNDO_INSERT_LINE,
  38     wxSOURCE_UNDO_DELETE,
  39     wxSOURCE_UNDO_PASTE
  40 };
  41
  42 class wxSourceUndoStep: public wxObject
  43 {
  44 public:
  45     wxSourceUndoStep( wxSourceUndo type, int y1, int y2, wxTextCtrl *owner );
  46
  47     void Undo();
  48
  49     wxSourceUndo    m_type;
  50     int             m_y1;
  51     int             m_y2;
  52     int             m_cursorX;
  53     int             m_cursorY;
  54     wxTextCtrl     *m_owner;
  55     wxString        m_text;
  56     wxArrayString   m_lines;
  57 };
  58
  59 class wxSourceLine
  60 {
  61 public:
  62     wxSourceLine( const wxString &text = wxEmptyString )
  63     {
  64         m_text = text;
  65     }
  66
  67     wxString       m_text;
  68 };
  69
  70 WX_DECLARE_OBJARRAY(wxSourceLine, wxSourceLineArray);
  71
  72 enum wxSourceLanguage
  73 {
  74     wxSOURCE_LANG_NONE,
  75     wxSOURCE_LANG_CPP,
  76     wxSOURCE_LANG_PERL,
  77     wxSOURCE_LANG_PYTHON
  78 };
  79
  80 //-----------------------------------------------------------------------------
  81 // wxTextCtrl
  82 //-----------------------------------------------------------------------------
  83
  84 class wxTextCtrl: public wxTextCtrlBase, public wxScrollHelper
  85 {
  86 public:
  87     wxTextCtrl() { Init(); }
  88     wxTextCtrl(wxWindow *parent,
  89                wxWindowID id,
  90                const wxString &value = wxEmptyString,
  91                const wxPoint &pos = wxDefaultPosition,
  92                const wxSize &size = wxDefaultSize,
  93                long style = 0,
  94                const wxValidator& validator = wxDefaultValidator,
  95                const wxString &name = wxTextCtrlNameStr);
  96
  97     bool Create(wxWindow *parent,
  98                 wxWindowID id,
  99                 const wxString &value = wxEmptyString,
 100                 const wxPoint &pos = wxDefaultPosition,
 101                 const wxSize &size = wxDefaultSize,
 102                 long style = 0,
 103                 const wxValidator& validator = wxDefaultValidator,
 104                 const wxString &name = wxTextCtrlNameStr);
 105
 106     // required for scrolling with wxScrollHelper
 107     // ------------------------------------------
 108
 109     virtual void PrepareDC(wxDC& dc) { DoPrepareDC(dc); }
 110
 111     // implement base class pure virtuals
 112     // ----------------------------------
 113
 114     virtual wxString GetValue() const;
 115     virtual void SetValue(const wxString& value);
 116
 117     virtual int GetLineLength(long lineNo) const;
 118     virtual wxString GetLineText(long lineNo) const;
 119     virtual int GetNumberOfLines() const;
 120
 121     virtual bool IsModified() const;
 122     virtual bool IsEditable() const;
 123
 124     // more readable flag testing methods
 125     // ----------------------------------
 126
 127     bool IsSingleLine() const { return !(GetWindowStyle() & wxTE_MULTILINE); }
 128     bool IsPassword() const { return (GetWindowStyle() & wxTE_PASSWORD) != 0; }
 129     bool WrapLines() const { return FALSE; }
 130
 131     // If the return values from and to are the same, there is no selection.
 132     virtual void GetSelection(long* from, long* to) const;
 133
 134     // operations
 135     // ----------
 136
 137     // editing
 138     virtual void Clear();
 139     virtual void Replace(long from, long to, const wxString& value);
 140     virtual void Remove(long from, long to);
 141
 142     // clears the dirty flag
 143     virtual void DiscardEdits();
 144
 145     virtual void SetMaxLength(unsigned long len);
 146
 147     // writing text inserts it at the current position, appending always
 148     // inserts it at the end
 149     virtual void WriteText(const wxString& text);
 150     virtual void AppendText(const wxString& text);
 151
 152     // apply text attribute to the range of text (only works with richedit
 153     // controls)
 154     virtual bool SetStyle(long start, long end, const wxTextAttr& style);
 155
 156     // translate between the position (which is just an index in the text ctrl
 157     // considering all its contents as a single strings) and (x, y) coordinates
 158     // which represent column and line.
 159     virtual long XYToPosition(long x, long y) const;
 160     virtual bool PositionToXY(long pos, long *x, long *y) const;
 161
 162     virtual void ShowPosition(long pos);
 163
 164     // Clipboard operations
 165     virtual void Copy();
 166     virtual void Cut();
 167     virtual void Paste();
 168
 169     // Undo/redo
 170     virtual void Undo();
 171     virtual void Redo() {}
 172
 173     virtual bool CanUndo() const    { return (m_undos.GetCount() > 0); }
 174     virtual bool CanRedo() const    { return FALSE; }
 175
 176     // Insertion point
 177     virtual void SetInsertionPoint(long pos);
 178     virtual void SetInsertionPointEnd();
 179     virtual long GetInsertionPoint() const;
 180     virtual long GetLastPosition() const;
 181
 182     virtual void SetSelection(long from, long to);
 183     virtual void SetEditable(bool editable);
 184
 185     virtual bool Enable( bool enable );
 186
 187     void OnCut(wxCommandEvent& event);
 188     void OnCopy(wxCommandEvent& event);
 189     void OnPaste(wxCommandEvent& event);
 190     void OnUndo(wxCommandEvent& event);
 191     void OnRedo(wxCommandEvent& event);
 192
 193     void OnUpdateCut(wxUpdateUIEvent& event);
 194     void OnUpdateCopy(wxUpdateUIEvent& event);
 195     void OnUpdatePaste(wxUpdateUIEvent& event);
 196     void OnUpdateUndo(wxUpdateUIEvent& event);
 197     void OnUpdateRedo(wxUpdateUIEvent& event);
 198
 199     bool SetFont(const wxFont& font);
 200     bool SetForegroundColour(const wxColour& colour);
 201     bool SetBackgroundColour(const wxColour& colour);
 202
 203     void SetModified() { m_modified = TRUE; }
 204
 205     virtual void Freeze();
 206     virtual void Thaw();
 207
 208     // textctrl specific scrolling
 209     virtual bool ScrollLines(int lines);
 210     virtual bool ScrollPages(int pages);
 211
 212     // not part of the wxTextCtrl API from now on..
 213
 214     void Delete();
 215     void DeleteLine();
 216
 217     void Indent();
 218     void Unindent();
 219
 220     bool HasSelection();
 221     void ClearSelection();
 222
 223     int GetCursorX()                        { return m_cursorX; }
 224     int GetCursorY()                        { return m_cursorY; }
 225     bool IsModified()                       { return m_modified; }
 226     bool OverwriteMode()                    { return m_overwrite; }
 227
 228     // implementation from now on...
 229
 230     void SearchForBrackets();
 231
 232     void DoChar( char c );
 233     void DoBack();
 234     void DoDelete();
 235     void DoReturn();
 236     void DoDClick();
 237
 238     wxString GetNextToken( wxString &line, int &pos );
 239     void DrawLine( wxDC &dc, int x, int y, const wxString &line, int lineNum );
 240     void OnPaint( wxPaintEvent &event );
 241     void OnMouse( wxMouseEvent &event );
 242     void OnChar( wxKeyEvent &event );
 243     void OnIdle( wxIdleEvent &event );
 244
 245     void RefreshLine( int n );
 246     void RefreshDown( int n );
 247     void MoveCursor( int new_x, int new_y, bool shift = FALSE, bool centre = FALSE );
 248     void MyAdjustScrollbars();
 249
 250 protected:
 251     // common part of all ctors
 252     void Init();
 253
 254     virtual wxSize DoGetBestSize() const;
 255
 256     friend class wxSourceUndoStep;
 257
 258     wxSourceLineArray  m_lines;
 259
 260     wxFont             m_sourceFont;
 261     wxColour           m_sourceColour;
 262     wxColour           m_commentColour;
 263     wxColour           m_stringColour;
 264
 265     int                m_cursorX;
 266     int                m_cursorY;
 267
 268     int                m_selStartX,m_selStartY;
 269     int                m_selEndX,m_selEndY;
 270
 271     int                m_lineHeight;
 272     int                m_charWidth;
 273
 274     int                m_longestLine;
 275
 276     bool               m_overwrite;
 277     bool               m_modified;
 278     bool               m_editable;
 279     bool               m_ignoreInput;
 280
 281     wxArrayString      m_keywords;
 282     wxColour           m_keywordColour;
 283
 284     wxArrayString      m_defines;
 285     wxColour           m_defineColour;
 286
 287     wxArrayString      m_variables;
 288     wxColour           m_variableColour;
 289
 290     wxSourceLanguage   m_lang;
 291
 292     wxList             m_undos;
 293
 294     bool               m_capturing;
 295
 296     int                m_bracketX;
 297     int                m_bracketY;
 298
 299 private:
 300     DECLARE_EVENT_TABLE()
 301     DECLARE_DYNAMIC_CLASS(wxTextCtrl);
 302 };
 303
 304 //-----------------------------------------------------------------------------
 305 // this is superfluous here but helps to compile
 306 //-----------------------------------------------------------------------------
 307
 308 // cursor movement and also selection and delete operations
 309 #define wxACTION_TEXT_GOTO          _T("goto")  // to pos in numArg
 310 #define wxACTION_TEXT_FIRST         _T("first") // go to pos 0
 311 #define wxACTION_TEXT_LAST          _T("last")  // go to last pos
 312 #define wxACTION_TEXT_HOME          _T("home")
 313 #define wxACTION_TEXT_END           _T("end")
 314 #define wxACTION_TEXT_LEFT          _T("left")
 315 #define wxACTION_TEXT_RIGHT         _T("right")
 316 #define wxACTION_TEXT_UP            _T("up")
 317 #define wxACTION_TEXT_DOWN          _T("down")
 318 #define wxACTION_TEXT_WORD_LEFT     _T("wordleft")
 319 #define wxACTION_TEXT_WORD_RIGHT    _T("wordright")
 320 #define wxACTION_TEXT_PAGE_UP       _T("pageup")
 321 #define wxACTION_TEXT_PAGE_DOWN     _T("pagedown")
 322
 323 // clipboard operations
 324 #define wxACTION_TEXT_COPY          _T("copy")
 325 #define wxACTION_TEXT_CUT           _T("cut")
 326 #define wxACTION_TEXT_PASTE         _T("paste")
 327
 328 // insert text at the cursor position: the text is in strArg of PerformAction
 329 #define wxACTION_TEXT_INSERT        _T("insert")
 330
 331 // if the action starts with either of these prefixes and the rest of the
 332 // string is one of the movement commands, it means to select/delete text from
 333 // the current cursor position to the new one
 334 #define wxACTION_TEXT_PREFIX_SEL    _T("sel")
 335 #define wxACTION_TEXT_PREFIX_DEL    _T("del")
 336
 337 // mouse selection
 338 #define wxACTION_TEXT_ANCHOR_SEL    _T("anchorsel")
 339 #define wxACTION_TEXT_EXTEND_SEL    _T("extendsel")
 340 #define wxACTION_TEXT_SEL_WORD      _T("wordsel")
 341 #define wxACTION_TEXT_SEL_LINE      _T("linesel")
 342
 343 // undo or redo
 344 #define wxACTION_TEXT_UNDO          _T("undo")
 345 #define wxACTION_TEXT_REDO          _T("redo")
 346
 347 // ----------------------------------------------------------------------------
 348 // wxTextCtrl types
 349 // ----------------------------------------------------------------------------
 350
 351 // wxTextPos is the position in the text
 352 typedef long wxTextPos;
 353
 354 // wxTextCoord is the line or row number (which should have been unsigned but
 355 // is long for backwards compatibility)
 356 typedef long wxTextCoord;
 357
 358 class WXDLLEXPORT wxStdTextCtrlInputHandler : public wxStdInputHandler
 359 {
 360 public:
 361     wxStdTextCtrlInputHandler(wxInputHandler *inphand) : wxStdInputHandler(inphand) {}
 362
 363     virtual bool HandleKey(wxInputConsumer *consumer,
 364                            const wxKeyEvent& event,
 365                            bool pressed) { return FALSE; }
 366     virtual bool HandleMouse(wxInputConsumer *consumer, const wxMouseEvent& event) { return FALSE; }
 367     virtual bool HandleMouseMove(wxInputConsumer *consumer, const wxMouseEvent& event) { return FALSE; }
 368     virtual bool HandleFocus(wxInputConsumer *consumer, const wxFocusEvent& event) { return FALSE; }
 369
 370 protected:
 371     // get the position of the mouse click
 372     static wxTextPos HitTest(const wxTextCtrl *text, const wxPoint& pos) { return 0; }
 373
 374     // capture data
 375     wxTextCtrl *m_winCapture;
 376 };
 377
 378 #endif // __GTKTEXTCTRLH__
 379