]> git.saurik.com Git - wxWidgets.git/blobdiff - user/wxLayout/wxlwindow.h
repositioning the cursor with mouse clicks works
[wxWidgets.git] / user / wxLayout / wxlwindow.h
index c1cd8aef6be70de4914cd0f7c9e4dacbdaeb849c..f943c107736509766065f1e52b944aa95b4c8dff 100644 (file)
@@ -1,7 +1,7 @@
 /*-*- c++ -*-********************************************************
  * wxLwindow.h : a scrolled Window for displaying/entering rich text*
  *                                                                  *
- * (C) 1998 by Karsten Ballüder (Ballueder@usa.net)                 *
+ * (C) 1998,1999 by Karsten Ballüder (Ballueder@usa.net)            *
  *                                                                  *
  * $Id$
  *******************************************************************/
 #  include   <wx/wx.h>
 #endif
 
-#include   "wxllist.h"
+#include "wxllist.h"
+
+#ifndef WXLOWIN_MENU_FIRST
+#   define WXLOWIN_MENU_FIRST 12000
+#endif
+
+
+#define wxUSE_PRIVATE_CLIPBOARD_FORMAT 1
 
 enum
 {
-   WXLOWIN_MENU_LARGER = 12000,
+   WXLOWIN_MENU_LARGER = WXLOWIN_MENU_FIRST,
    WXLOWIN_MENU_SMALLER,
-   WXLOWIN_MENU_UNDERLINE,
-   WXLOWIN_MENU_BOLD,
-   WXLOWIN_MENU_ITALICS,
+   WXLOWIN_MENU_UNDERLINE_ON,
+   WXLOWIN_MENU_UNDERLINE_OFF,
+   WXLOWIN_MENU_BOLD_ON,
+   WXLOWIN_MENU_BOLD_OFF,
+   WXLOWIN_MENU_ITALICS_ON,
+   WXLOWIN_MENU_ITALICS_OFF,
    WXLOWIN_MENU_ROMAN,
    WXLOWIN_MENU_TYPEWRITER,
    WXLOWIN_MENU_SANSSERIF,
    WXLOWIN_MENU_RCLICK,
    WXLOWIN_MENU_LCLICK,
-   WXLOWIN_MENU_DBLCLICK
-   
+   WXLOWIN_MENU_DBLCLICK,
+   WXLOWIN_MENU_MOUSEMOVE,
+   WXLOWIN_MENU_LAST = WXLOWIN_MENU_MOUSEMOVE
 };
 
+/**
+   This class is a rich text editing widget.
+*/
 class wxLayoutWindow : public wxScrolledWindow
 {
 public:
@@ -42,84 +56,177 @@ public:
    */
    wxLayoutWindow(wxWindow *parent);
 
-   /* Returns a reference to the wxLayoutList object.
-      @return the list
+   /// Destructor.
+   virtual ~wxLayoutWindow();
+
+   /**@name Editing functionality */
+   //@{
+   /// Clears the window and sets default parameters.
+   void Clear(int family = wxROMAN,
+              int size=12,
+              int style=wxNORMAL,
+              int weight=wxNORMAL,
+              int underline=0,
+              wxColour *fg=NULL,
+              wxColour *bg=NULL);
+   /** Sets a background image, only used on screen, not on printouts.
+       @param bitmap a pointer to a wxBitmap or NULL to remove it
    */
-   wxLayoutList & GetLayoutList(void) { return m_llist; }
-
-   // clears the window and sets default parameters:
-   void Clear(int family = wxROMAN, int size=12, int style=wxNORMAL, int weight=wxNORMAL,
-              int underline=0, char const *fg="black", char const
-              *bg="white")
+   void SetBackgroundBitmap(wxBitmap *bitmap = NULL)
       {
-         GetLayoutList().Clear(family,size,style,weight,underline,fg,bg);
-         SetBackgroundColour( *GetLayoutList().GetDefaults()->GetBGColour());
-
-         m_bDirty = FALSE;
+         if(m_BGbitmap) delete m_BGbitmap;
+         m_BGbitmap = bitmap;
       }
-
-   // callbacks
-   // NB: these functions are used as event handlers and must not be virtual
-   void OnPaint(wxPaintEvent &event);
+   /// Enable or disable editing, i.e. processing of keystrokes.
+   void SetEditable(bool toggle) { m_Editable = toggle; }
+   /// Query whether list can be edited by user.
+   bool IsEditable(void) const { return m_Editable; }
+   /** Sets cursor visibility, visible=1, invisible=0,
+       visible-on-demand=-1, to hide it until moved.
+       @param visibility -1,0 or 1
+       @return the old visibility
+   */
+   inline int SetCursorVisibility(int visibility = -1)
+      { int v =m_CursorVisibility;
+      m_CursorVisibility = visibility; return v;}
    
-   void OnLeftMouseClick(wxMouseEvent& event)
-      { OnMouse(WXLOWIN_MENU_LCLICK, event); }
-   void OnRightMouseClick(wxMouseEvent& event)
-      { OnMouse(WXLOWIN_MENU_RCLICK, event); }
-   void OnMouseDblClick(wxMouseEvent& event)
-      { OnMouse(WXLOWIN_MENU_DBLCLICK, event); }
-
-   void OnChar(wxKeyEvent& event);
-   void OnMenu(wxCommandEvent& event);
+   /// Pastes text from clipboard.
+   void Paste(void);
+   /** Copies selection to clipboard.
+       @param invalidate used internally, see wxllist.h for details
+   */
+   bool Copy(bool invalidate = true);
+   /// Copies selection to clipboard and deletes it.
+   bool Cut(void);
+   //@}
 
+   bool Find(const wxString &needle,
+             wxPoint * fromWhere = NULL);
+   
    void EnablePopup(bool enable = true) { m_DoPopupMenu = enable; }
-   /// gets called by either Update() or OnPaint()
-   void DoPaint(wxDC &dc);
 
-#ifdef __WXMSW__
-   virtual long MSWGetDlgCode();
-#endif //MSW
+   /** Sets the wrap margin.
+       @param margin set this to 0 to disable it
+   */
+   void SetWrapMargin(CoordType margin) { m_WrapMargin = margin; }
+   
+   /** Redraws the window.
+       Internally, this stores the parameter and calls a refresh on
+       wxMSW, draws directly on wxGTK.
+   */
+   void DoPaint(const wxRect *updateRect = NULL);
 
-   void UpdateScrollbars(void);
-   void Print(void);
-   wxMenu * wxLayoutWindow::MakeFormatMenu(void);
+   /// if exact == false, assume 50% extra size for the future
+   void ResizeScrollbars(bool exact = false);  // don't change this to true!
 
    /// if the flag is true, we send events when user clicks on embedded objects
    inline void SetMouseTracking(bool doIt = true) { m_doSendEvents = doIt; }
 
-   virtual ~wxLayoutWindow() { if(m_PopupMenu) delete m_PopupMenu; }
-
-   // dirty flag access
-   bool IsDirty() const { return m_llist.IsDirty(); }
-   void ResetDirty()    { m_llist.ResetDirty();     }
+   /* Returns a pointer to the wxLayoutList object.
+      @return the list
+   */
+   wxLayoutList * GetLayoutList(void) { return m_llist; }
 
-protected:
+   /**@name Callbacks */
+   //@{
+   void OnPaint(wxPaintEvent &event);
+   void OnChar(wxKeyEvent& event);
+   void OnKeyUp(wxKeyEvent& event);
+   void OnMenu(wxCommandEvent& event);
+   void OnLeftMouseClick(wxMouseEvent& event)  { OnMouse(WXLOWIN_MENU_LCLICK, event); }
+   void OnRightMouseClick(wxMouseEvent& event) { OnMouse(WXLOWIN_MENU_RCLICK, event); }
+   void OnMouseDblClick(wxMouseEvent& event)   { OnMouse(WXLOWIN_MENU_DBLCLICK, event); }
+   void OnMouseMove(wxMouseEvent &event)       { OnMouse(WXLOWIN_MENU_MOUSEMOVE, event) ; }
+   void OnSetFocus(wxFocusEvent &ev);
+   void OnKillFocus(wxFocusEvent &ev);
+   //@}
+
+   /// Creates a wxMenu for use as a format popup.
+   static wxMenu * MakeFormatMenu(void);
+   /**@name Dirty flag handling for optimisations. */
+   //@{
+   /// Set dirty flag.
+   void SetDirty(void) { m_Dirty = true; }
+   /// Query whether window needs redrawing.
+   bool IsDirty(void) const { return m_Dirty; }
+   /// Reset dirty flag.
+   void ResetDirty(void) { m_Dirty = false; }
+   //@}
+   /// Redraws the window, used by DoPaint() or OnPaint().
+   void InternalPaint(const wxRect *updateRect);
+
+   /// Has list been modified/edited?
+   bool IsModified(void) const { return m_Modified; }
+   /// Mark list as modified or unchanged.
+   void SetModified(bool modified = true) { m_Modified = modified; }
+   /** Tell window to update a wxStatusBar with UserData labels and
+       cursor positions.
+       @param bar wxStatusBar pointer
+       @param labelfield field to use in statusbar for URLs/userdata labels, or -1 to disable
+       @param cursorfield field to use for cursor position, or -1 to disable
+   */
+   void SetStatusBar(class wxStatusBar *bar,
+                       int labelfield = -1,
+                       int cursorfield = -1)
+      {
+         m_StatusBar = bar; m_StatusFieldLabel = labelfield;
+         m_StatusFieldCursor = cursorfield;
+      }
+protected:   
    /// generic function for mouse events processing
    void OnMouse(int eventId, wxMouseEvent& event);
-
-   /// repaint if needed
-   void Update(void);
-
+   /// as the name says
+   void ScrollToCursor(void);
    /// for sending events
    wxWindow *m_Parent;
+   /// Shall we send events?
    bool m_doSendEvents;
-
-   /// the layout list to be displayed
-   wxLayoutList m_llist;
-
-   /// have we already set the scrollbars?
-   bool m_ScrollbarsSet;
    /// Where does the current view start?
    int m_ViewStartX; int m_ViewStartY;
-   
-   /// do we have unsaved data?
-   bool m_bDirty;
-
+   /// Do we currently have the focus?
+   bool m_HaveFocus;
    /// do we handle clicks of the right mouse button?
    bool m_DoPopupMenu;
+   /// Should InternalPaint() scroll to cursor (VZ: seems unused any more)
+   bool m_ScrollToCursor;
+   /// Do we currently have a non-standard cursor?
+   bool m_HandCursor;
    /// the menu
    wxMenu * m_PopupMenu;
+   /// for derived classes, set when mouse is clicked
+   wxPoint m_ClickPosition;
+   /// for scrollbar calculations:
+   int m_maxx;
+   int m_maxy;
+   int m_lineHeight;
+   /** Visibility parameter for cursor. 0/1 as expected, -1: visible
+       on demand.
+   */
+   int m_CursorVisibility;
 private:
+   /// The layout list to be displayed.
+   wxLayoutList *m_llist;
+   /// Can user edit the window?
+   bool m_Editable;
+   /// Are we currently building a selection with the keyboard?
+   bool m_Selecting;
+   /// wrap margin
+   CoordType    m_WrapMargin;
+   /// Is list dirty (for redraws, internal use)?
+   bool         m_Dirty;
+   /// Has list been edited?
+   bool         m_Modified;
+   wxMemoryDC  *m_memDC;
+   wxBitmap    *m_bitmap;
+   wxPoint      m_bitmapSize;
+   /// A frame's statusbar to update
+   class wxStatusBar *m_StatusBar;
+   /// statusbar field for labels
+   int          m_StatusFieldLabel;
+   /// statusbar field for cursor positions
+   int          m_StatusFieldCursor;
+   /// a pointer to a bitmap for the background
+   wxBitmap    *m_BGbitmap;
    DECLARE_EVENT_TABLE()
 };