The base class of all dillo widgets. More...

#include <widget.hh>

Classes
class	WidgetImgRenderer
	Implementation which represents the whole widget. More...

Public Member Functions
void	setDeleteCallback (DW_Callback_t func, void *data)

	Widget ()

	~Widget ()

bool	resizeQueued ()

bool	extremesQueued ()

bool	needsResize ()

bool	needsAllocate ()

bool	allocateQueued ()

bool	extremesChanged ()

bool	wasAllocated ()

void	setParent (Widget *parent)

void	setQuasiParent (Widget *quasiParent)

void	setGenerator (Widget *generator)

style::Style *	getStyle ()

Allocation *	getAllocation ()

bool	inAllocation (int x, int y)

int	boxOffsetX ()

int	boxRestWidth ()

int	boxDiffWidth ()

int	boxOffsetY ()

int	boxRestHeight ()

int	boxDiffHeight ()

virtual int	numSizeRequestReferences ()
	See Sizes of Dillo Widgets (or Size requisitions depending on positions).

virtual Widget *	sizeRequestReference (int index)
	See Sizes of Dillo Widgets (or Size requisitions depending on positions).

virtual int	numGetExtremesReferences ()
	See Sizes of Dillo Widgets (or Size requisitions depending on positions).

virtual Widget *	getExtremesReference (int index)
	See Sizes of Dillo Widgets (or Size requisitions depending on positions).

void	sizeRequest (Requisition requisition, int numPos=0, Widget references=NULL, int x=NULL, int *y=NULL)
	This method is a wrapper for Widget::sizeRequestImpl(); it calls the latter only when needed.

void	getExtremes (Extremes extremes, int numPos=0, Widget references=NULL, int x=NULL, int *y=NULL)
	Wrapper for Widget::getExtremesImpl().

void	sizeAllocate (Allocation *allocation)
	Wrapper for Widget::sizeAllocateImpl, calls the latter only when needed.

void	calcExtraSpace (int numPos, Widget *references, int x, int *y)
	Calculates dw::core::Widget::extraSpace.

int	getAvailWidth (bool forceValue)
	Return available width including margin/border/padding (extraSpace?), not only the content width.

int	getAvailHeight (bool forceValue)
	Return available height including margin/border/padding (extraSpace?), not only the content height.

virtual bool	getAdjustMinWidth ()

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)
	Computes a width value in pixels from cssValue.

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)

virtual int	applyPerWidth (int containerWidth, style::Length perWidth)

virtual int	applyPerHeight (int containerHeight, style::Length perHeight)

int	getMinWidth (Extremes *extremes, bool forceValue)
	Used to evaluate Widget::adjustMinWidth.

virtual bool	isBlockLevel ()

virtual bool	isPossibleContainer ()

void	containerSizeChanged ()

bool	intersects (Widget refWidget, Rectangle area, Rectangle *intersection)
	Calculates the intersection of the visible allocation (i.

virtual void	draw (View view, Rectangle area, DrawingContext *context)=0
	Area is given in widget coordinates.

void	drawInterruption (View view, Rectangle area, DrawingContext *context)
	See Interrupted drawing for details.

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)
	Change the style of a widget.

void	setBgColor (style::Color *bgColor)
	Set the background "behind" the widget, if it is not the background of the parent widget, e.g.

style::Color *	getBgColor ()
	Get the actual background of a widget.

style::Color *	getFgColor ()
	Get the actual foreground color of a widget.

void	drawBox (View view, style::Style style, Rectangle *area, int x, int y, int width, int height, bool inverse)
	Draw borders and background of a widget part, which allocation is given by (x, y, width, height) (widget coordinates).

void	drawWidgetBox (View view, Rectangle area, bool inverse)
	Draw borders and background of a widget.

void	drawSelected (View view, Rectangle area)

void	setButtonSensitive (bool buttonSensitive)

bool	isButtonSensitive ()

Widget *	getParent ()

Widget *	getContainer ()

Widget *	getTopLevel ()
	Get the widget at the root of the tree, this widget is part from.

int	getLevel ()
	Get the level of the widget within the tree.

int	getGeneratorLevel ()
	Get the level of the widget within the tree, regarting the generators, not the parents.

Widget *	getNearestCommonAncestor (Widget *otherWidget)
	Get the widget with the highest level, which is a direct ancestor of widget1 and widget2.

WidgetReference *	getWidgetReference ()

void	setWidgetReference (WidgetReference *widgetReference)

Widget *	getGenerator ()

Layout *	getLayout ()

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)
	Return the padding area (content plus padding).

virtual Iterator *	iterator (Content::Type mask, bool atEnd)=0
	Return an iterator for this widget.

virtual void	removeChild (Widget *child)

Public Member Functions inherited from lout::identity::IdentifiableObject
	IdentifiableObject ()

void	intoStringBuffer (misc::StringBuffer *sb)
	Store a textual representation of the object in a misc::StringBuffer.

int	getClassId ()
	Returns the class identifier.

const char *	getClassName ()
	Return the name, under which the class of this object was registered.

bool	instanceOf (int otherClassId)
	Returns, whether this class is an instance of the class, given by otherClassId, or of a sub class of this class.

Public Member Functions inherited from lout::object::Object
virtual	~Object ()
	The destructor is defined as virtual (but not abstract), so that destruction of Object's works properly.

virtual bool	equals (Object *other)
	Returns, whether two objects are equal.

virtual int	hashValue ()
	Return a hash value for the object.

virtual Object *	clone ()
	Return an exact copy of the object.

const char *	toString ()
	Use object::Object::intoStringBuffer to return a textual representation of the object.

virtual size_t	sizeOf ()
	Return the number of bytes, this object totally uses.

Static Public Member Functions
static void	setAdjustMinWidth (bool adjustMinWidth)

static void	adjustHeight (int *height, bool allowDecreaseHeight, int ascent, int descent)

Public Attributes
int	parentRef
	This value is defined by the parent widget, and used for incremential resizing.

Static Public Attributes
static int	CLASS_ID = -1

Protected Types
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 }

Protected Member Functions
int	getHeight ()

int	getContentWidth ()

int	getContentHeight ()

StackingContextMgr *	getNextStackingContextMgr ()

void	printFlag (Flags f)

void	setFlags (Flags f)

void	unsetFlags (Flags f)

void	queueDraw ()

void	queueDrawArea (int x, int y, int width, int height)

void	queueResize (int ref, bool extremesChanged)

virtual void	sizeRequestImpl (Requisition requisition, int numPos, Widget references, int x, int *y)
	See Sizes of Dillo Widgets.

virtual void	sizeRequestSimpl (Requisition *requisition)
	Simple variant, to be implemented by widgets with sizes not depending on positions.

virtual void	getExtremesImpl (Extremes extremes, int numPos, Widget references, int x, int *y)
	See Sizes of Dillo Widgets.

virtual void	getExtremesSimpl (Extremes *extremes)
	Simple variant, to be implemented by widgets with extremes not depending on positions.

virtual void	calcExtraSpaceImpl (int numPos, Widget *references, int x, int *y)
	The actual implementation for calculating dw::core::Widget::extraSpace.

virtual void	sizeAllocateImpl (Allocation *allocation)
	See Sizes of Dillo Widgets.

virtual void	resizeDrawImpl ()
	Called after sizeAllocateImpl() to redraw necessary areas.

virtual void	markSizeChange (int ref)
	See Sizes of Dillo Widgets.

virtual void	markExtremesChange (int ref)
	See Sizes of Dillo Widgets.

virtual int	getAvailWidthOfChild (Widget *child, bool forceValue)
	Computes the content width available of a child widget.

virtual int	getAvailHeightOfChild (Widget *child, bool forceValue)

virtual void	correctRequisitionOfChild (Widget child, 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)

virtual void	correctExtremesOfChild (Widget child, Extremes extremes, bool useAdjustmentWidth)

virtual void	containerSizeChangedForChildren ()

virtual bool	affectedByContainerSizeChange ()

virtual bool	affectsSizeChangeContainerChild (Widget *child)

virtual bool	usesAvailWidth ()
	Must be implemengted by a method returning true, when getAvailWidth() is called.

virtual bool	usesAvailHeight ()
	Must be implemengted by a method returning true, when getAvailHeight() is called.

virtual void	notifySetAsTopLevel ()
	This method is called after a widget has been set as the top of a widget tree.

virtual void	notifySetParent ()
	This method is called after a widget has been added to a parent.

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)

char *	addAnchor (const char *name)

char *	addAnchor (const char *name, int y)

void	changeAnchor (char *name, int y)

void	removeAnchor (char *name)

void	setCursor (style::Cursor cursor)

bool	selectionHandleEvent (SelectionState::EventType eventType, Iterator it, int charPos, int linkNo, MousePositionEvent event)

Protected Member Functions inherited from lout::identity::IdentifiableObject
void	registerName (const char className, int classId)
	This method must be called in the constructor for the sub class.

Protected Attributes
WidgetImgRenderer *	widgetImgRenderer

Allocation	allocation
	The current allocation: size and position, always relative to the canvas.

Layout *	layout

style::Box	extraSpace
	Space around the margin box.

StackingContextMgr *	stackingContextMgr
	Set iff this widget constitutes a stacking context, as defined by CSS.

Widget *	stackingContextWidget
	The bottom-most ancestor (or this) for which stackingContextMgr is set.

Private Member Functions
void	queueResize (int ref, bool extremesChanged, bool fast)
	This method should be called, when a widget changes its size.

void	queueResizeFast (int ref, bool extremesChanged)

bool	resizeIdleEntered ()

void	enterQueueResize ()

void	leaveQueueResize ()

bool	queueResizeEntered ()

void	enterSizeAllocate ()

void	leaveSizeAllocate ()

bool	sizeAllocateEntered ()

void	enterSizeRequest ()

void	leaveSizeRequest ()

bool	sizeRequestEntered ()

void	enterGetExtremes ()

void	leaveGetExtremes ()

bool	getExtremesEntered ()

Private Attributes
Widget *	parent
	The parent widget, NULL for top-level widgets.

Widget *	quasiParent
	...

Widget *	generator
	The generating widget, NULL for top-level widgets, or if not set; in the latter case, the effective generator (see getGenerator) is the parent.

Widget *	container
	The containing widget, equivalent to the "containing block" defined by CSS.

WidgetReference *	widgetReference

style::Style *	style

Flags	flags

Requisition	requisition
	Size_request() stores the result of the last call of size_request_impl().

SizeParams	requisitionParams

Extremes	extremes
	Analogue to dw::core::Widget::requisition.

SizeParams	extremesParams

style::Color *	bgColor
	See dw::core::Widget::setBgColor().

bool	buttonSensitive
	See dw::core::Widget::setButtonSensitive().

bool	buttonSensitiveSet
	See dw::core::Widget::setButtonSensitive().

void *	deleteCallbackData

DW_Callback_t	deleteCallbackFunc

Static Private Attributes
static bool	adjustMinWidth = true

Friends
class	Layout

Detailed Description

The base class of all dillo widgets.

See also: Dillo Widget Overview, Layout and Widgets

Definition at line 43 of file widget.hh.

Member Enumeration Documentation

◆ Flags

enum dw::core::Widget::Flags

protected

Enumerator
RESIZE_QUEUED	Todo: Comment this.
EXTREMES_QUEUED	Todo: Comment this.
NEEDS_RESIZE	Set, when dw::core::Widget::requisition is not up to date anymore. Todo: Update, see RESIZE_QUEUED.
NEEDS_ALLOCATE	Only used internally, set to enforce size allocation. In some cases, the size of a widget remains the same, but the children are allocated at different positions and in different sizes, so that a simple comparison of old and new allocation is insufficient. Therefore, this flag is set (indirectly, as ALLOCATE_QUEUED) in queueResize.
ALLOCATE_QUEUED	Todo: Comment this.
EXTREMES_CHANGED	Set, when dw::core::Widget::extremes is not up to date anymore. Todo: Update, see RESIZE_QUEUED.
WAS_ALLOCATED	Set, when a widget was already once allocated,. The dw::Image widget uses this flag, see dw::Image::setBuffer.

Definition at line 48 of file widget.hh.

Constructor & Destructor Documentation

◆ Widget()

dw::core::Widget::Widget ( )

Definition at line 68 of file widget.cc.

References allocation, dw::core::Allocation::ascent, bgColor, dw::core::style::Box::bottom, buttonSensitive, buttonSensitiveSet, CLASS_ID, container, DBG_OBJ_ASSOC_CHILD, DBG_OBJ_CREATE, DBG_OBJ_SET_PTR, deleteCallbackData, deleteCallbackFunc, dw::core::Allocation::descent, extraSpace, EXTREMES_CHANGED, extremesParams, flags, generator, layout, dw::core::style::Box::left, NEEDS_RESIZE, parent, quasiParent, lout::identity::IdentifiableObject::registerName(), requisitionParams, dw::core::style::Box::right, setWidgetReference(), stackingContextMgr, style, dw::core::style::Box::top, widgetImgRenderer, dw::core::Allocation::width, dw::core::Allocation::x, and dw::core::Allocation::y.

Referenced by dw::Textblock::addLine(), dw::Textblock::addParbreak(), dw::Table::calcAvailWidthForDescendant(), dw::Table::drawLevel(), dw::Table::forceCalcCellSizes(), dw::Table::getWidgetAtPointLevel(), dw::Textblock::getWidgetAtPointLevel(), dw::Textblock::getWidgetRegardingBorderForLine(), dw::Textblock::handOverBreak(), dw::Textblock::wrapWordInFlow(), and dw::Textblock::wrapWordOofRef().

◆ ~Widget()

dw::core::Widget::~Widget ( )

Definition at line 104 of file widget.cc.

References dw::core::style::StyleAttrs::backgroundImage, DBG_OBJ_DELETE, deleteCallbackData, deleteCallbackFunc, layout, parent, removeChild(), dw::core::style::StyleImage::removeExternalImgRenderer(), dw::core::Layout::removeWidget(), stackingContextMgr, style, dw::core::style::Style::unref(), and widgetImgRenderer.

Member Function Documentation

◆ addAnchor() [1/2]

char * dw::core::Widget::addAnchor ( const char * name )

inlineprotected

Definition at line 383 of file widget.hh.

References dw::core::Layout::addAnchor(), and layout.

◆ addAnchor() [2/2]

char * dw::core::Widget::addAnchor	(	const char *	name,
		int	y
	)

inlineprotected

Definition at line 386 of file widget.hh.

References dw::core::Layout::addAnchor(), and layout.

◆ adjustHeight()

void dw::core::Widget::adjustHeight	(	int *	height,
		bool	allowDecreaseHeight,
		int	ascent,
		int	descent
	)

static

Definition at line 1004 of file widget.cc.

Referenced by correctReqHeightOfChild(), and correctRequisition().

◆ affectedByContainerSizeChange()

bool dw::core::Widget::affectedByContainerSizeChange ( )

protectedvirtual

Definition at line 433 of file widget.cc.

References affectsSizeChangeContainerChild(), lout::misc::boolToStr(), container, DBG_OBJ_ENTER0, DBG_OBJ_LEAVE_VAL, getStyle(), dw::core::style::StyleAttrs::height, dw::core::style::isAbsLength(), dw::core::style::isPerLength(), dw::core::style::LENGTH_AUTO, usesAvailHeight(), usesAvailWidth(), and dw::core::style::StyleAttrs::width.

Referenced by containerSizeChanged().

◆ affectsSizeChangeContainerChild()

bool dw::core::Widget::affectsSizeChangeContainerChild ( Widget * child )

protectedvirtual

Definition at line 467 of file widget.cc.

References lout::misc::boolToStr(), DBG_OBJ_ENTER, DBG_OBJ_LEAVE_VAL, getStyle(), dw::core::style::StyleAttrs::height, dw::core::style::isAbsLength(), dw::core::style::isPerLength(), dw::core::style::LENGTH_AUTO, usesAvailHeight(), usesAvailWidth(), and dw::core::style::StyleAttrs::width.

Referenced by affectedByContainerSizeChange().

◆ allocateQueued()

bool dw::core::Widget::allocateQueued ( )

inline

Definition at line 459 of file widget.hh.

References ALLOCATE_QUEUED, and flags.

Referenced by dw::core::Layout::resizeIdle().

◆ applyPerHeight()

int dw::core::Widget::applyPerHeight	(	int	containerHeight,
		style::Length	perHeight
	)

virtual

Reimplemented in dw::AlignedTableCell, dw::SimpleTableCell, and dw::Table.

Definition at line 1680 of file widget.cc.

References boxDiffHeight(), and dw::core::style::multiplyWithPerLength().

Referenced by calcHeight(), getAvailHeight(), and getAvailHeightOfChild().

◆ applyPerWidth()

int dw::core::Widget::applyPerWidth	(	int	containerWidth,
		style::Length	perWidth
	)

virtual

Reimplemented in dw::AlignedTableCell, dw::SimpleTableCell, and dw::Table.

Definition at line 1674 of file widget.cc.

References boxDiffWidth(), and dw::core::style::multiplyWithPerLength().

Referenced by calcWidth(), dw::core::ui::ComplexButtonResource::correctExtremesOfChild(), and dw::core::ui::ComplexButtonResource::correctRequisitionOfChild().

◆ boxDiffHeight()

int dw::core::Widget::boxDiffHeight ( )

inline

Definition at line 486 of file widget.hh.

References boxOffsetY(), and boxRestHeight().

Referenced by applyPerHeight(), calcHeight(), dw::oof::OOFPosAbsLikeMgr::calcVPosAndSizeChildOfChild(), getAvailHeight(), getAvailHeightOfChild(), getContentHeight(), and dw::Table::sizeRequestSimpl().

◆ boxDiffWidth()

int dw::core::Widget::boxDiffWidth ( )

inline

◆ boxOffsetX()

int dw::core::Widget::boxOffsetX ( )

inline

Definition at line 477 of file widget.hh.

References dw::core::style::StyleAttrs::boxOffsetX(), extraSpace, getStyle(), and dw::core::style::Box::left.

Referenced by dw::Textblock::addLine(), boxDiffWidth(), dw::Textblock::calcLineBreakWidth(), dw::Textblock::calcSizeOfWidgetInFlow(), dw::oof::OOFPosAbsMgr::containerBoxOffsetX(), dw::Textblock::TextblockIterator::getAllocation(), dw::Table::sizeAllocateImpl(), dw::SimpleContainer::sizeAllocateImpl(), dw::Textblock::wrapWordInFlow(), and dw::Textblock::wrapWordOofRef().

◆ boxOffsetY()

int dw::core::Widget::boxOffsetY ( )

inline

Definition at line 482 of file widget.hh.

References dw::core::style::StyleAttrs::boxOffsetY(), extraSpace, getStyle(), and dw::core::style::Box::top.

Referenced by boxDiffHeight(), dw::oof::OOFPosAbsMgr::containerBoxOffsetY(), dw::Table::sizeAllocateImpl(), dw::SimpleContainer::sizeAllocateImpl(), dw::Textblock::sizeRequestImpl(), dw::Ruler::sizeRequestSimpl(), and dw::SimpleContainer::sizeRequestSimpl().

◆ boxRestHeight()

int dw::core::Widget::boxRestHeight ( )

inline

Definition at line 484 of file widget.hh.

References dw::core::style::Box::bottom, dw::core::style::StyleAttrs::boxRestHeight(), extraSpace, and getStyle().

Referenced by boxDiffHeight(), dw::oof::OOFPosAbsMgr::containerBoxRestHeight(), dw::oof::OOFFloatsMgr::getSize(), dw::SimpleContainer::sizeAllocateImpl(), dw::Textblock::sizeRequestImpl(), dw::Ruler::sizeRequestSimpl(), and dw::SimpleContainer::sizeRequestSimpl().

◆ boxRestWidth()

int dw::core::Widget::boxRestWidth ( )

inline

Definition at line 479 of file widget.hh.

References dw::core::style::StyleAttrs::boxRestWidth(), extraSpace, getStyle(), and dw::core::style::Box::right.

Referenced by dw::Textblock::addLine(), boxDiffWidth(), dw::Textblock::calcLineBreakWidth(), dw::Textblock::calcSizeOfWidgetInFlow(), dw::oof::OOFPosAbsMgr::containerBoxRestWidth(), and dw::oof::OOFFloatsMgr::getSize().

◆ buttonPress()

bool dw::core::Widget::buttonPress ( EventButton * event )

Definition at line 1201 of file widget.cc.

References buttonPressImpl().

Referenced by dw::core::Layout::processMouseEvent().

◆ buttonPressImpl()

bool dw::core::Widget::buttonPressImpl ( EventButton * event )

protectedvirtual

Reimplemented in dw::Image, dw::Textblock, and dw::core::ui::Embed.

Definition at line 1987 of file widget.cc.

Referenced by buttonPress().

◆ buttonRelease()

bool dw::core::Widget::buttonRelease ( EventButton * event )

Definition at line 1206 of file widget.cc.

References buttonReleaseImpl().

Referenced by dw::core::Layout::processMouseEvent().

◆ buttonReleaseImpl()

bool dw::core::Widget::buttonReleaseImpl ( EventButton * event )

protectedvirtual

Reimplemented in dw::Image, and dw::Textblock.

Definition at line 1992 of file widget.cc.

Referenced by buttonRelease().

◆ calcExtraSpace()

void dw::core::Widget::calcExtraSpace	(	int	numPos,
		Widget **	references,
		int *	x,
		int *	y
	)

Calculates dw::core::Widget::extraSpace.

Delegated to dw::core::Widget::calcExtraSpaceImpl. Called both from dw::core::Widget::sizeRequest and dw::core::Widget::getExtremes.

Definition at line 1085 of file widget.cc.

References dw::core::style::Box::bottom, calcExtraSpaceImpl(), DBG_OBJ_ENTER0, DBG_OBJ_LEAVE, DBG_OBJ_SET_NUM, extraSpace, dw::core::style::Box::left, dw::core::style::Box::right, and dw::core::style::Box::top.

Referenced by sizeRequest().

◆ calcExtraSpaceImpl()

void dw::core::Widget::calcExtraSpaceImpl	(	int	numPos,
		Widget **	references,
		int *	x,
		int *	y
	)

protectedvirtual

The actual implementation for calculating dw::core::Widget::extraSpace.

The implementation gets a clean value of dw::core::Widget::extraSpace, which is only corrected. To make sure all possible influences are considered, the implementation of the base class should be called, too.

Definition at line 1661 of file widget.cc.

Referenced by calcExtraSpace().

◆ calcFinalWidth()

void dw::core::Widget::calcFinalWidth	(	style::Style *	style,
		int	refWidth,
		Widget *	refWidget,
		int	limitMinWidth,
		bool	forceValue,
		int *	finalWidth
	)

Definition at line 927 of file widget.cc.

References calcWidth(), DBG_OBJ_ENTER, DBG_OBJ_LEAVE_VAL, DBG_OBJ_MSGF, dw::core::style::StyleAttrs::maxWidth, dw::core::style::StyleAttrs::minWidth, style, and dw::core::style::StyleAttrs::width.

Referenced by correctRequisition(), correctReqWidthOfChild(), getAvailWidth(), dw::oof::OOFPosAbsLikeMgr::getAvailWidthOfChild(), and getAvailWidthOfChild().

◆ calcHeight()

int dw::core::Widget::calcHeight	(	style::Length	cssValue,
		bool	usePercentage,
		int	refHeight,
		Widget *	refWidget,
		bool	forceValue
	)

Definition at line 958 of file widget.cc.

References dw::core::style::absLengthVal(), applyPerHeight(), boxDiffHeight(), DBG_OBJ_ENTER, DBG_OBJ_LEAVE_VAL, DBG_OBJ_MSG, DBG_OBJ_MSGF, getAvailHeight(), dw::core::style::isAbsLength(), dw::core::style::isPerLength(), lout::misc::max(), and dw::core::style::perLengthVal_useThisOnlyForDebugging().

Referenced by correctReqHeightOfChild(), correctRequisition(), and dw::oof::OOFPosAbsLikeMgr::getAvailHeightOfChild().

◆ calcWidth()

int dw::core::Widget::calcWidth	(	style::Length	cssValue,
		int	refWidth,
		Widget *	refWidget,
		int	limitMinWidth,
		bool	forceValue
	)

Computes a width value in pixels from cssValue.

If cssValue is absolute, the absolute value is used. If cssValue is relative, then it is applied to refWidth. Otherwise, -1 is used.

In any case, the returned value is clamped so that is not smaller than limitMinWidth.

Definition at line 883 of file widget.cc.

References dw::core::style::absLengthVal(), applyPerWidth(), boxDiffWidth(), DBG_OBJ_ENTER, DBG_OBJ_LEAVE_VAL, DBG_OBJ_MSG, DBG_OBJ_MSGF, getAvailWidth(), dw::core::style::isAbsLength(), dw::core::style::isPerLength(), lout::misc::max(), and dw::core::style::perLengthVal_useThisOnlyForDebugging().

Referenced by calcFinalWidth(), correctExtremes(), correctExtremesOfChild(), and getAvailWidthOfChild().

◆ changeAnchor()

void dw::core::Widget::changeAnchor	(	char *	name,
		int	y
	)

inlineprotected

Definition at line 389 of file widget.hh.

References dw::core::Layout::changeAnchor(), and layout.

Referenced by dw::Textblock::sizeAllocateImpl().

◆ containerSizeChanged()

void dw::core::Widget::containerSizeChanged ( )

Definition at line 408 of file widget.cc.

References affectedByContainerSizeChange(), container, containerSizeChangedForChildren(), DBG_OBJ_ENTER0, DBG_OBJ_LEAVE, extremesChanged(), extremesQueued(), needsResize(), queueResizeFast(), and resizeQueued().

Referenced by dw::core::Layout::containerSizeChanged(), dw::oof::OOFFloatsMgr::containerSizeChangedForChildren(), dw::Textblock::containerSizeChangedForChildren(), containerSizeChangedForChildren(), dw::oof::OOFAwareWidget::oofSizeChanged(), and dw::Textblock::oofSizeChanged().

◆ containerSizeChangedForChildren()

void dw::core::Widget::containerSizeChangedForChildren ( )

protectedvirtual

Reimplemented in dw::Bullet, dw::Image, dw::Ruler, dw::Table, dw::Textblock, and dw::core::ui::Embed.

Definition at line 497 of file widget.cc.

References containerSizeChanged(), DBG_OBJ_ENTER0, DBG_OBJ_LEAVE, dw::core::Iterator::getContent(), iterator(), dw::core::Iterator::next(), dw::core::Iterator::unref(), dw::core::Content::widget, dw::core::Content::WIDGET_IN_FLOW, and dw::core::Content::WIDGET_OOF_CONT.

Referenced by containerSizeChanged().

◆ correctExtremes()

void dw::core::Widget::correctExtremes	(	Extremes *	extremes,
		bool	useAdjustmentWidth
	)

◆ correctExtremesOfChild()

void dw::core::Widget::correctExtremesOfChild	(	Widget *	child,
		Extremes *	extremes,
		bool	useAdjustmentWidth
	)

protectedvirtual

◆ correctReqHeightOfChild()

void dw::core::Widget::correctReqHeightOfChild	(	Widget *	child,
		Requisition *	requisition,
		void()(int, int , int *)	splitHeightFun,
		bool	allowDecreaseHeight
	)

protected

Definition at line 1867 of file widget.cc.

References adjustHeight(), dw::core::Requisition::ascent, lout::misc::boolToStr(), calcHeight(), container, DBG_OBJ_ENTER, DBG_OBJ_LEAVE_VAL, dw::core::Requisition::descent, getStyle(), dw::core::style::StyleAttrs::height, dw::core::style::StyleAttrs::maxHeight, dw::core::style::StyleAttrs::minHeight, quasiParent, requisition, and dw::core::Requisition::width.

Referenced by dw::core::ui::Embed::correctReqHeightOfChildNoRec(), and correctRequisitionOfChild().

◆ correctRequisition()

void dw::core::Widget::correctRequisition	(	Requisition *	requisition,
		void()(int, int , int *)	splitHeightFun,
		bool	allowDecreaseWidth,
		bool	allowDecreaseHeight
	)

◆ correctRequisitionOfChild()

void dw::core::Widget::correctRequisitionOfChild	(	Widget *	child,
		Requisition *	requisition,
		void()(int, int , int *)	splitHeightFun,
		bool	allowDecreaseWidth,
		bool	allowDecreaseHeight
	)

protectedvirtual

Reimplemented in dw::core::ui::Embed.

Definition at line 1810 of file widget.cc.

References dw::core::Requisition::ascent, lout::misc::boolToStr(), container, correctReqHeightOfChild(), correctRequisitionOfChild(), correctReqWidthOfChild(), DBG_OBJ_ENTER, DBG_OBJ_LEAVE_VAL, DBG_OBJ_MSG, DBG_OBJ_MSG_END, DBG_OBJ_MSG_START, dw::core::Requisition::descent, parent, quasiParent, requisition, and dw::core::Requisition::width.

Referenced by correctRequisition(), dw::AlignedTableCell::correctRequisitionOfChild(), dw::SimpleTableCell::correctRequisitionOfChild(), and correctRequisitionOfChild().

◆ correctReqWidthOfChild()

void dw::core::Widget::correctReqWidthOfChild	(	Widget *	child,
		Requisition *	requisition,
		bool	allowDecreaseWidth
	)

protected

Definition at line 1846 of file widget.cc.

References dw::core::Requisition::ascent, lout::misc::boolToStr(), calcFinalWidth(), container, DBG_OBJ_ENTER, DBG_OBJ_LEAVE_VAL, dw::core::Requisition::descent, getMinWidth(), getStyle(), quasiParent, requisition, and dw::core::Requisition::width.

Referenced by correctRequisitionOfChild(), and dw::core::ui::Embed::correctReqWidthOfChildNoRec().

◆ draw()

virtual void dw::core::Widget::draw	(	View *	view,
		Rectangle *	area,
		DrawingContext *	context
	)

pure virtual

Area is given in widget coordinates.

Implemented in dw::Bullet, dw::Image, dw::oof::OOFAwareWidget, dw::Ruler, dw::SimpleContainer, and dw::core::ui::Embed.

Referenced by dw::oof::OOFPositionedMgr::draw(), dw::SimpleContainer::draw(), dw::core::Layout::draw(), dw::core::StackingContextMgr::draw(), dw::oof::OOFFloatsMgr::drawFloats(), drawInterruption(), and dw::Textblock::drawLine().

◆ drawBox()

void dw::core::Widget::drawBox	(	View *	view,
		style::Style *	style,
		Rectangle *	area,
		int	x,
		int	y,
		int	width,
		int	height,
		bool	inverse
	)

Draw borders and background of a widget part, which allocation is given by (x, y, width, height) (widget coordinates).

area is given in widget coordinates.

Definition at line 1388 of file widget.cc.

References allocation, dw::core::style::StyleAttrs::backgroundColor, dw::core::style::StyleAttrs::borderWidth, dw::core::style::Box::bottom, dw::core::style::drawBackground(), dw::core::style::drawBorder(), getPaddingArea(), dw::core::Rectangle::height, layout, dw::core::style::Box::left, dw::core::style::StyleAttrs::margin, dw::core::style::Box::right, style, dw::core::style::Box::top, dw::core::Rectangle::width, dw::core::Rectangle::x, dw::core::Allocation::x, dw::core::Rectangle::y, and dw::core::Allocation::y.

Referenced by dw::Table::drawLevel(), dw::Textblock::drawLine(), and dw::Textblock::drawWord().

◆ drawInterruption()

void dw::core::Widget::drawInterruption	(	View *	view,
		Rectangle *	area,
		DrawingContext *	context
	)

See Interrupted drawing for details.

Definition at line 201 of file widget.cc.

References dw::core::StackingProcessingContext::addWidgetProcessedAsInterruption(), draw(), dw::core::DrawingContext::getToplevelArea(), intersects(), layout, and dw::core::Layout::topLevel.

Referenced by dw::Textblock::drawLevel().

◆ drawSelected()

void dw::core::Widget::drawSelected	(	View *	view,
		Rectangle *	area
	)

Definition at line 1480 of file widget.cc.

◆ drawWidgetBox()

void dw::core::Widget::drawWidgetBox	(	View *	view,
		Rectangle *	area,
		bool	inverse
	)

Draw borders and background of a widget.

area is given in widget coordinates.

Definition at line 1429 of file widget.cc.

References allocation, dw::core::style::StyleAttrs::backgroundColor, bgColor, dw::core::style::drawBackground(), dw::core::style::drawBorder(), dw::core::Layout::getBgColor(), getMarginArea(), getPaddingArea(), dw::core::Rectangle::height, layout, parent, style, dw::core::Rectangle::width, dw::core::Rectangle::x, dw::core::Allocation::x, dw::core::Rectangle::y, and dw::core::Allocation::y.

Referenced by dw::Ruler::draw(), dw::SimpleContainer::draw(), dw::core::ui::Embed::draw(), and dw::oof::OOFAwareWidget::drawLevel().

◆ enterGetExtremes()

void dw::core::Widget::enterGetExtremes ( )

inlineprivate

Definition at line 441 of file widget.hh.

References dw::core::Layout::getExtremesCounter, and layout.

Referenced by getExtremes().

◆ enterNotify()

void dw::core::Widget::enterNotify ( EventCrossing * event )

Definition at line 1216 of file widget.cc.

References enterNotifyImpl().

Referenced by dw::core::Layout::enterNotify(), and dw::core::Layout::moveToWidget().

◆ enterNotifyImpl()

void dw::core::Widget::enterNotifyImpl ( EventCrossing * event )

protectedvirtual

Reimplemented in dw::Image, dw::Textblock, and dw::core::ui::Embed.

Definition at line 2002 of file widget.cc.

References getStyle(), dw::core::style::Tooltip::onEnter(), and dw::core::style::StyleAttrs::x_tooltip.

Referenced by enterNotify(), and dw::core::ui::Embed::enterNotifyImpl().

◆ enterQueueResize()

void dw::core::Widget::enterQueueResize ( )

inlineprivate

Definition at line 429 of file widget.hh.

References layout, and dw::core::Layout::queueResizeCounter.

Referenced by queueResize().

◆ enterSizeAllocate()

void dw::core::Widget::enterSizeAllocate ( )

inlineprivate

Definition at line 433 of file widget.hh.

References layout, and dw::core::Layout::sizeAllocateCounter.

Referenced by sizeAllocate().

◆ enterSizeRequest()

void dw::core::Widget::enterSizeRequest ( )

inlineprivate

Definition at line 437 of file widget.hh.

References layout, and dw::core::Layout::sizeRequestCounter.

Referenced by sizeRequest().

◆ extremesChanged()

bool dw::core::Widget::extremesChanged ( )

inline

Definition at line 460 of file widget.hh.

References EXTREMES_CHANGED, and flags.

Referenced by dw::Textblock::affectsSizeChangeContainerChild(), dw::Table::calcCellSizes(), containerSizeChanged(), getExtremes(), dw::oof::OOFAwareWidget::oofSizeChanged(), dw::Textblock::oofSizeChanged(), queueResize(), queueResize(), and queueResizeFast().

◆ extremesQueued()

bool dw::core::Widget::extremesQueued ( )

inline

Definition at line 456 of file widget.hh.

References EXTREMES_QUEUED, and flags.

Referenced by dw::Textblock::affectsSizeChangeContainerChild(), dw::Table::calcCellSizes(), containerSizeChanged(), getExtremes(), queueResize(), and dw::core::Layout::resizeIdle().

◆ getAdjustMinWidth()

virtual bool dw::core::Widget::getAdjustMinWidth ( )

inlinevirtual

Reimplemented in dw::AlignedTableCell, dw::Image, dw::SimpleTableCell, and dw::Table.

Definition at line 518 of file widget.hh.

References adjustMinWidth.

Referenced by getMinWidth().

◆ getAllocation()

Allocation * dw::core::Widget::getAllocation ( )

inline

Todo:: I do not like this.

Definition at line 470 of file widget.hh.

References allocation.

Referenced by dw::oof::OOFPositionedMgr::doChildrenExceedContainer(), dw::oof::OOFPositionedMgr::generatorPosX(), dw::oof::OOFPositionedMgr::generatorPosY(), dw::core::TextIterator::getAllocation(), dw::oof::OOFAwareWidget::OOFAwareWidgetIterator::getAllocationOOF(), dw::oof::OOFFloatsMgr::OOFFloatsMgr(), dw::oof::OOFPositionedMgr::OOFPositionedMgr(), dw::core::Layout::processMouseEvent(), and dw::Textblock::sizeAllocateImpl().

◆ getAvailHeight()

int dw::core::Widget::getAvailHeight ( bool forceValue )

Return available height including margin/border/padding (extraSpace?), not only the content height.

Definition at line 691 of file widget.cc.

References dw::core::style::absLengthVal(), applyPerHeight(), boxDiffHeight(), DBG_OBJ_ENTER, DBG_OBJ_LEAVE_VAL, DBG_OBJ_MSG, DBG_OBJ_MSG_END, DBG_OBJ_MSG_START, DBG_OBJ_MSGF, getAvailHeightOfChild(), getStyle(), dw::core::style::isAbsLength(), dw::core::style::isPerLength(), layout, parent, dw::core::style::perLengthVal_useThisOnlyForDebugging(), quasiParent, and dw::core::Layout::viewportHeight.

Referenced by calcHeight(), dw::core::ui::ComplexButtonResource::correctExtremesOfChild(), dw::core::ui::ComplexButtonResource::correctRequisitionOfChild(), dw::oof::OOFPosAbsLikeMgr::getAvailHeightOfChild(), dw::core::ui::ComplexButtonResource::getAvailHeightOfChild(), getAvailHeightOfChild(), dw::oof::OOFPosRelMgr::getChildPosY(), dw::oof::OOFPosAbsLikeMgr::getSize(), and dw::oof::OOFPosAbsLikeMgr::sizeAllocateChildren().

◆ getAvailHeightOfChild()

int dw::core::Widget::getAvailHeightOfChild	(	Widget *	child,
		bool	forceValue
	)

protectedvirtual

Reimplemented in dw::Textblock, and dw::core::ui::Embed.

Definition at line 1753 of file widget.cc.

References dw::core::style::absLengthVal(), applyPerHeight(), boxDiffHeight(), container, DBG_OBJ_ENTER, DBG_OBJ_LEAVE_VAL, DBG_OBJ_MSG, DBG_OBJ_MSG_END, DBG_OBJ_MSG_START, DBG_OBJ_MSGF, getAvailHeight(), getAvailHeightOfChild(), getStyle(), dw::core::style::StyleAttrs::height, dw::core::style::isAbsLength(), dw::core::style::isPerLength(), dw::core::style::LENGTH_AUTO, lout::misc::max(), parent, dw::core::style::perLengthVal_useThisOnlyForDebugging(), and quasiParent.

Referenced by getAvailHeight(), and getAvailHeightOfChild().

◆ getAvailWidth()

int dw::core::Widget::getAvailWidth ( bool forceValue )

Return available width including margin/border/padding (extraSpace?), not only the content width.

If the widget has a parent or a quasiParent, the width computation is delegated to the parent first, or the quasiParent later.

Definition at line 649 of file widget.cc.

References calcFinalWidth(), dw::core::Layout::canvasHeightGreater, DBG_OBJ_ENTER, DBG_OBJ_LEAVE_VAL, DBG_OBJ_MSG, DBG_OBJ_MSG_END, DBG_OBJ_MSG_START, getAvailWidthOfChild(), getStyle(), layout, parent, quasiParent, dw::core::Layout::viewportWidth, and dw::core::Layout::vScrollbarThickness.

Referenced by dw::Table::actuallyCalcCellSizes(), dw::Textblock::addWord(), calcWidth(), dw::tablecell::correctAvailWidthOfChild(), dw::tablecell::correctCorrectedRequisitionOfChild(), dw::oof::OOFPosAbsLikeMgr::getAvailWidthOfChild(), dw::Textblock::getAvailWidthOfChild(), dw::core::ui::ComplexButtonResource::getAvailWidthOfChild(), getAvailWidthOfChild(), dw::oof::OOFPosRelMgr::getChildPosX(), dw::oof::OOFPosAbsLikeMgr::getSize(), dw::oof::OOFPosAbsLikeMgr::sizeAllocateChildren(), dw::Textblock::sizeRequestImpl(), and dw::Ruler::sizeRequestSimpl().

◆ getAvailWidthOfChild()

int dw::core::Widget::getAvailWidthOfChild	(	Widget *	child,
		bool	forceValue
	)

protectedvirtual

Computes the content width available of a child widget.

Parameters

child	The child widget of which the available width will be computed.
forceValue	If true, computes the width of the child with value "auto". Otherwise, it wont.

Returns: The available width in pixels or -1.

Reimplemented in dw::Textblock, and dw::core::ui::Embed.

Definition at line 1696 of file widget.cc.

References boxDiffWidth(), calcFinalWidth(), calcWidth(), container, DBG_OBJ_ENTER, DBG_OBJ_LEAVE_VAL, DBG_OBJ_MSG, DBG_OBJ_MSG_END, DBG_OBJ_MSG_START, getAvailWidth(), getAvailWidthOfChild(), getStyle(), dw::core::style::LENGTH_AUTO, lout::misc::max(), dw::core::style::StyleAttrs::maxWidth, dw::core::style::StyleAttrs::minWidth, parent, quasiParent, and dw::core::style::StyleAttrs::width.

Referenced by getAvailWidth(), and getAvailWidthOfChild().

◆ getBgColor()

style::Color * dw::core::Widget::getBgColor ( )

Get the actual background of a widget.

Definition at line 1348 of file widget.cc.

References dw::core::style::StyleAttrs::backgroundColor, bgColor, dw::core::Layout::getBgColor(), layout, parent, and style.

Referenced by a_Html_image_new(), dw::Textblock::drawSpace(), and dw::Textblock::drawWord0().

◆ getBorderArea()

void dw::core::Widget::getBorderArea	(	int *	xBor,
		int *	yBor,
		int *	widthBor,
		int *	heightBor
	)

Definition at line 1591 of file widget.cc.

References dw::core::style::Box::bottom, getMarginArea(), dw::core::style::Box::left, dw::core::style::StyleAttrs::margin, dw::core::style::Box::right, style, and dw::core::style::Box::top.

Referenced by getPaddingArea().

◆ getContainer()

Widget * dw::core::Widget::getContainer ( )

inline

Definition at line 574 of file widget.hh.

References container.

◆ getContentHeight()

int dw::core::Widget::getContentHeight ( )

inlineprotected

Definition at line 207 of file widget.hh.

References boxDiffHeight(), and getHeight().

◆ getContentWidth()

int dw::core::Widget::getContentWidth ( )

inlineprotected

Definition at line 206 of file widget.hh.

References allocation, boxDiffWidth(), and dw::core::Allocation::width.

Referenced by dw::Table::drawLevel().

◆ getExtremes()

void dw::core::Widget::getExtremes	(	Extremes *	extremes,
		int	numPos = `0`,
		Widget **	references = `NULL`,
		int *	x = `NULL`,
		int *	y = `NULL`
	)

Wrapper for Widget::getExtremesImpl().

Definition at line 1014 of file widget.cc.

References dw::core::Extremes::adjustmentWidth, DBG_OBJ_ASSOC_CHILD, DBG_OBJ_ENTER, DBG_OBJ_LEAVE, DBG_OBJ_SET_NUM, enterGetExtremes(), extremes, EXTREMES_CHANGED, EXTREMES_QUEUED, extremesChanged(), extremesParams, extremesQueued(), getExtremesImpl(), dw::core::SizeParams::isEquivalent(), leaveGetExtremes(), dw::core::Extremes::maxWidth, dw::core::Extremes::maxWidthIntrinsic, dw::core::Extremes::minWidth, dw::core::Extremes::minWidthIntrinsic, queueResizeEntered(), setFlags(), and unsetFlags().

Referenced by dw::Table::actuallyCalcCellSizes(), dw::Textblock::getAvailWidthOfChild(), dw::oof::OOFPosAbsLikeMgr::getExtremes(), dw::oof::OOFPosRelMgr::getExtremes(), dw::SimpleContainer::getExtremesSimpl(), dw::oof::OOFFloatsMgr::getFloatsExtremes(), getMinWidth(), and dw::Textblock::getWordExtremes().

◆ getExtremesEntered()

bool dw::core::Widget::getExtremesEntered ( )

inlineprivate

Definition at line 443 of file widget.hh.

References dw::core::Layout::getExtremesCounter, and layout.

Referenced by sizeAllocate().

◆ getExtremesImpl()

void dw::core::Widget::getExtremesImpl	(	Extremes *	extremes,
		int	numPos,
		Widget **	references,
		int *	x,
		int *	y
	)

protectedvirtual

See Sizes of Dillo Widgets.

Definition at line 1633 of file widget.cc.

References DBG_OBJ_ENTER0, DBG_OBJ_LEAVE, extremes, and getExtremesSimpl().

Referenced by getExtremes().

◆ getExtremesReference()

Widget * dw::core::Widget::getExtremesReference ( int index )

virtual

See Sizes of Dillo Widgets (or Size requisitions depending on positions).

Reimplemented in dw::Textblock.

Definition at line 1116 of file widget.cc.

References lout::misc::notImplemented().

◆ getExtremesSimpl()

void dw::core::Widget::getExtremesSimpl ( Extremes * extremes )

protectedvirtual

Simple variant, to be implemented by widgets with extremes not depending on positions.

Reimplemented in dw::Bullet, dw::Image, dw::Ruler, dw::Table, dw::Textblock, dw::SimpleContainer, and dw::core::ui::Embed.

Definition at line 1642 of file widget.cc.

References lout::misc::notImplemented().

Referenced by getExtremesImpl().

◆ getFgColor()

style::Color * dw::core::Widget::getFgColor ( )

Get the actual foreground color of a widget.

Definition at line 1367 of file widget.cc.

References dw::core::style::StyleAttrs::color, parent, and style.

Referenced by a_Html_image_new().

◆ getGenerator()

Widget * dw::core::Widget::getGenerator ( )

inline

Definition at line 586 of file widget.hh.

References generator, and parent.

Referenced by getGeneratorLevel(), and dw::core::DeepIterator::getRespectiveParent().

◆ getGeneratorLevel()

int dw::core::Widget::getGeneratorLevel ( )

Get the level of the widget within the tree, regarting the generators, not the parents.

The root widget has the level 0.

Definition at line 1529 of file widget.cc.

References getGenerator().

Referenced by dw::core::DeepIterator::getRespectiveLevel().

◆ getHeight()

int dw::core::Widget::getHeight ( )

inlineprotected

Definition at line 205 of file widget.hh.

References allocation, dw::core::Allocation::ascent, and dw::core::Allocation::descent.

Referenced by dw::core::Layout::draw(), getContentHeight(), getMarginArea(), inAllocation(), queueDraw(), dw::Table::resizeDrawImpl(), and dw::Textblock::resizeDrawImpl().

◆ getLayout()

Layout * dw::core::Widget::getLayout ( )

inline

Definition at line 588 of file widget.hh.

References layout.

Referenced by a_Html_image_new(), and dw::core::Iterator::scrollTo().

◆ getLevel()

int dw::core::Widget::getLevel ( )

Get the level of the widget within the tree.

The root widget has the level 0.

Definition at line 1510 of file widget.cc.

References parent.

Referenced by dw::oof::OOFAwareWidget::doesWidgetOOFInterruptDrawing(), getNearestCommonAncestor(), and dw::core::DeepIterator::getRespectiveLevel().

◆ getMarginArea()

void dw::core::Widget::getMarginArea	(	int *	xMar,
		int *	yMar,
		int *	widthMar,
		int *	heightMar
	)

Definition at line 1583 of file widget.cc.

References allocation, dw::core::style::Box::bottom, extraSpace, getHeight(), dw::core::style::Box::left, dw::core::style::Box::right, dw::core::style::Box::top, dw::core::Allocation::width, dw::core::Allocation::x, and dw::core::Allocation::y.

Referenced by drawWidgetBox(), and getBorderArea().

◆ getMinWidth()

int dw::core::Widget::getMinWidth	(	Extremes *	extremes,
		bool	forceValue
	)

Used to evaluate Widget::adjustMinWidth.

If extremes == NULL, getExtremes is called. ForceValue is the same value passed to getAvailWidth etc.; if false, getExtremes is not called. A value of "false" is passed for "useCorrected" in the context of correctExtemes etc., to avoid cyclic dependencies.

Definition at line 604 of file widget.cc.

References dw::core::Extremes::adjustmentWidth, DBG_IF_RTFL, DBG_OBJ_ENTER, DBG_OBJ_LEAVE_VAL, extremes, getAdjustMinWidth(), getExtremes(), dw::core::Extremes::maxWidth, dw::core::Extremes::maxWidthIntrinsic, dw::core::Extremes::minWidth, and dw::core::Extremes::minWidthIntrinsic.

Referenced by correctExtremes(), correctExtremesOfChild(), correctRequisition(), correctReqWidthOfChild(), and dw::oof::OOFPosAbsLikeMgr::getAvailWidthOfChild().

◆ getNearestCommonAncestor()

Widget * dw::core::Widget::getNearestCommonAncestor ( Widget * otherWidget )

Get the widget with the highest level, which is a direct ancestor of widget1 and widget2.

Definition at line 1546 of file widget.cc.

References getLevel(), MSG_WARN, and parent.

Referenced by dw::core::Layout::moveToWidget().

◆ getNextStackingContextMgr()

StackingContextMgr * dw::core::Widget::getNextStackingContextMgr ( )

inlineprotected

Definition at line 233 of file widget.hh.

References stackingContextMgr, and stackingContextWidget.

◆ getPaddingArea()

void dw::core::Widget::getPaddingArea	(	int *	xPad,
		int *	yPad,
		int *	widthPad,
		int *	heightPad
	)

Return the padding area (content plus padding).

Used as "reference area" (ee comment of "style::drawBackground") for backgrounds.

Definition at line 1607 of file widget.cc.

References dw::core::style::StyleAttrs::borderWidth, dw::core::style::Box::bottom, getBorderArea(), dw::core::style::Box::left, dw::core::style::Box::right, style, and dw::core::style::Box::top.

Referenced by drawBox(), and drawWidgetBox().

◆ getParent()

Widget * dw::core::Widget::getParent ( )

inline

Definition at line 573 of file widget.hh.

References parent.

Referenced by dw::Textblock::addParbreak(), DilloHtml::HtmlLinkReceiver::click(), dw::oof::OOFPosAbsMgr::containerBoxOffsetX(), dw::oof::OOFPosAbsMgr::containerBoxOffsetY(), dw::oof::OOFPosAbsMgr::containerBoxRestHeight(), dw::oof::OOFPosAbsMgr::containerBoxRestWidth(), dw::core::DeepIterator::getRespectiveParent(), dw::core::StackingContextMgr::handledByStackingContextMgr(), dw::Textblock::handOverBreak(), dw::oof::OOFAwareWidget::isOOFContainer(), dw::core::Layout::moveToWidget(), dw::oof::OOFAwareWidget::notifySetParent(), dw::core::Layout::processMouseEvent(), setParent(), and dw::Textblock::usesMaxGeneratorWidth().

◆ getStyle()

style::Style * dw::core::Widget::getStyle ( )

inline

Definition at line 468 of file widget.hh.

References style.

◆ getTopLevel()

Widget * dw::core::Widget::getTopLevel ( )

Get the widget at the root of the tree, this widget is part from.

Definition at line 1495 of file widget.cc.

References parent.

Referenced by dw::core::Layout::moveToWidget().

◆ getWidgetAtPoint()

Widget * dw::core::Widget::getWidgetAtPoint	(	int	x,
		int	y,
		GettingWidgetAtPointContext *	context
	)

virtual

Reimplemented in dw::oof::OOFAwareWidget, and dw::Ruler.

Definition at line 211 of file widget.cc.

References inAllocation().

Referenced by dw::oof::OOFFloatsMgr::getFloatWidgetAtPoint(), dw::core::Layout::getWidgetAtPoint(), dw::oof::OOFPositionedMgr::getWidgetAtPoint(), dw::core::StackingContextMgr::getWidgetAtPoint(), getWidgetAtPointInterrupted(), and dw::Textblock::getWidgetAtPointLevel().

◆ getWidgetAtPointInterrupted()

Widget * dw::core::Widget::getWidgetAtPointInterrupted	(	int	x,
		int	y,
		GettingWidgetAtPointContext *	context
	)

Definition at line 222 of file widget.cc.

References dw::core::StackingProcessingContext::addWidgetProcessedAsInterruption(), and getWidgetAtPoint().

Referenced by dw::Textblock::getWidgetAtPointLevel().

◆ getWidgetReference()

WidgetReference * dw::core::Widget::getWidgetReference ( )

inline

Definition at line 580 of file widget.hh.

References widgetReference.

Referenced by dw::oof::OOFFloatsMgr::updateGenerators().

◆ inAllocation()

bool dw::core::Widget::inAllocation	(	int	x,
		int	y
	)

inline

Definition at line 471 of file widget.hh.

References allocation, getHeight(), wasAllocated(), dw::core::Allocation::width, dw::core::Allocation::x, and dw::core::Allocation::y.

Referenced by dw::oof::OOFAwareWidget::getWidgetAtPoint(), dw::Ruler::getWidgetAtPoint(), getWidgetAtPoint(), and dw::oof::OOFAwareWidget::getWidgetAtPointLevel().

◆ intersects()

bool dw::core::Widget::intersects	(	Widget *	refWidget,
		Rectangle *	area,
		Rectangle *	intersection
	)

Calculates the intersection of the visible allocation (i.

e. the intersection with the visible parent allocation) and "area" (in widget coordinates referring to "refWidget"), returned in intersection (in widget coordinates).

Typically used by containers when drawing their children (passing "this" as "refWidget"). Returns whether intersection is not empty.

Definition at line 139 of file widget.cc.

References allocation, DBG_OBJ_ENTER, DBG_OBJ_LEAVE_VAL, DBG_OBJ_LEAVE_VAL0, DBG_OBJ_MSG, DBG_OBJ_MSGF, dw::core::Rectangle::height, dw::core::Rectangle::intersectsWith(), parent, wasAllocated(), dw::core::Rectangle::width, dw::core::Rectangle::x, dw::core::Allocation::x, dw::core::Rectangle::y, and dw::core::Allocation::y.

Referenced by dw::oof::OOFPositionedMgr::draw(), dw::SimpleContainer::draw(), dw::core::StackingContextMgr::draw(), dw::oof::OOFFloatsMgr::drawFloats(), drawInterruption(), and dw::Textblock::drawLine().

◆ isBlockLevel()

bool dw::core::Widget::isBlockLevel ( )

virtual

Reimplemented in dw::AlignedTableCell, dw::Ruler, dw::SimpleTableCell, dw::Table, and dw::Textblock.

Definition at line 1975 of file widget.cc.

Referenced by dw::Textblock::initLine1Offset(), and isPossibleContainer().

◆ isButtonSensitive()

bool dw::core::Widget::isButtonSensitive ( )

inline

Definition at line 571 of file widget.hh.

References buttonSensitive.

Referenced by dw::core::Layout::processMouseEvent().

◆ isPossibleContainer()

bool dw::core::Widget::isPossibleContainer ( )

virtual

Definition at line 1981 of file widget.cc.

References isBlockLevel().

◆ iterator()

virtual Iterator * dw::core::Widget::iterator	(	Content::Type	mask,
		bool	atEnd
	)

pure virtual

Return an iterator for this widget.

mask can narrow the types returned by the iterator, this can enhance performance quite much, e.g. when only searching for child widgets.

With atEnd == false, the iterator starts before the beginning, i.e. the first call of dw::core::Iterator::next will let the iterator point on the first piece of contents. Likewise, With atEnd == true, the iterator starts after the last piece of contents, call dw::core::Iterator::prev in this case.

Implemented in dw::core::ui::Embed, dw::Bullet, dw::Image, dw::Ruler, dw::Table, dw::Textblock, and dw::SimpleContainer.

Referenced by dw::core::CharIterator::CharIterator(), containerSizeChangedForChildren(), dw::core::DeepIterator::DeepIterator(), dw::core::Layout::detachWidget(), dw::core::DeepIterator::next(), dw::core::DeepIterator::prev(), dw::core::DeepIterator::searchDownward(), and dw::core::DeepIterator::searchSideward().

◆ leaveGetExtremes()

void dw::core::Widget::leaveGetExtremes ( )

inlineprivate

Definition at line 442 of file widget.hh.

References dw::core::Layout::getExtremesCounter, and layout.

Referenced by getExtremes().

◆ leaveNotify()

void dw::core::Widget::leaveNotify ( EventCrossing * event )

Definition at line 1221 of file widget.cc.

References leaveNotifyImpl().

Referenced by dw::core::Layout::leaveNotify(), and dw::core::Layout::moveToWidget().

◆ leaveNotifyImpl()

void dw::core::Widget::leaveNotifyImpl ( EventCrossing * event )

protectedvirtual

Reimplemented in dw::Image, dw::Textblock, and dw::core::ui::Embed.

Definition at line 2010 of file widget.cc.

References getStyle(), dw::core::style::Tooltip::onLeave(), and dw::core::style::StyleAttrs::x_tooltip.

Referenced by leaveNotify(), and dw::core::ui::Embed::leaveNotifyImpl().

◆ leaveQueueResize()

void dw::core::Widget::leaveQueueResize ( )

inlineprivate

Definition at line 430 of file widget.hh.

References layout, and dw::core::Layout::queueResizeCounter.

Referenced by queueResize().

◆ leaveSizeAllocate()

void dw::core::Widget::leaveSizeAllocate ( )

inlineprivate

Definition at line 434 of file widget.hh.

References layout, and dw::core::Layout::sizeAllocateCounter.

Referenced by sizeAllocate().

◆ leaveSizeRequest()

void dw::core::Widget::leaveSizeRequest ( )

inlineprivate

Definition at line 438 of file widget.hh.

References layout, and dw::core::Layout::sizeRequestCounter.

Referenced by sizeRequest().

◆ markExtremesChange()

void dw::core::Widget::markExtremesChange ( int ref )

protectedvirtual

See Sizes of Dillo Widgets.

Reimplemented in dw::Textblock.

Definition at line 1670 of file widget.cc.

Referenced by queueResize().

◆ markSizeChange()

void dw::core::Widget::markSizeChange ( int ref )

protectedvirtual

See Sizes of Dillo Widgets.

Reimplemented in dw::Textblock.

Definition at line 1666 of file widget.cc.

Referenced by queueResize().

◆ motionNotify()

bool dw::core::Widget::motionNotify ( EventMotion * event )

Definition at line 1211 of file widget.cc.

References motionNotifyImpl().

Referenced by dw::core::Layout::processMouseEvent().

◆ motionNotifyImpl()

bool dw::core::Widget::motionNotifyImpl ( EventMotion * event )

protectedvirtual

Reimplemented in dw::Image, and dw::Textblock.

Definition at line 1997 of file widget.cc.

Referenced by motionNotify().

◆ needsAllocate()

bool dw::core::Widget::needsAllocate ( )

inline

Definition at line 458 of file widget.hh.

References flags, and NEEDS_ALLOCATE.

Referenced by dw::core::Layout::resizeIdle(), and sizeAllocate().

◆ needsResize()

bool dw::core::Widget::needsResize ( )

inline

Definition at line 457 of file widget.hh.

References flags, and NEEDS_RESIZE.

Referenced by dw::Table::calcCellSizes(), containerSizeChanged(), queueResize(), dw::core::Layout::resizeIdle(), and sizeRequest().

◆ notifySetAsTopLevel()

void dw::core::Widget::notifySetAsTopLevel ( )

protectedvirtual

This method is called after a widget has been set as the top of a widget tree.

A widget may override this method when it is necessary to be notified.

Reimplemented in dw::oof::OOFAwareWidget, and dw::Textblock.

Definition at line 1962 of file widget.cc.

Referenced by dw::core::Layout::addWidget().

◆ notifySetParent()

void dw::core::Widget::notifySetParent ( )

protectedvirtual

This method is called after a widget has been added to a parent.

A widget may override this method when it is necessary to be notified.

Reimplemented in dw::oof::OOFAwareWidget, and dw::Textblock.

Definition at line 1971 of file widget.cc.

Referenced by setParent().

◆ numGetExtremesReferences()

int dw::core::Widget::numGetExtremesReferences ( )

virtual

See Sizes of Dillo Widgets (or Size requisitions depending on positions).

Reimplemented in dw::Textblock.

Definition at line 1111 of file widget.cc.

◆ numSizeRequestReferences()

int dw::core::Widget::numSizeRequestReferences ( )

virtual

See Sizes of Dillo Widgets (or Size requisitions depending on positions).

Reimplemented in dw::Textblock.

Definition at line 1100 of file widget.cc.

Referenced by dw::core::SizeParams::forChild().

◆ printFlag()

void dw::core::Widget::printFlag ( Flags f )

inlineprotected

Definition at line 251 of file widget.hh.

References ALLOCATE_QUEUED, DBG_IF_RTFL, DBG_OBJ_SET_SYM, EXTREMES_CHANGED, EXTREMES_QUEUED, flags, NEEDS_ALLOCATE, NEEDS_RESIZE, RESIZE_QUEUED, and WAS_ALLOCATED.

Referenced by setFlags(), and unsetFlags().

◆ queueDraw()

void dw::core::Widget::queueDraw ( )

inlineprotected

Definition at line 297 of file widget.hh.

References allocation, getHeight(), queueDrawArea(), and dw::core::Allocation::width.

Referenced by dw::Image::forceMapRedraw(), resizeDrawImpl(), and setStyle().

◆ queueDrawArea()

void dw::core::Widget::queueDrawArea	(	int	x,
		int	y,
		int	width,
		int	height
	)

protected

Todo:: Maybe only the intersection?

Definition at line 285 of file widget.cc.

References _MSG, allocation, dw::core::Allocation::ascent, DBG_OBJ_ENTER, DBG_OBJ_LEAVE, dw::core::Allocation::descent, layout, dw::core::Layout::queueDraw(), dw::core::Allocation::width, dw::core::Allocation::x, and dw::core::Allocation::y.

Referenced by dw::Textblock::changeLinkColor(), queueDraw(), dw::Textblock::queueDrawRange(), dw::Table::resizeDrawImpl(), and dw::Textblock::resizeDrawImpl().

◆ queueResize() [1/2]

void dw::core::Widget::queueResize	(	int	ref,
		bool	extremesChanged
	)

inlineprotected

Definition at line 300 of file widget.hh.

References extremesChanged(), and queueResize().

◆ queueResize() [2/2]

void dw::core::Widget::queueResize	(	int	ref,
		bool	extremesChanged,
		bool	fast
	)

private

This method should be called, when a widget changes its size.

A "fast" queueResize will ignore the ancestors, and furthermore not trigger the idle function. Used only within viewportSizeChanged, and not available outside Layout and Widget.

Definition at line 309 of file widget.cc.

References ALLOCATE_QUEUED, DBG_IF_RTFL, DBG_OBJ_ENTER, DBG_OBJ_LEAVE, DBG_OBJ_MSGF, enterQueueResize(), EXTREMES_CHANGED, EXTREMES_QUEUED, extremesChanged(), extremesQueued(), layout, leaveQueueResize(), markExtremesChange(), markSizeChange(), NEEDS_RESIZE, needsResize(), parent, parentRef, dw::core::Layout::queueResize(), dw::core::Layout::queueResizeList, RESIZE_QUEUED, resizeQueued(), and setFlags().

Referenced by dw::Table::addCell(), dw::Textblock::addParbreak(), dw::core::Layout::addWidget(), dw::Textblock::flush(), dw::oof::OOFAwareWidget::oofSizeChanged(), dw::Textblock::oofSizeChanged(), dw::core::ui::Resource::queueResize(), queueResize(), queueResizeFast(), dw::SimpleContainer::removeChild(), dw::SimpleContainer::setChild(), dw::AlignedTableCell::setMaxValue(), dw::ListItem::setMaxValue(), setStyle(), dw::Textblock::updateReference(), and dw::Textblock::widgetRefSizeChanged().

◆ queueResizeEntered()

bool dw::core::Widget::queueResizeEntered ( )

inlineprivate

Definition at line 431 of file widget.hh.

References layout, and dw::core::Layout::queueResizeCounter.

Referenced by getExtremes(), sizeAllocate(), and sizeRequest().

◆ queueResizeFast()

void dw::core::Widget::queueResizeFast	(	int	ref,
		bool	extremesChanged
	)

inlineprivate

Definition at line 185 of file widget.hh.

References extremesChanged(), and queueResize().

Referenced by containerSizeChanged().

◆ removeAnchor()

void dw::core::Widget::removeAnchor ( char * name )

inlineprotected

Definition at line 392 of file widget.hh.

References layout, and dw::core::Layout::removeAnchor().

Referenced by dw::Textblock::~Textblock().

◆ removeChild()

void dw::core::Widget::removeChild ( Widget * child )

virtual

Definition at line 2019 of file widget.cc.

References lout::misc::notImplemented().

Referenced by ~Widget().

◆ resizeDrawImpl()

virtual void dw::core::Widget::resizeDrawImpl ( )

inlineprotectedvirtual

Called after sizeAllocateImpl() to redraw necessary areas.

By default the whole widget is redrawn.

Reimplemented in dw::Table, and dw::Textblock.

Definition at line 339 of file widget.hh.

References queueDraw().

Referenced by sizeAllocate().

◆ resizeIdleEntered()

bool dw::core::Widget::resizeIdleEntered ( )

inlineprivate

Definition at line 427 of file widget.hh.

References layout, and dw::core::Layout::resizeIdleCounter.

Referenced by sizeAllocate().

◆ resizeQueued()

bool dw::core::Widget::resizeQueued ( )

inline

Definition at line 455 of file widget.hh.

References flags, and RESIZE_QUEUED.

Referenced by dw::Table::calcCellSizes(), containerSizeChanged(), queueResize(), dw::core::Layout::resizeIdle(), and sizeRequest().

◆ scrollTo()

void dw::core::Widget::scrollTo	(	HPosition	hpos,
		VPosition	vpos,
		int	x,
		int	y,
		int	width,
		int	height
	)

Definition at line 1576 of file widget.cc.

References allocation, layout, dw::core::Layout::scrollTo(), dw::core::Allocation::x, and dw::core::Allocation::y.

◆ selectionHandleEvent()

bool dw::core::Widget::selectionHandleEvent	(	SelectionState::EventType	eventType,
		Iterator *	it,
		int	charPos,
		int	linkNo,
		MousePositionEvent *	event
	)

inlineprotected

Definition at line 412 of file widget.hh.

References dw::core::SelectionState::handleEvent(), layout, and dw::core::Layout::selectionState.

Referenced by dw::Textblock::sendSelectionEvent().

◆ setAdjustMinWidth()

static void dw::core::Widget::setAdjustMinWidth ( bool adjustMinWidth )

inlinestatic

Definition at line 449 of file widget.hh.

References adjustMinWidth.

Referenced by main().

◆ setBgColor()

void dw::core::Widget::setBgColor ( style::Color * bgColor )

Set the background "behind" the widget, if it is not the background of the parent widget, e.g.

the background of a table row.

Definition at line 1340 of file widget.cc.

References bgColor.

◆ setButtonSensitive()

void dw::core::Widget::setButtonSensitive ( bool buttonSensitive )

Definition at line 1485 of file widget.cc.

References buttonSensitive, and buttonSensitiveSet.

Referenced by dw::AlignedTableCell::AlignedTableCell(), dw::Table::Table(), and dw::Textblock::Textblock().

◆ setCursor()

void dw::core::Widget::setCursor ( style::Cursor cursor )

inlineprotected

Definition at line 397 of file widget.hh.

References layout, and dw::core::Layout::setCursor().

Referenced by dw::Textblock::motionNotifyImpl().

◆ setDeleteCallback()

void dw::core::Widget::setDeleteCallback	(	DW_Callback_t	func,
		void *	data
	)

inline

Definition at line 423 of file widget.hh.

References deleteCallbackData, and deleteCallbackFunc.

◆ setFlags()

void dw::core::Widget::setFlags ( Flags f )

inlineprotected

Definition at line 292 of file widget.hh.

References flags, and printFlag().

Referenced by getExtremes(), queueResize(), dw::core::Layout::resizeIdle(), sizeAllocate(), and sizeRequest().

◆ setGenerator()

void dw::core::Widget::setGenerator ( Widget * generator )

inline

Definition at line 466 of file widget.hh.

References generator.

Referenced by dw::Textblock::addWidget().

◆ setParent()

void dw::core::Widget::setParent ( Widget * parent )

Definition at line 231 of file widget.cc.

References dw::core::StackingContextMgr::addChildSCWidget(), buttonSensitive, buttonSensitiveSet, container, DBG_OBJ_ASSOC_PARENT, DBG_OBJ_ENTER, DBG_OBJ_LEAVE, DBG_OBJ_SET_PTR, getParent(), layout, notifySetParent(), parent, stackingContextMgr, and stackingContextWidget.

Referenced by dw::Textblock::addWidget(), and dw::SimpleContainer::setChild().

◆ setQuasiParent()

void dw::core::Widget::setQuasiParent ( Widget * quasiParent )

Definition at line 276 of file widget.cc.

References DBG_OBJ_SET_PTR, and quasiParent.

◆ setStyle()

void dw::core::Widget::setStyle ( style::Style * style )

virtual

Change the style of a widget.

The old style is automatically unreferred, the new is referred. If this call causes the widget to change its size, dw::core::Widget::queueResize is called.

Reimplemented in dw::core::ui::Embed.

Definition at line 1233 of file widget.cc.

Referenced by dw::Textblock::addWidget(), dw::Textblock::changeLinkColor(), Html_input_image(), Html_set_collapsing_border_model(), Html_set_separate_border_model(), Html_tag_content_hr(), Html_tag_open_body(), Html_tag_open_button(), main(), dw::core::ui::Embed::setStyle(), and textTimeout().

◆ setWidgetReference()

void dw::core::Widget::setWidgetReference ( WidgetReference * widgetReference )

inline

Definition at line 581 of file widget.hh.

References DBG_OBJ_SET_PTR, and widgetReference.

Referenced by dw::Textblock::addWidget(), and Widget().

◆ sizeAllocate()

void dw::core::Widget::sizeAllocate ( Allocation * allocation )

Wrapper for Widget::sizeAllocateImpl, calls the latter only when needed.

Definition at line 1126 of file widget.cc.

References allocation, dw::core::Allocation::ascent, DBG_OBJ_ENTER, DBG_OBJ_LEAVE, DBG_OBJ_MSGF, DBG_OBJ_SET_NUM, dw::core::Allocation::descent, enterSizeAllocate(), getExtremesEntered(), layout, leaveSizeAllocate(), NEEDS_ALLOCATE, needsAllocate(), dw::core::Layout::queueDrawExcept(), queueResizeEntered(), resizeDrawImpl(), resizeIdleEntered(), setFlags(), sizeAllocateImpl(), sizeRequestEntered(), unsetFlags(), WAS_ALLOCATED, wasAllocated(), dw::core::Allocation::width, dw::core::Allocation::x, and dw::core::Allocation::y.

Referenced by dw::core::Layout::resizeIdle(), dw::oof::OOFPosAbsLikeMgr::sizeAllocateChildren(), dw::oof::OOFPosRelMgr::sizeAllocateChildren(), dw::oof::OOFFloatsMgr::sizeAllocateFloats(), dw::Textblock::sizeAllocateImpl(), and dw::SimpleContainer::sizeAllocateImpl().

◆ sizeAllocateEntered()

bool dw::core::Widget::sizeAllocateEntered ( )

inlineprivate

Definition at line 435 of file widget.hh.

References layout, and dw::core::Layout::sizeAllocateCounter.

◆ sizeAllocateImpl()

void dw::core::Widget::sizeAllocateImpl ( Allocation * allocation )

protectedvirtual

See Sizes of Dillo Widgets.

Reimplemented in dw::core::ui::Embed, dw::Image, dw::Table, dw::Textblock, and dw::SimpleContainer.

Definition at line 1648 of file widget.cc.

Referenced by sizeAllocate().

◆ sizeRequest()

void dw::core::Widget::sizeRequest	(	Requisition *	requisition,
		int	numPos = `0`,
		Widget **	references = `NULL`,
		int *	x = `NULL`,
		int *	y = `NULL`
	)

This method is a wrapper for Widget::sizeRequestImpl(); it calls the latter only when needed.

Todo:: Check requisition == &(this->requisition) and do what?

Definition at line 534 of file widget.cc.

References dw::core::Requisition::ascent, lout::misc::boolToStr(), calcExtraSpace(), DBG_IF_RTFL, DBG_OBJ_ASSOC_CHILD, DBG_OBJ_ENTER, DBG_OBJ_LEAVE, DBG_OBJ_MSG_END, DBG_OBJ_MSG_START, DBG_OBJ_MSGF, DBG_OBJ_SET_NUM, dw::core::Requisition::descent, enterSizeRequest(), dw::core::SizeParams::isEquivalent(), leaveSizeRequest(), NEEDS_RESIZE, needsResize(), queueResizeEntered(), requisition, requisitionParams, RESIZE_QUEUED, resizeQueued(), setFlags(), sizeRequestImpl(), unsetFlags(), and dw::core::Requisition::width.

Referenced by dw::oof::OOFPosAbsLikeMgr::calcPosAndSizeChildOfChild(), dw::oof::OOFPosRelMgr::calcWidgetRefSize(), dw::oof::OOFPositionedMgr::doChildrenExceedContainer(), dw::oof::OOFFloatsMgr::ensureFloatSize(), dw::oof::OOFPosRelMgr::getSize(), dw::core::Layout::resizeIdle(), dw::oof::OOFPosRelMgr::sizeAllocateChildren(), and dw::SimpleContainer::sizeRequestSimpl().

◆ sizeRequestEntered()

bool dw::core::Widget::sizeRequestEntered ( )

inlineprivate

Definition at line 439 of file widget.hh.

References layout, and dw::core::Layout::sizeRequestCounter.

Referenced by sizeAllocate().

◆ sizeRequestImpl()

void dw::core::Widget::sizeRequestImpl	(	Requisition *	requisition,
		int	numPos,
		Widget **	references,
		int *	x,
		int *	y
	)

protectedvirtual

See Sizes of Dillo Widgets.

Definition at line 1618 of file widget.cc.

References DBG_OBJ_ENTER0, DBG_OBJ_LEAVE, requisition, and sizeRequestSimpl().

Referenced by sizeRequest().

◆ sizeRequestReference()

Widget * dw::core::Widget::sizeRequestReference ( int index )

virtual

See Sizes of Dillo Widgets (or Size requisitions depending on positions).

Reimplemented in dw::Textblock.

Definition at line 1105 of file widget.cc.

References lout::misc::notImplemented().

Referenced by dw::core::SizeParams::forChild().

◆ sizeRequestSimpl()

void dw::core::Widget::sizeRequestSimpl ( Requisition * requisition )

protectedvirtual

Simple variant, to be implemented by widgets with sizes not depending on positions.

Reimplemented in dw::Bullet, dw::Image, dw::Ruler, dw::Table, dw::SimpleContainer, and dw::core::ui::Embed.

Definition at line 1627 of file widget.cc.

References lout::misc::notImplemented().

Referenced by sizeRequestImpl().

◆ unsetFlags()

void dw::core::Widget::unsetFlags ( Flags f )

inlineprotected

Definition at line 294 of file widget.hh.

References flags, and printFlag().

Referenced by getExtremes(), dw::core::Layout::resizeIdle(), sizeAllocate(), and sizeRequest().

◆ usesAvailHeight()

bool dw::core::Widget::usesAvailHeight ( )

protectedvirtual

Must be implemengted by a method returning true, when getAvailHeight() is called.

Definition at line 525 of file widget.cc.

Referenced by affectedByContainerSizeChange(), and affectsSizeChangeContainerChild().

◆ usesAvailWidth()

bool dw::core::Widget::usesAvailWidth ( )

protectedvirtual

Must be implemengted by a method returning true, when getAvailWidth() is called.

Reimplemented in dw::Ruler, dw::Table, and dw::Textblock.

Definition at line 516 of file widget.cc.

Referenced by affectedByContainerSizeChange(), and affectsSizeChangeContainerChild().

◆ wasAllocated()

bool dw::core::Widget::wasAllocated ( )

inline

Definition at line 461 of file widget.hh.

References flags, and WAS_ALLOCATED.

Referenced by dw::Textblock::addAnchor(), dw::Textblock::findLineIndex(), dw::Textblock::findLineIndexWhenAllocated(), dw::oof::OOFPositionedMgr::generatorPosDefined(), dw::core::Layout::getWidgetAtPoint(), inAllocation(), intersects(), dw::oof::OOFPositionedMgr::OOFPositionedMgr(), dw::Textblock::WordImgRenderer::readyToDraw(), dw::core::Widget::WidgetImgRenderer::readyToDraw(), sizeAllocate(), and dw::Textblock::sizeAllocateImpl().

Friends And Related Symbol Documentation

◆ Layout

friend class Layout

friend

Definition at line 45 of file widget.hh.

Member Data Documentation

◆ adjustMinWidth

bool dw::core::Widget::adjustMinWidth = true

staticprivate

Definition at line 122 of file widget.hh.

Referenced by getAdjustMinWidth(), and setAdjustMinWidth().

◆ allocation

Allocation dw::core::Widget::allocation

protected

The current allocation: size and position, always relative to the canvas.

Definition at line 203 of file widget.hh.

Referenced by dw::Textblock::addAnchor(), dw::Textblock::changeLinkColor(), dw::Bullet::draw(), dw::core::Layout::draw(), drawBox(), dw::Textblock::drawSpace(), drawWidgetBox(), dw::Textblock::drawWord0(), dw::Textblock::findLineIndexWhenAllocated(), getAllocation(), dw::Table::TableIterator::getAllocation(), dw::Textblock::TextblockIterator::getAllocation(), dw::oof::OOFAwareWidget::OOFAwareWidgetIterator::getAllocationOOF(), getContentWidth(), getHeight(), getMarginArea(), dw::Textblock::getWidgetAtPointLevel(), inAllocation(), intersects(), dw::Textblock::lineYOffsetCanvas(), dw::Textblock::lineYOffsetCanvas(), dw::Textblock::lineYOffsetWidget(), dw::Textblock::lineYOffsetWidget(), dw::Textblock::lineYOffsetWidget(), queueDraw(), queueDrawArea(), dw::Textblock::queueDrawRange(), dw::Table::resizeDrawImpl(), dw::Textblock::resizeDrawImpl(), scrollTo(), sizeAllocate(), dw::core::ui::Embed::sizeAllocateImpl(), dw::Table::sizeAllocateImpl(), dw::Textblock::sizeAllocateImpl(), dw::SimpleContainer::sizeAllocateImpl(), dw::oof::OOFAwareWidget::sizeAllocateStart(), and Widget().

◆ bgColor

style::Color* dw::core::Widget::bgColor

private

See dw::core::Widget::setBgColor().

Definition at line 172 of file widget.hh.

Referenced by drawWidgetBox(), getBgColor(), setBgColor(), and Widget().

◆ buttonSensitive

bool dw::core::Widget::buttonSensitive

private

See dw::core::Widget::setButtonSensitive().

Definition at line 177 of file widget.hh.

Referenced by isButtonSensitive(), setButtonSensitive(), setParent(), and Widget().

◆ buttonSensitiveSet

bool dw::core::Widget::buttonSensitiveSet

private

See dw::core::Widget::setButtonSensitive().

Definition at line 182 of file widget.hh.

Referenced by setButtonSensitive(), setParent(), and Widget().

◆ CLASS_ID

int dw::core::Widget::CLASS_ID = -1

static

Definition at line 447 of file widget.hh.

Referenced by Widget().

◆ container

Widget* dw::core::Widget::container

private

The containing widget, equivalent to the "containing block" defined by CSS.

May be NULL, in this case the viewport is used.

Definition at line 146 of file widget.hh.

Referenced by dw::core::Layout::addWidget(), affectedByContainerSizeChange(), containerSizeChanged(), correctExtremes(), correctExtremesOfChild(), correctReqHeightOfChild(), correctRequisitionOfChild(), correctReqWidthOfChild(), getAvailHeightOfChild(), getAvailWidthOfChild(), getContainer(), dw::Textblock::getGeneratorRest(), setParent(), and Widget().

◆ deleteCallbackData

void* dw::core::Widget::deleteCallbackData

private

Definition at line 419 of file widget.hh.

Referenced by setDeleteCallback(), Widget(), and ~Widget().

◆ deleteCallbackFunc

DW_Callback_t dw::core::Widget::deleteCallbackFunc

private

Definition at line 420 of file widget.hh.

Referenced by setDeleteCallback(), Widget(), and ~Widget().

◆ extraSpace

style::Box dw::core::Widget::extraSpace

protected

Space around the margin box.

Allocation is extraSpace + margin + border + padding + contents.

See also dw::core::Widget::calcExtraSpace and dw::core::Widget::calcExtraSpaceImpl. Also, it is feasible to correct this value within dw::core::Widget::sizeRequestImpl.

Definition at line 219 of file widget.hh.

Referenced by boxOffsetX(), boxOffsetY(), boxRestHeight(), boxRestWidth(), calcExtraSpace(), dw::Textblock::calcExtraSpaceImpl(), dw::oof::OOFAwareWidget::correctRequisitionByOOF(), dw::Textblock::findLineIndexWhenNotAllocated(), getMarginArea(), dw::Textblock::sizeRequestImpl(), Widget(), dw::Textblock::yOffsetOfLineCreated(), and dw::Textblock::yOffsetOfLineToBeCreated().

◆ extremes

Extremes dw::core::Widget::extremes

private

◆ extremesParams

SizeParams dw::core::Widget::extremesParams

private

Definition at line 167 of file widget.hh.

Referenced by getExtremes(), and Widget().

◆ flags

Flags dw::core::Widget::flags

private

Definition at line 152 of file widget.hh.

Referenced by dw::Textblock::addText(), dw::Textblock::addText0(), dw::Textblock::addWidget(), dw::Textblock::addWord(), allocateQueued(), extremesChanged(), extremesQueued(), dw::Textblock::fillWord(), needsAllocate(), needsResize(), printFlag(), resizeQueued(), setFlags(), unsetFlags(), wasAllocated(), and Widget().

◆ generator

Widget* dw::core::Widget::generator

private

The generating widget, NULL for top-level widgets, or if not set; in the latter case, the effective generator (see getGenerator) is the parent.

Definition at line 139 of file widget.hh.

Referenced by dw::oof::OOFFloatsMgr::Float::CompareGBAndExtIndex::compare(), getGenerator(), setGenerator(), and Widget().

◆ layout

Layout* dw::core::Widget::layout

protected

Definition at line 209 of file widget.hh.

Referenced by a_Image_new(), addAnchor(), addAnchor(), dw::Textblock::addText(), dw::Textblock::addText0(), dw::core::Layout::addWidget(), dw::Textblock::calcLineBreakWidth(), changeAnchor(), dw::Textblock::changeLinkColor(), correctExtremes(), correctRequisition(), dw::core::Layout::detachWidget(), drawBox(), drawInterruption(), dw::Textblock::drawText(), drawWidgetBox(), enterGetExtremes(), enterQueueResize(), enterSizeAllocate(), enterSizeRequest(), getAvailHeight(), getAvailWidth(), getBgColor(), getExtremesEntered(), getLayout(), dw::Textblock::hyphenateWord(), leaveGetExtremes(), dw::Textblock::leaveNotifyImpl(), leaveQueueResize(), leaveSizeAllocate(), leaveSizeRequest(), dw::Textblock::motionNotifyImpl(), queueDrawArea(), queueResize(), queueResizeEntered(), removeAnchor(), resizeIdleEntered(), scrollTo(), selectionHandleEvent(), dw::Textblock::sendSelectionEvent(), setCursor(), setParent(), setStyle(), sizeAllocate(), sizeAllocateEntered(), sizeRequestEntered(), dw::Textblock::textWidth(), Widget(), and ~Widget().

◆ parent

Widget* dw::core::Widget::parent

private

The parent widget, NULL for top-level widgets.

Definition at line 127 of file widget.hh.

Referenced by correctExtremes(), correctExtremesOfChild(), correctRequisition(), correctRequisitionOfChild(), drawWidgetBox(), getAvailHeight(), getAvailHeightOfChild(), getAvailWidth(), getAvailWidthOfChild(), getBgColor(), getFgColor(), getGenerator(), getLevel(), getNearestCommonAncestor(), getParent(), getTopLevel(), dw::Textblock::handOverBreak(), intersects(), queueResize(), setParent(), Widget(), and ~Widget().

◆ parentRef

int dw::core::Widget::parentRef

This value is defined by the parent widget, and used for incremential resizing.

See documentation for an explanation.

Definition at line 195 of file widget.hh.

Referenced by dw::Textblock::accumulateWordForLine(), dw::Textblock::addWidget(), dw::oof::OOFAwareWidget::getParentRefInFlowSubRef(), dw::oof::OOFAwareWidget::getParentRefOOFIndex(), dw::oof::OOFAwareWidget::getParentRefOOFSubRef(), dw::oof::OOFAwareWidget::getParentRefOutOfFlowMgr(), dw::oof::OOFAwareWidget::isParentRefOOF(), queueResize(), and dw::Table::reallocChildren().

◆ quasiParent

Widget* dw::core::Widget::quasiParent

private

...

Definition at line 132 of file widget.hh.

Referenced by correctExtremes(), correctExtremesOfChild(), correctReqHeightOfChild(), correctRequisition(), correctRequisitionOfChild(), correctReqWidthOfChild(), getAvailHeight(), getAvailHeightOfChild(), getAvailWidth(), getAvailWidthOfChild(), setQuasiParent(), and Widget().

◆ requisition

Requisition dw::core::Widget::requisition

private

Size_request() stores the result of the last call of size_request_impl().

Do not read this directly, but call size_request().

Definition at line 160 of file widget.hh.

Referenced by correctReqHeightOfChild(), dw::core::ui::Embed::correctReqHeightOfChildNoRec(), correctRequisition(), dw::oof::OOFAwareWidget::correctRequisitionByOOF(), dw::AlignedTableCell::correctRequisitionOfChild(), dw::SimpleTableCell::correctRequisitionOfChild(), dw::core::ui::Embed::correctRequisitionOfChild(), correctRequisitionOfChild(), correctReqWidthOfChild(), dw::core::ui::Embed::correctReqWidthOfChildNoRec(), sizeRequest(), dw::Textblock::sizeRequestImpl(), sizeRequestImpl(), dw::Bullet::sizeRequestSimpl(), dw::Ruler::sizeRequestSimpl(), dw::Table::sizeRequestSimpl(), dw::SimpleContainer::sizeRequestSimpl(), and dw::core::ui::Embed::sizeRequestSimpl().

◆ requisitionParams

SizeParams dw::core::Widget::requisitionParams

private

Definition at line 161 of file widget.hh.

Referenced by sizeRequest(), and Widget().

◆ stackingContextMgr

StackingContextMgr* dw::core::Widget::stackingContextMgr

protected

Set iff this widget constitutes a stacking context, as defined by CSS.

Definition at line 225 of file widget.hh.

Referenced by dw::core::Layout::addWidget(), dw::oof::OOFAwareWidget::drawLevel(), getNextStackingContextMgr(), dw::oof::OOFAwareWidget::getWidgetAtPointLevel(), setParent(), setStyle(), Widget(), and ~Widget().

◆ stackingContextWidget

Widget* dw::core::Widget::stackingContextWidget

protected

The bottom-most ancestor (or this) for which stackingContextMgr is set.

Definition at line 231 of file widget.hh.

Referenced by dw::core::Layout::addWidget(), dw::oof::OOFAwareWidget::doesWidgetOOFInterruptDrawing(), getNextStackingContextMgr(), setParent(), and setStyle().

◆ style

style::Style* dw::core::Widget::style

private

Definition at line 150 of file widget.hh.

Referenced by dw::Textblock::addAnchor(), dw::Textblock::addBreakOption(), dw::Textblock::addLinebreak(), dw::Textblock::addParbreak(), dw::Table::addRow(), dw::Textblock::addSpace(), dw::Textblock::addText(), dw::Textblock::addText(), dw::Textblock::addText0(), dw::Textblock::addWidget(), dw::Textblock::addWord(), calcFinalWidth(), dw::Textblock::calcTextSize(), dw::Textblock::calcTextSizes(), dw::Textblock::decorateText(), drawBox(), dw::Textblock::drawSpace(), dw::Textblock::drawText(), drawWidgetBox(), dw::Textblock::drawWord(), dw::Textblock::drawWord0(), dw::Textblock::fillSpace(), dw::Textblock::fillWord(), getBgColor(), getBorderArea(), getFgColor(), getPaddingArea(), getStyle(), dw::Textblock::handOverBreak(), dw::ListItem::initWithText(), dw::ListItem::initWithWidget(), dw::Textblock::isBreakAllowed(), dw::Textblock::motionNotifyImpl(), dw::Textblock::mustAddBreaks(), dw::Textblock::setBreakOption(), dw::core::ui::Embed::setStyle(), setStyle(), dw::oof::OOFAwareWidget::testStyleAbsolutelyPositioned(), dw::oof::OOFAwareWidget::testStyleFixedlyPositioned(), dw::oof::OOFAwareWidget::testStyleFloat(), dw::oof::OOFAwareWidget::testStyleOutOfFlow(), dw::oof::OOFAwareWidget::testStylePositioned(), dw::oof::OOFAwareWidget::testStyleRelativelyPositioned(), dw::Textblock::textWidth(), dw::core::Layout::updateCursor(), Widget(), and ~Widget().

◆ widgetImgRenderer

WidgetImgRenderer* dw::core::Widget::widgetImgRenderer

protected

Definition at line 119 of file widget.hh.

Referenced by setStyle(), Widget(), and ~Widget().

◆ widgetReference

WidgetReference* dw::core::Widget::widgetReference

private

Definition at line 148 of file widget.hh.

Referenced by getWidgetReference(), and setWidgetReference().

The documentation for this class was generated from the following files:

dw/widget.hh
dw/widget.cc

Classes

Public Member Functions

Static Public Member Functions

Public Attributes

Static Public Attributes

Protected Types

Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Static Private Attributes

Friends

Detailed Description

Member Enumeration Documentation

◆ Flags

Constructor & Destructor Documentation

◆ Widget()

◆ ~Widget()

Member Function Documentation

◆ addAnchor() [1/2]

◆ addAnchor() [2/2]

◆ adjustHeight()

◆ affectedByContainerSizeChange()

◆ affectsSizeChangeContainerChild()

◆ allocateQueued()

◆ applyPerHeight()

◆ applyPerWidth()

◆ boxDiffHeight()

◆ boxDiffWidth()

◆ boxOffsetX()

◆ boxOffsetY()

◆ boxRestHeight()

◆ boxRestWidth()

◆ buttonPress()

◆ buttonPressImpl()

◆ buttonRelease()

◆ buttonReleaseImpl()

◆ calcExtraSpace()

◆ calcExtraSpaceImpl()

◆ calcFinalWidth()

◆ calcHeight()

◆ calcWidth()

◆ changeAnchor()

◆ containerSizeChanged()

◆ containerSizeChangedForChildren()

◆ correctExtremes()

◆ correctExtremesOfChild()

◆ correctReqHeightOfChild()

◆ correctRequisition()

◆ correctRequisitionOfChild()

◆ correctReqWidthOfChild()

◆ draw()

◆ drawBox()

◆ drawInterruption()

◆ drawSelected()

◆ drawWidgetBox()

◆ enterGetExtremes()

◆ enterNotify()

◆ enterNotifyImpl()

◆ enterQueueResize()

◆ enterSizeAllocate()

◆ enterSizeRequest()

◆ extremesChanged()

◆ extremesQueued()

◆ getAdjustMinWidth()

◆ getAllocation()

◆ getAvailHeight()

◆ getAvailHeightOfChild()

◆ getAvailWidth()

◆ getAvailWidthOfChild()

◆ getBgColor()

◆ getBorderArea()

◆ getContainer()

◆ getContentHeight()

◆ getContentWidth()

◆ getExtremes()

◆ getExtremesEntered()

◆ getExtremesImpl()

◆ getExtremesReference()

◆ getExtremesSimpl()