widget.hh

Go to the documentation of this file.

/*
 * Dillo Widget
 *
 * Copyright 2005-2007 Sebastian Geerken <sgeerken@dillo.org>
 * Copyright 2023-2024 Rodrigo Arias Mallo <rodarima@gmail.com>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
 
#ifndef __DW_WIDGET_HH__
#define __DW_WIDGET_HH__
 
#ifndef __INCLUDED_FROM_DW_CORE_HH__
#   error Do not include this file directly, use "core.hh" instead.
#endif
 
#include "../lout/identity.hh"
 
typedef void (*DW_Callback_t)(void *data);
 
namespace dw {
namespace core {
 
class Widget: public lout::identity::IdentifiableObject
{
   friend class Layout;
 
protected:
   enum Flags {
      RESIZE_QUEUED    = 1 << 0,
 
      EXTREMES_QUEUED  = 1 << 1,
 
      NEEDS_RESIZE     = 1 << 2,
 
      NEEDS_ALLOCATE   = 1 << 3,
 
      ALLOCATE_QUEUED  = 1 << 4,
 
      EXTREMES_CHANGED = 1 << 5,
 
      WAS_ALLOCATED    = 1 << 6,
   };
 
   class WidgetImgRenderer: public style::StyleImage::ExternalWidgetImgRenderer
   {
   private:
      Widget *widget;
 
   public:
      inline WidgetImgRenderer (Widget *widget) { this->widget = widget; }
 
      bool readyToDraw ();
      void getBgArea (int *x, int *y, int *width, int *height);
      void getRefArea (int *xRef, int *yRef, int *widthRef, int *heightRef);
      style::Style *getStyle ();
      void draw (int x, int y, int width, int height);
   };
 
   WidgetImgRenderer *widgetImgRenderer;
 
private:
   static bool adjustMinWidth;
 
   Widget *parent;
 
   Widget *quasiParent;
 
   Widget *generator;
 
   Widget *container;
 
   WidgetReference *widgetReference;
   
   style::Style *style;
 
   Flags flags;
 
   Requisition requisition;
   SizeParams requisitionParams;
 
   Extremes extremes;
   SizeParams extremesParams;
 
   style::Color *bgColor;
 
   bool buttonSensitive;
 
   bool buttonSensitiveSet;
 
   void queueResize (int ref, bool extremesChanged, bool fast);
   inline void queueResizeFast (int ref, bool extremesChanged)
   { queueResize (ref, extremesChanged, true); }
 
public:
   int parentRef;
 
protected:
 
   Allocation allocation;
 
   inline int getHeight () { return allocation.ascent + allocation.descent; }
   inline int getContentWidth() { return allocation.width - boxDiffWidth (); }
   inline int getContentHeight() { return getHeight () - boxDiffHeight (); }
 
   float ratio;
 
   Layout *layout;
 
   style::Box extraSpace;
 
   StackingContextMgr *stackingContextMgr;
 
   Widget *stackingContextWidget;
 
   inline StackingContextMgr *getNextStackingContextMgr ()
   { return stackingContextWidget->stackingContextMgr; }
 
   /*inline void printFlags () {
      DBG_IF_RTFL {
         char buf[10 * 3 - 1 + 1];
         snprintf (buf, sizeof (buf), "%s:%s:%s:%s:%s:%s:%s",
                   (flags & RESIZE_QUEUED)    ? "Rq" : "--",
                   (flags & EXTREMES_QUEUED)  ? "Eq" : "--",
                   (flags & NEEDS_RESIZE)     ? "nR" : "--",
                   (flags & NEEDS_ALLOCATE)   ? "nA" : "--",
                   (flags & ALLOCATE_QUEUED)  ? "Aq" : "--",
                   (flags & EXTREMES_CHANGED) ? "Ec" : "--",
                   (flags & WAS_ALLOCATED)    ? "wA" : "--");
         DBG_OBJ_SET_SYM ("flags", buf);
      }
   }*/
 
   inline void printFlag (Flags f) {
      DBG_IF_RTFL {
         switch (f) {
         case RESIZE_QUEUED:
               DBG_OBJ_SET_SYM ("flags.RESIZE_QUEUED",
                                (flags & RESIZE_QUEUED) ? "true" : "false");
               break;
 
         case EXTREMES_QUEUED:
            DBG_OBJ_SET_SYM ("flags.EXTREMES_QUEUED",
                             (flags & EXTREMES_QUEUED) ? "true" : "false");
            break;
 
         case NEEDS_RESIZE:
            DBG_OBJ_SET_SYM ("flags.NEEDS_RESIZE",
                             (flags & NEEDS_RESIZE) ? "true" : "false");
            break;
 
         case NEEDS_ALLOCATE:
            DBG_OBJ_SET_SYM ("flags.NEEDS_ALLOCATE",
                             (flags & NEEDS_ALLOCATE) ? "true" : "false");
            break;
 
         case ALLOCATE_QUEUED:
            DBG_OBJ_SET_SYM ("flags.ALLOCATE_QUEUED",
                             (flags & ALLOCATE_QUEUED) ? "true" : "false");
            break;
 
         case EXTREMES_CHANGED:
            DBG_OBJ_SET_SYM ("flags.EXTREMES_CHANGED",
                             (flags & EXTREMES_CHANGED) ? "true" : "false");
            break;
 
         case WAS_ALLOCATED:
            DBG_OBJ_SET_SYM ("flags.WAS_ALLOCATED",
                             (flags & WAS_ALLOCATED) ? "true" : "false");
            break;
         }
      }
   }
 
   inline void setFlags (Flags f)
   { flags = (Flags)(flags | f); printFlag (f); }
   inline void unsetFlags (Flags f)
   { flags = (Flags)(flags & ~f); printFlag (f); }
 
   inline void queueDraw ()
   { queueDrawArea (0, 0, allocation.width, getHeight()); }
   void queueDrawArea (int x, int y, int width, int height);
   inline void queueResize (int ref, bool extremesChanged)
   { queueResize (ref, extremesChanged, false); }
 
   virtual void sizeRequestImpl (Requisition *requisition, int numPos,
                                 Widget **references, int *x, int *y);
 
   virtual void sizeRequestSimpl (Requisition *requisition);
 
   virtual void getExtremesImpl (Extremes *extremes, int numPos,
                                 Widget **references, int *x, int *y);
 
   virtual void getExtremesSimpl (Extremes *extremes);
 
   virtual void calcExtraSpaceImpl (int numPos, Widget **references, int *x,
                                    int *y);
 
   virtual void sizeAllocateImpl (Allocation *allocation);
 
   virtual void resizeDrawImpl () { queueDraw (); };
 
   virtual void markSizeChange (int ref);
 
   virtual void markExtremesChange (int ref);
 
   virtual int getAvailWidthOfChild (Widget *child, bool forceValue);
   virtual int getAvailHeightOfChild (Widget *child, bool forceValue);
 
   virtual void correctRequisitionOfChild (Widget *child,
                                           Requisition *requisition,
                                           void (*splitHeightFun) (int, int*,
                                                                   int*),
                                           bool allowDecreaseWidth,
                                           bool allowDecreaseHeight);
   void correctRequisitionViewport (Requisition *requisition,
                            void (*splitHeightFun) (int, int*, int*),
                            bool allowDecreaseWidth, bool allowDecreaseHeight);
   void correctReqWidthOfChild (Widget *child, Requisition *requisition,
                                bool allowDecreaseWidth);
   void correctReqHeightOfChild (Widget *child, Requisition *requisition,
                                 void (*splitHeightFun) (int, int*, int*),
                                 bool allowDecreaseHeight);
   bool correctReqAspectRatio (int pass, Widget *child, Requisition *requisition,
                                      bool allowDecreaseWidth, bool allowDecreaseHeight,
                                      void (*splitHeightFun) (int, int*, int*));
   virtual void correctExtremesOfChild (Widget *child, Extremes *extremes,
                                        bool useAdjustmentWidth);
 
   virtual void containerSizeChangedForChildren ();
 
   virtual bool affectedByContainerSizeChange ();
   virtual bool affectsSizeChangeContainerChild (Widget *child);
   virtual bool usesAvailWidth ();
   virtual bool usesAvailHeight ();
 
   virtual void notifySetAsTopLevel();
   virtual void notifySetParent();
 
   virtual bool buttonPressImpl (EventButton *event);
   virtual bool buttonReleaseImpl (EventButton *event);
   virtual bool motionNotifyImpl (EventMotion *event);
   virtual void enterNotifyImpl (EventCrossing *event);
   virtual void leaveNotifyImpl (EventCrossing *event);
 
   inline char *addAnchor (const char* name)
   { return layout->addAnchor (this, name); }
 
   inline char *addAnchor (const char* name, int y)
   { return layout->addAnchor (this, name, y); }
 
   inline void changeAnchor (char* name, int y)
   { layout->changeAnchor (this, name, y); }
 
   inline void removeAnchor (char* name)
   { if (layout) layout->removeAnchor (this, name); }
 
   //inline void updateBgColor () { layout->updateBgColor (); }
 
   inline void setCursor (style::Cursor cursor)
   { layout->setCursor (cursor);  }
#if 0
   inline bool selectionButtonPress (Iterator *it, int charPos, int linkNo,
                                     EventButton *event, bool withinContent)
   { return layout->selectionState.buttonPress (it, charPos, linkNo, event); }
 
   inline bool selectionButtonRelease (Iterator *it, int charPos, int linkNo,
                                       EventButton *event, bool withinContent)
   { return layout->selectionState.buttonRelease (it, charPos, linkNo, event);}
 
   inline bool selectionButtonMotion (Iterator *it, int charPos, int linkNo,
                                      EventMotion *event, bool withinContent)
   { return layout->selectionState.buttonMotion (it, charPos, linkNo, event); }
#endif
   inline bool selectionHandleEvent (SelectionState::EventType eventType,
                                     Iterator *it, int charPos, int linkNo,
                                     MousePositionEvent *event)
   { return layout->selectionState.handleEvent (eventType, it, charPos, linkNo,
                                                event); }
 
private:
   void *deleteCallbackData;
   DW_Callback_t deleteCallbackFunc;
 
public:
   inline void setDeleteCallback(DW_Callback_t func, void *data)
   { deleteCallbackFunc = func; deleteCallbackData = data; }
 
private:
   bool resizeIdleEntered () { return layout && layout->resizeIdleCounter; }
 
   void enterQueueResize () { if (layout) layout->queueResizeCounter++; }
   void leaveQueueResize () { if (layout) layout->queueResizeCounter--; }
   bool queueResizeEntered () { return layout && layout->queueResizeCounter; }
 
   void enterSizeAllocate () { if (layout) layout->sizeAllocateCounter++; }
   void leaveSizeAllocate () { if (layout) layout->sizeAllocateCounter--; }
   bool sizeAllocateEntered () { return layout && layout->sizeAllocateCounter; }
 
   void enterSizeRequest () { if (layout) layout->sizeRequestCounter++; }
   void leaveSizeRequest () { if (layout) layout->sizeRequestCounter--; }
   bool sizeRequestEntered () { return layout && layout->sizeRequestCounter; }
 
   void enterGetExtremes () { if (layout) layout->getExtremesCounter++; }
   void leaveGetExtremes () { if (layout) layout->getExtremesCounter--; }
   bool getExtremesEntered () { return layout && layout->getExtremesCounter; }
 
 
public:
   static int CLASS_ID;
 
   inline static void setAdjustMinWidth (bool adjustMinWidth)
   { Widget::adjustMinWidth = adjustMinWidth; }
 
   Widget ();
   ~Widget ();
 
   inline bool resizeQueued ()    { return flags & RESIZE_QUEUED; }
   inline bool extremesQueued ()  { return flags & EXTREMES_QUEUED; }
   inline bool needsResize ()     { return flags & NEEDS_RESIZE; }
   inline bool needsAllocate ()   { return flags & NEEDS_ALLOCATE; }
   inline bool allocateQueued ()  { return flags & ALLOCATE_QUEUED; }
   inline bool extremesChanged () { return flags & EXTREMES_CHANGED; }
   inline bool wasAllocated ()    { return flags & WAS_ALLOCATED; }
 
   void setParent (Widget *parent);
   void setQuasiParent (Widget *quasiParent);
 
   void setGenerator (Widget *generator) { this->generator = generator; }
 
   inline style::Style *getStyle () { return style; }
   inline Allocation *getAllocation () { return &allocation; }
   inline bool inAllocation (int x, int y) {
      return wasAllocated () && x >= allocation.x && y >= allocation.y &&
         x <= allocation.x + allocation.width &&
         y <= allocation.y + getHeight ();
   }
 
   inline int boxOffsetX ()
   { return extraSpace.left + getStyle()->boxOffsetX (); }
   inline int boxRestWidth ()
   { return extraSpace.right + getStyle()->boxRestWidth (); }
   inline int boxDiffWidth () { return boxOffsetX () + boxRestWidth (); }
   inline int boxOffsetY ()
   { return extraSpace.top + getStyle()->boxOffsetY (); }
   inline int boxRestHeight ()
   { return extraSpace.bottom + getStyle()->boxRestHeight (); }
   inline int boxDiffHeight () { return boxOffsetY () + boxRestHeight (); }
   
   virtual int numSizeRequestReferences ();
 
   virtual Widget *sizeRequestReference (int index);
 
   virtual int numGetExtremesReferences ();
 
   virtual Widget *getExtremesReference (int index);
 
   void sizeRequest (Requisition *requisition, int numPos = 0,
                     Widget **references = NULL, int *x = NULL, int *y = NULL);
   void getExtremes (Extremes *extremes, int numPos = 0,
                     Widget **references = NULL, int *x = NULL, int *y = NULL);
   void sizeAllocate (Allocation *allocation);
 
   void calcExtraSpace (int numPos, Widget **references, int *x, int *y);
 
   int getAvailWidth (bool forceValue);
   int getAvailHeight (bool forceValue);
   virtual bool getAdjustMinWidth () { return Widget::adjustMinWidth; }
   void correctRequisition (Requisition *requisition,
                            void (*splitHeightFun) (int, int*, int*),
                            bool allowDecreaseWidth, bool allowDecreaseHeight);
   void correctExtremes (Extremes *extremes, bool useAdjustmentWidth);
   int calcWidth (style::Length cssValue, int refWidth, Widget *refWidget,
                  int limitMinWidth, bool forceValue);
   void calcFinalWidth (style::Style *style, int refWidth, Widget *refWidget,
                        int limitMinWidth, bool forceValue, int *finalWidth);
   int calcHeight (style::Length cssValue, bool usePercentage, int refHeight,
                   Widget *refWidget, bool forceValue);
   static void adjustHeight (int *height, bool allowDecreaseHeight, int ascent,
                             int descent);
 
   virtual int applyPerWidth (int containerWidth, style::Length perWidth);
   virtual int applyPerHeight (int containerHeight, style::Length perHeight);
 
   int getMinWidth (Extremes *extremes, bool forceValue);
 
   virtual bool isBlockLevel ();
   virtual bool isPossibleContainer ();
 
   void containerSizeChanged ();
 
   bool intersects (Widget *refWidget, Rectangle *area,
                    Rectangle *intersection);
 
   virtual void draw (View *view, Rectangle *area, DrawingContext *context) = 0;
   void drawInterruption (View *view, Rectangle *area, DrawingContext *context);
 
   virtual Widget *getWidgetAtPoint (int x, int y,
                                     GettingWidgetAtPointContext *context);
   Widget *getWidgetAtPointInterrupted (int x, int y,
                                        GettingWidgetAtPointContext *context);
 
   bool buttonPress (EventButton *event);
   bool buttonRelease (EventButton *event);
   bool motionNotify (EventMotion *event);
   void enterNotify (EventCrossing *event);
   void leaveNotify (EventCrossing *event);
 
   virtual void setStyle (style::Style *style);
   void setBgColor (style::Color *bgColor);
   style::Color *getBgColor ();
   style::Color *getFgColor ();
 
   void drawBox (View *view, style::Style *style, Rectangle *area,
                 int x, int y, int width, int height, bool inverse);
   void drawWidgetBox (View *view, Rectangle *area, bool inverse);
   void drawSelected (View *view, Rectangle *area);
 
   void setButtonSensitive (bool buttonSensitive);
   inline bool isButtonSensitive () { return buttonSensitive; }
 
   inline Widget *getParent () { return parent; }
   inline Widget *getContainer () { return container; }
   Widget *getTopLevel ();
   int getLevel ();
   int getGeneratorLevel ();
   Widget *getNearestCommonAncestor (Widget *otherWidget);
 
   inline WidgetReference *getWidgetReference () { return widgetReference; }
   inline void setWidgetReference (WidgetReference *widgetReference) {
      this->widgetReference = widgetReference;
      DBG_OBJ_SET_PTR ("widgetReference", widgetReference);
   }
   
   inline Widget *getGenerator () { return generator ? generator : parent; }
 
   inline Layout *getLayout () { return layout; }
 
   void scrollTo (HPosition hpos, VPosition vpos,
                  int x, int y, int width, int height);
 
   void getMarginArea (int *xMar, int *yMar, int *widthMar, int *heightMar);
   void getBorderArea (int *xBor, int *yBor, int *widthBor, int *heightBor);
   void getPaddingArea (int *xPad, int *yPad, int *widthPad, int *heightPad);
 
   virtual Iterator *iterator (Content::Type mask, bool atEnd) = 0;
 
   virtual void removeChild (Widget *child);
};
 
void splitHeightPreserveAscent (int height, int *ascent, int *descent);
void splitHeightPreserveDescent (int height, int *ascent, int *descent);
 
} // namespace core
} // namespace dw
 
#endif // __DW_WIDGET_HH__