A Widget for rendering tables. More...

#include <table.hh>

Inheritance diagram for dw::Table:

Collaboration diagram for dw::Table:

Classes
struct	Child

class	TableIterator

Public Member Functions
	Table (bool limitTextWidth)

	~Table ()

core::Iterator *	iterator (core::Content::Type mask, bool atEnd)
	Return an iterator for this widget. More...

void	addCell (Widget *widget, int colspan, int rowspan)

void	addRow (core::style::Style *style)

TableCell *	getCellRef ()

Public Member Functions inherited from dw::core::Widget
void	setDeleteCallback (DW_Callback_t func, void *data)

	Widget ()

	~Widget ()

bool	needsResize ()

bool	needsAllocate ()

bool	extremesChanged ()

bool	wasAllocated ()

bool	usesHints ()

bool	hasContents ()

bool	blockLevel ()

void	setParent (Widget *parent)

style::Style *	getStyle ()

Allocation *	getAllocation ()

void	sizeRequest (Requisition *requisition)
	This method is a wrapper for Widget::sizeRequestImpl(); it calls the latter only when needed. More...

void	getExtremes (Extremes *extremes)
	Wrapper for Widget::getExtremesImpl(). More...

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

bool	intersects (Rectangle area, Rectangle intersection)
	Calculates the intersection of widget->allocation and area, returned in intersection (in widget coordinates!). More...

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. More...

void	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. More...

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

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). More...

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

void	drawSelected (View view, Rectangle area)

void	setButtonSensitive (bool buttonSensitive)

bool	isButtonSensitive ()

Widget *	getParent ()

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

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

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

Layout *	getLayout ()

virtual Widget *	getWidgetAtPoint (int x, int y, int level)
	Search recursively through widget. More...

void	scrollTo (HPosition hpos, VPosition vpos, int x, int y, int width, int height)

void	getPaddingArea (int xPad, int yPad, int widthPad, int heightPad)
	Return the padding area (content plus padding). More...

virtual void	removeChild (Widget *child)

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

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

int	getClassId ()
	Returns the class identifier. More...

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

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. More...

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. More...

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

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

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

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

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

Static Public Attributes
static int	CLASS_ID = -1

Static Public Attributes inherited from dw::core::Widget
static int	CLASS_ID = -1

Protected Member Functions
void	sizeRequestImpl (core::Requisition *requisition)
	See Sizes of Dillo Widgets. More...

void	getExtremesImpl (core::Extremes *extremes)
	See Sizes of Dillo Widgets. More...

void	sizeAllocateImpl (core::Allocation *allocation)
	See Sizes of Dillo Widgets. More...

void	resizeDrawImpl ()
	Called after sizeAllocateImpl() to redraw necessary areas. By default the whole widget is redrawn. More...

void	setWidth (int width)

void	setAscent (int ascent)

void	setDescent (int descent)

void	draw (core::View view, core::Rectangle area)

void	removeChild (Widget *child)

Protected Member Functions inherited from dw::core::Widget
int	getHeight ()

int	getContentWidth ()

int	getContentHeight ()

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)
	This method should be called, when a widget changes its size. More...

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

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

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. See class comment for details. More...

Private Member Functions
bool	childDefined (int n)

void	reallocChildren (int newNumCols, int newNumRows)

void	calcCellSizes ()

void	forceCalcCellSizes ()

void	apportionRowSpan ()

void	calcColumnExtremes ()
	Fills dw::Table::colExtremes, only if recalculation is necessary. More...

void	forceCalcColumnExtremes ()
	Fills dw::Table::colExtremes in all cases. More...

void	apportion2 (int totalWidth, int forceTotalWidth)
	Apportionment function for AUTO-length columns. 'extremes' comes filled, 'result' comes defined for percentage columns. More...

void	apportion_percentages2 (int totalWidth, int forceTotalWidth)

void	setCumHeight (int row, int value)

void	setColWidth (int col, int value)

Private Attributes
bool	limitTextWidth

bool	rowClosed

int	availWidth

int	availAscent

int	availDescent

int	numRows

int	numCols

int	curRow

int	curCol

lout::misc::SimpleVector< Child * > *	children

int	redrawX

int	redrawY

lout::misc::SimpleVector< core::Extremes > *	colExtremes
	The extremes of all columns. More...

lout::misc::SimpleVector< int > *	colWidths
	The widths of all columns. More...

lout::misc::SimpleVector< int > *	cumHeight

lout::misc::SimpleVector< int > *	rowSpanCells

lout::misc::SimpleVector< int > *	colSpanCells

lout::misc::SimpleVector< int > *	baseline

lout::misc::SimpleVector< core::style::Style * > *	rowStyle

int	hasColPercent

lout::misc::SimpleVector< core::style::Length > *	colPercents

Friends
class	TableIterator

Additional Inherited Members
Public Attributes inherited from dw::core::Widget
int	parentRef
	This value is defined by the parent widget, and used for incremential resizing. More...

Protected Types inherited from dw::core::Widget
enum	Flags { NEEDS_RESIZE = 1 << 0, NEEDS_ALLOCATE = 1 << 1, EXTREMES_CHANGED = 1 << 2, USES_HINTS = 1 << 3, HAS_CONTENTS = 1 << 4, WAS_ALLOCATED = 1 << 5, BLOCK_LEVEL = 1 << 6 }

Protected Attributes inherited from dw::core::Widget
WidgetImgRenderer *	widgetImgRenderer

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

Layout *	layout

Detailed Description

A Widget for rendering tables.

Introduction

The dw::Table widget is used to render HTML tables.

Each cell is itself a separate widget. Any widget may be used, however, in dillo, only instances of dw::Textblock and dw::TableCell are used as children of dw::Table.

Sizes

General

The following diagram shows the dependencies between the different functions, which are related to size calculation. Click on the boxes for more information.

[A] In this case, the new calculation is not forced, but only done, when necessary.

[B] In this case, the new calculation is allways necessary, since [C] is the case.

[C] Whether this function is called, depends on NEEDS_RESIZE / EXTREMES_CHANGED.

Apportionment

See also: How to Avoid Rounding Errors

Given two array \(e_{i,\min}\) and \(e_{i,\max}\), which represent the column minima and maxima, and a total width \(W\), apportionment means to calculate column widths \(w_{i}\), with

\[e_{i,\min} \le w_{i} \le e_{i,\max}\]

and

\[\sum w_{i} = W\]

There are different algorithms for apportionment, a simple one is recommended in the HTML 4.0.1 specification (http://www.w3.org/TR/REC-html40/appendix/notes.html#h-B.5.2.2):

\[w_{i} = e_{i,\min} + {e_{i,\max} - e_{i,\min}\over\sum e_{i,\max} - \sum e_{i,\min}} (W - \sum e_{i,\min})\]

This one is used currently, but another one will be used soon, which is described below. The rest of this chapter is independent of the exact apportionment algorithm.

When referring to the apportionment function, we will call it \(a_i (W, (e_{i,\min}), (e_{i,\min}))\) and write something like this:

\[w_{i} = a_i (W, (e_{i,\min}), (e_{i,\max})) \]

It is implemented by dw::Table::apportion.

Column Extremes

See also: How to Avoid Rounding Errors

The sizes, which all other sizes depend on, are column extremes, which define, how wide a column may be at min and at max. They are calculated in the following way:

First, only cells with colspan = 1 are regarded:
\[ e_{\hbox{base},i,\min} = \max \{ e_{\hbox{cell},i,j,\min} \} \]

\[ e_{\hbox{base},i,\max} = \max \{ e_{\hbox{cell},i,j,\max} \} \]

only for cells \((i, j)\) with colspan = 1.
Then, \(e_{\hbox{span},i,\min}\) (but not \(e_{\hbox{span},i,\max}\)) are calculated from cells with colspan > 1. (In the following formulas, the cell at \((i_1, j)\) always span from \(i_1\) to \(i_2\).) If the minimal width of the column exceeds the sum of the column minima calculated in the last step:
\[e_{\hbox{cell},i_1,j,\min} > \sum_{i=i_1}^{i=i_2} e_{\hbox{base},i,\min}\]

then the minimal width of this cell is apportioned to the columns:
- If the minimal width of this cell also exceeds the sum of the column maxima:
  \[e_{\hbox{cell},i_1,j,\min} > \sum_{i=i_1}^{i=i_2} e_{\hbox{base},i,\max}\]
  then \(e_{\hbox{cell},i_1,j,\min}\) is apportioned in a simple way:
  \[e_{\hbox{span},i,j,\min} = e_{\hbox{base},i,\max} {e_{\hbox{span},i,j,\min} \over \sum_{i=i_1}^{i=i_2} e_{\hbox{base},i,\max}}\]
- Otherwise, the apportionment function is used:
  \[e_{\hbox{span},i,j,\min} = a_i (e_{\hbox{cell},i_1,j,\min}, (e_{\hbox{cell},i_1,j,\min} \ldots e_{\hbox{cell},i_2,j,\min}), (e_{\hbox{cell},i_1,j,\max} \ldots e_{\hbox{cell},i_2,j,\max}))\]
After this, \(e_{\hbox{span},i,\min}\) is then the maximum of all \(e_{\hbox{span},i,j,\min}\).
Finally, the maximum of both is used.
\[ e_{i,\min} = \max \{ e_{\hbox{base},i,\min}, e_{\hbox{span},i,\min} \} \]

\[ e_{i,\max} = \max \{ e_{\hbox{base},i,\max}, e_{i,\min} \} \]

For the maxima, there is no \(e_{\hbox{span},i,\max}\), but it has to be assured, that the maximum is always greater than or equal to the minimum.

Generally, if absolute widths are specified, they are, instead of the results of dw::core::Widget::getExtremes, taken for the minimal and maximal width of a cell (minus the box difference, i.e. the difference between content size and widget size). If the content width specification is smaller than the minimal content width of the widget (determined by dw::core::Widget::getExtremes), the latter is used instead.

If percentage widths are specified, they are also collected, as column maxima. A similar method as for the extremes is used, for cells with colspan > 1:

\[w_{\hbox{span},i,j,\%} = a_i (w_{\hbox{cell},i_1,j,\%}, (e_{\hbox{cell},i_1,j,\min} \ldots e_{\hbox{cell},i_2,j,\min}), (e_{\hbox{cell},i_1,j,\max} \ldots e_{\hbox{cell},i_2,j,\max}))\]

Cell Sizes

Determining the Width of the Table

The total width is

the specified absolute width of the table, when given, or
the available width (set by dw::Table::setWidth) times the specified percentage width of t(at max 100%), if the latter is given, or
otherwise the available width.

In any case, it is corrected, if it is less than the minimal width (but not if it is greater than the maximal width).

Bug:: The parentheses is not fully clear, look at the old code.

Details on differences because of styles are omitted. Below, this total width is called \(W\).

Evaluating percentages

The following algorithms are used to solve collisions between different size specifications (absolute and percentage). Generally, inherent sizes and specified absolute sizes are preferred.

First, calculate the sum of the minimal widths, for columns, where no percentage width has been specified. The difference to the total width is at max available to the columns with percentage width specifications:
\[W_{\hbox{columns}_\%,\hbox{available}} = W - \sum e_{i,\min}\]

with only those columns \(i\) with no percentage width specification.
Then, calculate the sum of the widths, which the columns with percentage width specification would allocate, when fully adhering to them:
\[W_{\hbox{columns}_\%,\hbox{best}} = W \sum w_{i,\%}\]

with only those columns \(i\) with a percentage width specification.
Two cases are distinguished:
- \(W_{\hbox{columns}_\%,\hbox{available}} \ge W_{\hbox{columns}_\%,\hbox{best}}\): In this case, the percentage widths can be used without any modification, by setting the extremes:
  \[e_{i,\min} = e_{i,\max} = W w_{i,\%}\]
  
  for only those columns \(i\) with a percentage width specification.
- \(W_{\hbox{columns}_\%,\hbox{available}} < W_{\hbox{columns}_\%,\hbox{best}}\): In this case, the widths for these columns must be cut down:
  \[e_{i,\min} = e_{i,\max} = w_{i,\%} {W_{\hbox{columns}_\%,\hbox{available}} \over w_{\hbox{total},\%}}\]
  with
  \[w_{\hbox{total},\%} = \sum w_{i,\%}\]
  in both cases for only those columns \(i\) with a percentage width specification.

( \(e_{i,\min}\) and \(e_{i,\max}\) are set temporarily here, the notation should be a bit clearer.)

Column Widths

The column widths are now simply calculated by applying the apportionment function.

Row Heights

...

Alternative Apportionment Algorithm

The algorithm described here tends to result in more homogeneous column widths.

The following rule leads to well-defined \(w_{i}\): All columns \(i\) have have the same width \(w\), except:

\(w < e_{i,\min}\), or
\(w > e_{i,\max}\).

Furthermore, \(w\) is

less than all \(e_{i,\min}\) of columns not having \(w\) as width, and
greater than all \(e_{i,\min}\) of columns not having \(w\) as width.

Of course, \(\sum w_{i} = W\) must be the case.

Based on an initial value \(w = {W\over n}\), \(w\) can iteratively adjusted, based on these rules.

Borders, Paddings, Spacing

Currently, DwTable supports only the separated borders model (see CSS specification). Borders, paddings, spacing is done by creating dw::core::style::Style structures with values equivalent to following CSS:

TABLE {
  border:           outset table-border;
  border-collapse:  separate;
  border-spacing:   table-cellspacing;
  background-color: table-bgcolor;
}

TD TH {
  border:           inset table-border;
  padding:          table-cellspacing;
  background-color: td/th-bgcolor;
}

Here, foo-bar refers to the attribute bar of the tag foo foo. Look at the HTML parser for more details.

Definition at line 316 of file table.hh.

Constructor & Destructor Documentation

◆ Table()

dw::Table::Table ( bool limitTextWidth )

Definition at line 33 of file table.cc.

References DBG_OBJ_CREATE.

◆ ~Table()

dw::Table::~Table ( )

Definition at line 72 of file table.cc.

References DBG_OBJ_DELETE.

Member Function Documentation

◆ addCell()

void dw::Table::addCell	(	Widget *	widget,
		int	colspan,
		int	rowspan
	)

Definition at line 273 of file table.cc.

References _MSG, dw::Table::Child::cell, lout::misc::max(), MSG, MSG_WARN, dw::Table::Child::spanSpace, and dw::Table::Child::type.

◆ addRow()

void dw::Table::addRow ( core::style::Style * style )

Definition at line 378 of file table.cc.

References dw::core::style::Style::ref().

◆ apportion2()

void dw::Table::apportion2	(	int	totalWidth,
		int	forceTotalWidth
	)

private

Apportionment function for AUTO-length columns. 'extremes' comes filled, 'result' comes defined for percentage columns.

Definition at line 847 of file table.cc.

References _MSG, dw::core::style::isAbsLength(), dw::core::style::LENGTH_AUTO, lout::misc::max(), and MSG.

◆ apportion_percentages2()

void dw::Table::apportion_percentages2	(	int	totalWidth,
		int	forceTotalWidth
	)

private

Definition at line 927 of file table.cc.

References _MSG, dw::core::style::isAbsLength(), dw::core::style::isPerLength(), dw::core::style::LENGTH_AUTO, lout::misc::max(), lout::misc::min(), MSG, dw::core::style::multiplyWithPerLength(), and dw::core::style::perLengthVal().

◆ apportionRowSpan()

void dw::Table::apportionRowSpan ( )

private

Definition at line 578 of file table.cc.

References _MSG, dw::core::Requisition::ascent, dw::core::Requisition::descent, and MSG.

◆ calcCellSizes()

void dw::Table::calcCellSizes ( )

private

Definition at line 483 of file table.cc.

◆ calcColumnExtremes()

void dw::Table::calcColumnExtremes ( )

private

Fills dw::Table::colExtremes, only if recalculation is necessary.

Bug:: Some parts are missing.

Definition at line 641 of file table.cc.

◆ childDefined()

bool dw::Table::childDefined ( int n )

inlineprivate

Definition at line 400 of file table.hh.

References children, and dw::Table::Child::SPAN_SPACE.

◆ draw()

void dw::Table::draw	(	core::View *	view,
		core::Rectangle *	area
	)

protectedvirtual

Area is given in widget coordinates.

Implements dw::core::Widget.

Definition at line 231 of file table.cc.

References dw::core::Rectangle::draw().

◆ forceCalcCellSizes()

void dw::Table::forceCalcCellSizes ( )

private

Bug:: dw::Table::baseline is not filled.

Definition at line 490 of file table.cc.

References _MSG, dw::core::style::absLengthVal(), dw::core::Requisition::ascent, dw::core::Requisition::descent, dw::core::style::isAbsLength(), dw::core::style::isPerLength(), dw::core::style::LENGTH_AUTO, lout::misc::max(), dw::core::Extremes::maxWidth, lout::misc::min(), dw::core::Extremes::minWidth, and dw::core::style::multiplyWithPerLength().

◆ forceCalcColumnExtremes()

void dw::Table::forceCalcColumnExtremes ( )

private

Fills dw::Table::colExtremes in all cases.

Definition at line 651 of file table.cc.

References _MSG, dw::core::style::absLengthVal(), dw::core::style::isAbsLength(), dw::core::style::isPerLength(), dw::core::style::LENGTH_AUTO, lout::misc::max(), dw::core::Extremes::maxWidth, dw::core::Extremes::minWidth, MSG, and dw::core::style::perLengthVal().

◆ getCellRef()

TableCell * dw::Table::getCellRef ( )

Definition at line 396 of file table.cc.

References lout::identity::IdentifiableObject::instanceOf().

◆ getExtremesImpl()

void dw::Table::getExtremesImpl ( core::Extremes * extremes )

protectedvirtual

See Sizes of Dillo Widgets.

Reimplemented from dw::core::Widget.

Definition at line 124 of file table.cc.

References _MSG, dw::core::style::absLengthVal(), dw::core::style::isAbsLength(), lout::misc::max(), dw::core::Extremes::maxWidth, and dw::core::Extremes::minWidth.

◆ iterator()

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

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.

Implements dw::core::Widget.

Definition at line 268 of file table.cc.

◆ reallocChildren()

void dw::Table::reallocChildren	(	int	newNumCols,
		int	newNumRows
	)

private

Definition at line 412 of file table.cc.

References dw::Table::Child::spanSpace, and dw::Table::Child::type.

◆ removeChild()

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

protected

Bug:: Not implemented.

Definition at line 263 of file table.cc.

◆ resizeDrawImpl()

void dw::Table::resizeDrawImpl ( )

protectedvirtual

Called after sizeAllocateImpl() to redraw necessary areas. By default the whole widget is redrawn.

Reimplemented from dw::core::Widget.

Definition at line 197 of file table.cc.

◆ setAscent()

void dw::Table::setAscent ( int ascent )

protectedvirtual

Reimplemented from dw::core::Widget.

Definition at line 215 of file table.cc.

◆ setColWidth()

void dw::Table::setColWidth	(	int	col,
		int	value
	)

inlineprivate

Definition at line 426 of file table.hh.

References colWidths, lout::misc::SimpleVector< T >::get(), lout::misc::min(), redrawX, and lout::misc::SimpleVector< T >::set().

◆ setCumHeight()

void dw::Table::setCumHeight	(	int	row,
		int	value
	)

inlineprivate

Definition at line 418 of file table.hh.

References cumHeight, lout::misc::SimpleVector< T >::get(), lout::misc::min(), redrawY, and lout::misc::SimpleVector< T >::set().

◆ setDescent()

void dw::Table::setDescent ( int descent )

protectedvirtual

Reimplemented from dw::core::Widget.

Definition at line 223 of file table.cc.

◆ setWidth()

void dw::Table::setWidth ( int width )

protectedvirtual

Reimplemented from dw::core::Widget.

Definition at line 205 of file table.cc.

References _MSG.

◆ sizeAllocateImpl()

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

protectedvirtual

See Sizes of Dillo Widgets.

Bug:: Baselines are not regarded here.

Reimplemented from dw::core::Widget.

Definition at line 153 of file table.cc.

References dw::core::Allocation::ascent, dw::core::Requisition::ascent, dw::core::Allocation::descent, dw::core::Allocation::width, dw::core::Allocation::x, and dw::core::Allocation::y.

◆ sizeRequestImpl()

void dw::Table::sizeRequestImpl ( core::Requisition * requisition )

protectedvirtual

See Sizes of Dillo Widgets.

Bug:: Baselines are not regarded here.

Implements dw::core::Widget.

Definition at line 105 of file table.cc.

References dw::core::Requisition::ascent, dw::core::Requisition::descent, and dw::core::Requisition::width.

Friends And Related Function Documentation

◆ TableIterator

friend class TableIterator

friend

Definition at line 356 of file table.hh.

Member Data Documentation

◆ availAscent

int dw::Table::availAscent

private

Definition at line 359 of file table.hh.

◆ availDescent

int dw::Table::availDescent

private

Definition at line 359 of file table.hh.

◆ availWidth

int dw::Table::availWidth

private

Definition at line 359 of file table.hh.

◆ baseline

lout::misc::SimpleVector<int>* dw::Table::baseline

private

Definition at line 390 of file table.hh.

◆ children

lout::misc::SimpleVector<Child*>* dw::Table::children

private

Definition at line 362 of file table.hh.

Referenced by childDefined(), dw::Table::TableIterator::next(), dw::Table::TableIterator::prev(), and dw::Table::TableIterator::TableIterator().

◆ CLASS_ID

int dw::Table::CLASS_ID = -1

static

Definition at line 452 of file table.hh.

◆ colExtremes

lout::misc::SimpleVector<core::Extremes>* dw::Table::colExtremes

private

The extremes of all columns.

Definition at line 369 of file table.hh.

◆ colPercents

lout::misc::SimpleVector<core::style::Length>* dw::Table::colPercents

private

Definition at line 398 of file table.hh.

◆ colSpanCells

lout::misc::SimpleVector<int>* dw::Table::colSpanCells

private

If a Cell has colspan > 1, it goes into this array

Definition at line 389 of file table.hh.

◆ colWidths

lout::misc::SimpleVector<int>* dw::Table::colWidths

private

The widths of all columns.

Definition at line 374 of file table.hh.

Referenced by setColWidth().

◆ cumHeight

lout::misc::SimpleVector<int>* dw::Table::cumHeight

private

Row cumulative height array: cumHeight->size() is numRows + 1, cumHeight->get(0) is 0, cumHeight->get(numRows) is the total table height.

Definition at line 381 of file table.hh.

Referenced by setCumHeight().

◆ curCol

int dw::Table::curCol

private

Definition at line 361 of file table.hh.

◆ curRow

int dw::Table::curRow

private

Definition at line 361 of file table.hh.

◆ hasColPercent

int dw::Table::hasColPercent

private

hasColPercent becomes true when any cell specifies a percentage width.

Definition at line 397 of file table.hh.

◆ limitTextWidth

bool dw::Table::limitTextWidth

private

Definition at line 358 of file table.hh.

◆ numCols

int dw::Table::numCols

private

Definition at line 361 of file table.hh.

◆ numRows

int dw::Table::numRows

private

Definition at line 361 of file table.hh.

◆ redrawX

int dw::Table::redrawX

private

Definition at line 364 of file table.hh.

Referenced by setColWidth().

◆ redrawY

int dw::Table::redrawY

private

Definition at line 364 of file table.hh.

Referenced by setCumHeight().

◆ rowClosed

bool dw::Table::rowClosed

private

Definition at line 358 of file table.hh.

◆ rowSpanCells

lout::misc::SimpleVector<int>* dw::Table::rowSpanCells

private

If a Cell has rowspan > 1, it goes into this array

Definition at line 385 of file table.hh.

◆ rowStyle

lout::misc::SimpleVector<core::style::Style*>* dw::Table::rowStyle

private

Definition at line 392 of file table.hh.

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

dw/table.hh
dw/table.cc

Classes

Public Member Functions

Static Public Attributes

Protected Member Functions

Private Member Functions

Private Attributes

Friends

Additional Inherited Members

Detailed Description

Introduction

Sizes

General

Apportionment

Column Extremes

Cell Sizes

Determining the Width of the Table

Evaluating percentages

Column Widths

Row Heights

Alternative Apportionment Algorithm

Borders, Paddings, Spacing

Constructor & Destructor Documentation

◆ Table()

◆ ~Table()

Member Function Documentation

◆ addCell()

◆ addRow()

◆ apportion2()

◆ apportion_percentages2()

◆ apportionRowSpan()

◆ calcCellSizes()

◆ calcColumnExtremes()

◆ childDefined()

◆ draw()

◆ forceCalcCellSizes()

◆ forceCalcColumnExtremes()

◆ getCellRef()

◆ getExtremesImpl()

◆ iterator()

◆ reallocChildren()

◆ removeChild()

◆ resizeDrawImpl()

◆ setAscent()

◆ setColWidth()

◆ setCumHeight()

◆ setDescent()

◆ setWidth()

◆ sizeAllocateImpl()

◆ sizeRequestImpl()

Friends And Related Function Documentation

◆ TableIterator

Member Data Documentation

◆ availAscent

◆ availDescent

◆ availWidth

◆ baseline

◆ children

◆ CLASS_ID

◆ colExtremes

◆ colPercents

◆ colSpanCells

◆ colWidths

◆ cumHeight

◆ curCol

◆ curRow

◆ hasColPercent

◆ limitTextWidth

◆ numCols

◆ numRows

◆ redrawX

◆ redrawY

◆ rowClosed

◆ rowSpanCells

◆ rowStyle