include/wx/caret.h

   1 ///////////////////////////////////////////////////////////////////////////////
   2 // Name:        caret.h
   3 // Purpose:     wxCaretBase class - the interface of wxCaret
   4 // Author:      Vadim Zeitlin
   5 // Modified by:
   6 // Created:     23.05.99
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) wxWindows team
   9 // Licence:     wxWindows licence
  10 ///////////////////////////////////////////////////////////////////////////////
  11
  12 #ifndef _WX_CARET_H_BASE_
  13 #define _WX_CARET_H_BASE_
  14
  15 #ifdef __GNUG__
  16 #pragma interface "caret.h"
  17 #endif
  18
  19 // ---------------------------------------------------------------------------
  20 // forward declarations
  21 // ---------------------------------------------------------------------------
  22
  23 class WXDLLEXPORT wxWindow;
  24 class WXDLLEXPORT wxWindowBase;
  25
  26 // ----------------------------------------------------------------------------
  27 // headers we have to include
  28 // ----------------------------------------------------------------------------
  29
  30 #include "wx/gdicmn.h"  // for wxPoint, wxSize
  31
  32 // ----------------------------------------------------------------------------
  33 // A caret is a blinking cursor showing the position where the typed text will
  34 // appear. It can be either a solid block or a custom bitmap (TODO)
  35 // ----------------------------------------------------------------------------
  36
  37 class WXDLLEXPORT wxCaretBase
  38 {
  39 public:
  40     // ctors
  41     // -----
  42         // default - use Create
  43     wxCaretBase() { Init(); }
  44         // create the caret of given (in pixels) width and height and associate
  45         // with the given window
  46     wxCaretBase(wxWindowBase *window, int width, int height)
  47     {
  48         Init();
  49
  50         (void)Create(window, width, height);
  51     }
  52         // same as above
  53     wxCaretBase(wxWindowBase *window, const wxSize& size)
  54     {
  55         Init();
  56
  57         (void)Create(window, size);
  58     }
  59
  60     // Create() functions - same as ctor but returns the success code
  61     // --------------------------------------------------------------
  62
  63         // same as ctor
  64     bool Create(wxWindowBase *window, int width, int height)
  65         { return DoCreate(window, width, height); }
  66         // same as ctor
  67     bool Create(wxWindowBase *window, const wxSize& size)
  68         { return DoCreate(window, size.x, size.y); }
  69
  70     // accessors
  71     // ---------
  72
  73         // is the caret valid?
  74     bool IsOk() const { return m_width != 0 && m_height != 0; }
  75
  76         // is the caret currently shown?
  77     bool IsVisible() const { return m_countVisible > 0; }
  78
  79         // get the caret position
  80     void GetPosition(int *x, int *y) const
  81     {
  82         if ( x ) *x = m_x;
  83         if ( y ) *y = m_y;
  84     }
  85     wxPoint GetPosition() const { return wxPoint(m_x, m_y); }
  86
  87         // get the caret size
  88     void GetSize(int *width, int *height) const
  89     {
  90         if ( width ) *width = m_width;
  91         if ( height ) *height = m_height;
  92     }
  93     wxSize GetSize() const { return wxSize(m_width, m_height); }
  94
  95         // get the window we're associated with
  96     wxWindow *GetWindow() const { return (wxWindow *)m_window; }
  97
  98     // operations
  99     // ----------
 100
 101         // move the caret to given position (in logical coords)
 102     void Move(int x, int y) { m_x = x; m_y = y; DoMove(); }
 103     void Move(const wxPoint& pt) { m_x = pt.x; m_y = pt.y; DoMove(); }
 104
 105         // show/hide the caret (should be called by wxWindow when needed):
 106         // Show() must be called as many times as Hide() + 1 to make the caret
 107         // visible
 108     virtual void Show(bool show = TRUE)
 109         {
 110             if ( show )
 111             {
 112                 if ( m_countVisible++ == 0 )
 113                     DoShow();
 114             }
 115             else
 116             {
 117                 if ( --m_countVisible == 0 )
 118                     DoHide();
 119             }
 120         }
 121     virtual void Hide() { Show(FALSE); }
 122
 123         // blink time is measured in milliseconds and is the time elapsed
 124         // between 2 inversions of the caret (blink time of the caret is common
 125         // to all carets in the Universe, so these functions are static)
 126     static int GetBlinkTime();
 127     static void SetBlinkTime(int milliseconds);
 128
 129     // implementation from now on
 130     // --------------------------
 131
 132     // these functions should be called by wxWindow when the window gets/loses
 133     // the focus - we create/show and hide/destroy the caret here
 134     virtual void OnSetFocus() { }
 135     virtual void OnKillFocus() { }
 136
 137 protected:
 138     // these functions may be overriden in the derived classes, but they
 139     // should call the base class version first
 140     virtual bool DoCreate(wxWindowBase *window, int width, int height)
 141     {
 142         m_window = window;
 143         m_width = width;
 144         m_height = height;
 145
 146         return TRUE;
 147     }
 148
 149     // pure virtuals to implement in the derived class
 150     virtual void DoShow() = 0;
 151     virtual void DoHide() = 0;
 152     virtual void DoMove() = 0;
 153
 154     // the common initialization
 155     void Init()
 156     {
 157         m_window = (wxWindowBase *)NULL;
 158         m_x = m_y = 0;
 159         m_width = m_height = 0;
 160         m_countVisible = 0;
 161     }
 162
 163     // the size of the caret
 164     int m_width, m_height;
 165
 166     // the position of the caret
 167     int m_x, m_y;
 168
 169     // the window we're associated with
 170     wxWindowBase *m_window;
 171
 172     // visibility count: the caret is visible only if it's positive
 173     int m_countVisible;
 174
 175 private:
 176     DECLARE_NO_COPY_CLASS(wxCaretBase);
 177 };
 178
 179 // ---------------------------------------------------------------------------
 180 // now include the real thing
 181 // ---------------------------------------------------------------------------
 182
 183 #if defined(__WXMSW__)
 184     #include "wx/msw/caret.h"
 185 #else
 186     #include "wx/generic/caret.h"
 187 #endif // platform
 188
 189 #endif // _WX_CARET_H_BASE_
 190