]> git.lyx.org Git - lyx.git/blobdiff - src/frontends/Painter.h
Move Color::color enum to ColorCode.h
[lyx.git] / src / frontends / Painter.h
index 9dd8731c447ef612082c18dc3ab5425e45723835..9fc31a57e761934d2859b04fb9eee97699b1e7b4 100644 (file)
 #ifndef PAINTER_H
 #define PAINTER_H
 
-#include "LColor.h"
+#include "ColorCode.h"
 
 #include "support/docstring.h"
 
+namespace lyx {
 
-class LyXFont;
+class Font;
 
-namespace lyx {
-namespace graphics {
-       class Image;
-}
+namespace graphics { class Image; }
 
 namespace frontend {
 
@@ -46,9 +44,17 @@ namespace frontend {
  * management.
  *
  * Note that the methods return *this for convenience.
+ *
+ * Caution: All char_type and docstring arguments of the text drawing
+ * methods of this class are no UCS4 chars or strings if the font is a
+ * symbol font. They simply denote the code points of the font instead.
+ * You have to keep this in mind when you implement the methods in a
+ * frontend. You must not pass these parameters to a unicode conversion
+ * function in particular.
  */
 class Painter {
 public:
+       Painter(): drawing_enabled_(true) {}
        /// possible line widths
        enum line_width {
                line_thin, //< thin line
@@ -61,24 +67,21 @@ public:
                line_onoffdash //< dashes with spaces
        };
 
-       virtual ~Painter() {}
-
-       /// begin painting
-       virtual void start() {}
-
-       /// end painting
-       virtual void end() {}
+       /// possible character styles of preedit string.
+       /// This is used for CJK input method support.
+       enum preedit_style {
+               preedit_default, //< when unselecting, no cursor and dashed underline.
+               preedit_selecting, //< when selecting.
+               preedit_cursor //< with cursor.
+       };
 
-       /// return the width of the work area in pixels
-       virtual int paperWidth() const = 0;
-       /// return the height of the work area in pixels
-       virtual int paperHeight() const = 0;
+       virtual ~Painter() {}
 
        /// draw a line from point to point
        virtual void line(
                int x1, int y1,
                int x2, int y2,
-               LColor_color,
+               ColorCode,
                line_style = line_solid,
                line_width = line_thin) = 0;
 
@@ -92,7 +95,7 @@ public:
                int const * xp,
                int const * yp,
                int np,
-               LColor_color,
+               ColorCode,
                line_style = line_solid,
                line_width = line_thin) = 0;
 
@@ -100,7 +103,7 @@ public:
        virtual void rectangle(
                int x, int y,
                int w, int h,
-               LColor_color,
+               ColorCode,
                line_style = line_solid,
                line_width = line_thin) = 0;
 
@@ -108,44 +111,44 @@ public:
        virtual void fillRectangle(
                int x, int y,
                int w, int h,
-               LColor_color) = 0;
+               ColorCode) = 0;
 
        /// draw an arc
        virtual void arc(
                int x, int y,
                unsigned int w, unsigned int h,
                int a1, int a2,
-               LColor_color) = 0;
+               ColorCode) = 0;
 
        /// draw a pixel
        virtual void point(
                int x, int y,
-               LColor_color) = 0;
+               ColorCode) = 0;
 
        /// draw a filled rectangle with the shape of a 3D button
        virtual void button(int x, int y,
-               int w, int h);
+               int w, int h, bool mouseHover);
 
        /// draw an image from the image cache
        virtual void image(int x, int y,
                int w, int h,
-               lyx::graphics::Image const & image) = 0;
+               graphics::Image const & image) = 0;
 
        /// draw a string at position x, y (y is the baseline)
-       virtual void text(int x, int y,
-               lyx::docstring const & str, LyXFont const & f) = 0;
-
        /**
-        * Draw a string at position x, y (y is the baseline)
-        * This is just for fast drawing
-        */
-       virtual void text(int x, int y,
-               lyx::char_type const * str, size_t l,
-               LyXFont const & f) = 0;
+       * \return the width of the drawn text.
+       */
+       virtual int text(int x, int y,
+               docstring const & str, Font const & f) = 0;
+
+       void setDrawingEnabled(bool drawing_enabled = true)
+       { drawing_enabled_ = drawing_enabled; }
 
        /// draw a char at position x, y (y is the baseline)
-       virtual void text(int x, int y,
-                         lyx::char_type c, LyXFont const & f) = 0;
+       /**
+       * \return the width of the drawn text.
+       */
+       virtual int text(int x, int y, char_type c, Font const & f) = 0;
 
        /**
         * Draw a string and enclose it inside a rectangle. If
@@ -153,24 +156,38 @@ public:
         * the given color. If frame is specified, a thin frame is drawn
         * around the text with the given color.
         */
-       virtual void rectText(int x, int baseline,
-               lyx::docstring const & str,
-               LyXFont const & font,
-               LColor_color back,
-               LColor_color frame);
+       void rectText(int x, int baseline,
+               docstring const & str,
+               Font const & font,
+               ColorCode back,
+               ColorCode frame);
 
        /// draw a string and enclose it inside a button frame
-       virtual void buttonText(int x,
-               int baseline, lyx::docstring const & s,
-               LyXFont const & font);
+       void buttonText(int x, int baseline, docstring const & s,
+               Font const & font, bool mouseHover);
+
+       /// draw a character of a preedit string for cjk support.
+       int preeditText(int x, int y,
+               char_type c, Font const & f, preedit_style style);
 
 protected:
        /// check the font, and if set, draw an underline
-       virtual void underline(LyXFont const & f,
+       void underline(Font const & f,
+               int x, int y, int width);
+
+       /// check the font, and if set, draw an dashed underline
+       void dashedUnderline(Font const & f,
                int x, int y, int width);
 
        /// draw a bevelled button border
-       virtual void buttonFrame(int x, int y, int w, int h);
+       void buttonFrame(int x, int y, int w, int h);
+
+       /// Indicate wether real screen drawing shall be done or not.
+       bool isDrawingEnabled() const { return drawing_enabled_; }
+
+private:
+       ///
+       bool drawing_enabled_;
 };
 
 } // namespace frontend