QicsTable: QicsRegionalAttributeController Class Reference

List of all members.


Public Types
enum	QicsWideKeyAction { Del_DeleteSelected, CtrlA_SelectAll }
enum	QicsBoxBorders { TopBorder = 1, BottomBorder = 2, LeftBorder = 4, RightBorder = 8, AllBorders = 1+2+4+8 }
enum	QicsCopyPolicy { CopyData = 1, CopyAttributes = 2, CopyDimensions = 4, CopySpans = 8, CopyAll = 1+2+4+8 }
enum	QicsClearPolicy { ClearData = 1, ClearAttributes = 2, ClearSpans = 4, ClearAll = 1+2+4 }
enum	QicsSortMode { QicsStableSort = 0, QicsQuickSort }
enum	QicsCellOverflowBehavior { Clip = 0, Overflow, ToolTip }
enum	QicsCurrentCellStyle { Spreadsheet = 0, NormalSelected }
enum	QicsSelectionStyle { Normal = 0, Exclusive }
enum	QicsSelectCurrentCellPolicy { Follow = 0, Static }
enum	QicsFillHandleEventType { FillHandlePressed = 0, FillHandleReleased, FillHandleDoubleClicked, FillHandleDragged }
enum	QicsGridCellClipping { AllowPartial = 0, NoDisplayOnPartial, UseClippedSymbol }
enum	QicsGridType { TableGrid = 0, RowHeaderGrid, ColumnHeaderGrid }
enum	QicsHeaderType { RowHeader = 0, ColumnHeader }
enum	QicsIndexType { NoIndex = 0, RowIndex, ColumnIndex, RowAndColumnIndex }
enum	QicsLineStyle { None = 0, Plain, Raised, Sunken }
enum	QicsRepaintBehavior { RepaintOff = 0, RepaintOn = 1, RepaintCalcOnly = 2 }
enum	QicsScrollBarMode { Auto = 0, AlwaysOff, AlwaysOn }
enum	QicsScrollDirection { ScrollNone = 0, ScrollUp = 1, ScrollDown = 2, ScrollLeft = 4, ScrollRight = 8, ScrollToRow = 16, ScrollToColumn = 32 }
enum	QicsSelectionPolicy { SelectNone = 0, SelectSingle, SelectMultiple, SelectSingleRow, SelectMultipleRow }
enum	QicsSelectionType { SelectionNone = 0, SelectionBegin, SelectionDrag, SelectionEnd, SelectionExtend, SelectionAdd, SelectionReplace }
enum	QicsSortOrder { Ascending = 0, Descending }
enum	QicsTableDisplayOption { DisplayNever = 0, DisplayAlways, DisplayFirstPage }
enum	QicsTraversalKeyEditBehavior { TraverseWithinCell = 0, TraverseBetweenCells }
enum	QicsCurrentCellDraggingPolicy { DragCurrent = 0, DragSelection }
enum	QicsCellWidthMode { ChangeOnlyHeight = 0, ChangeHeightWidth }
enum	QicsCellDecorationStyle { Flat = 0, Styled = 1 }
Public Member Functions
virtual QicsAbstractAttributeController *	createController ()
virtual void *	cellProperty (int row, int col, int name)
virtual bool	setCellProperty (int row, int col, int name, const void *val)
virtual bool	clearCellProperty (int row, int col, int name)
virtual void *	rowProperty (int row, int name)
virtual void *	columnProperty (int col, int name)
virtual void *	defaultProperty (int name)
virtual bool	setRowProperty (int row, int name, const void *val)
virtual bool	setColumnProperty (int col, int name, const void *val)
virtual bool	setDefaultProperty (int name, const void *val)
virtual bool	clearRowProperty (int row, int name)
virtual bool	clearColumnProperty (int col, int name)
virtual bool	isPropertySupported (int name)
virtual bool	isDefaultPropertySupported (int name)
virtual QicsCellStyle *	defaultStyle ()
virtual void	setDefaultStyle (QicsCellStyle *style)
virtual void	setGridInfo (QicsGridInfo *gi)
virtual void	reinit (int rows, int columns)
virtual void	insertRows (int num, int start_position)
virtual void	insertColumns (int num, int start_position)
virtual void	deleteRows (int num, int start_position)
virtual void	deleteColumns (int num, int start_position)
virtual QicsCellStyle *	cellStyle (int row, int column)
virtual void	setCellStyle (int row, int column, QicsCellStyle *style)
virtual QicsCellStyle *	rowStyle (int row)
virtual void	setRowStyle (int row, QicsCellStyle *style)
virtual QicsCellStyle *	columnStyle (int column)
virtual void	setColumnStyle (int column, QicsCellStyle *style)
Protected Types
typedef QList< AttrRegion >	AttrRegionList
typedef QList< AttrRegionList >	AttrRowList
typedef QMap< AttrVariant, AttrRowList >	AttrValueHash
typedef QMap< int, AttrValueHash >	AttrHash
Protected Member Functions
virtual void	handleReinit (int rows, int columns)
virtual void	handleInsertRows (int num, int start_position)
virtual void	handleInsertColumns (int num, int start_position)
virtual void	handleDeleteRows (int num, int start_position)
virtual void	handleDeleteColumns (int num, int start_position)
void *	cellAttr (int row, int col, int name)
void	setCellAttr (int row, int col, int name, AttrVariant val)
void	clearCellAttr (int row, int col, int name)
void	removeRowAttr (int r)
QicsAttrRowCol *	rowAttr (int r)
void	setRowAttr (int r, QicsAttrRowCol *attr)
void	removeColumnAttr (int c)
QicsAttrRowCol *	columnAttr (int c)
void	setColumnAttr (int c, QicsAttrRowCol *attr)
Protected Attributes
AttrHash	m_attrs
bool	boolean
uint	uinteger
qicsptr	pointer
QColor	clr
QPalette	pal
QFont	font
QString	string
QCursor	cursor
QPen	pen
QRgb	rgb
QPixmap	pixmap
QList< QicsAttrRowCol * >	m_arows
QList< QicsAttrRowCol * >	m_acols
int	m_rows
int	m_cols
QicsCellStyle *	myDefaultStyle
QicsGridInfo *	myInfo
QicsCellStyle *	myCellStyle

Detailed Description

It is optimized to provide very fast lookup/change of attributes and low memory consumption. Attribute model is represented as a hash which keys are attribute names, and values are hashes with attribute values as keys. A value of such sub-hash is a list of rows in which this attribute is set. Every row itself contains a list of regions sorted from left to right. Each region represents contiguous line of cells and internally is a pair or two integers: starting and ending column indexes. Thus, a single region consumes only 8 bytes of memory, and it does not matter how many cells it contains - one or one million.

During inserting/removing columns/attributes, controller keeps track of changed cells and combines/splits/removes regions on-the-fly, so there are no extra fragmentations - regions are always up-to-dated.

Adding/removing rows to data model are very fast, because such operations do not require regional changes. Only column operations are a quite "painful".

Member Enumeration Documentation

enum Qics::QicsWideKeyAction [inherited]

Denotes global key actions available for the table grid.

Del_DeleteSelected Pressing Delete removes data from the selected cells.
CtrlA_SelectAll Pressing Control+A selects all the cells in the grid.

enum Qics::QicsBoxBorders [inherited]

Denotes the box borders of cell region.

TopBorder Top border of the region.
BottomBorder Bottom border of the region.
LeftBorder Left border of the region.
RightBorder Right border of the region.

enum Qics::QicsCopyPolicy [inherited]

Denotes the copying policy during copy/paste and drag/drop operations.

CopyData Copy data from cells.
CopyAttributes Copy cell attributes.
CopyDimensions Copy cell dimensions (width/height).
CopySpans Copy spanned cells.

enum Qics::QicsClearPolicy [inherited]

Denotes the clearing policy during cut and delete operations.

ClearData Clear data from cells.
ClearAttributes Clear cell attributes.
ClearSpans Clear spanned cells.

enum Qics::QicsSortMode [inherited]

Denotes the sort algorithm which is used.

QicsStableSort Used non-destructive, stable sort algorithm.
QicsQuickSort Default quick sort algorithm.

enum Qics::QicsCellOverflowBehavior [inherited]

Denotes the behavior of grids when handling cells whose contents cannot be displayed in the boundaries of the cell.

Clip Cell contents are clipped at the edges of the cell.
Overflow The grid will attempt to overflow into adjacent cells.
ToolTip The full contents of the cell will be displayed in a tooltip when the mouse pointer is hovered over the cell.

enum Qics::QicsCurrentCellStyle [inherited]

Denotes the visual style that the current cell of the table will be drawn with.

Spreadsheet The current cell will be drawn with a solid border and will always use the cell's background color.
NormalSelected The current cell will be drawn the same as all other selected cells. The border will be as specified in the cell's border properties, and the background will be the cell's selected color.

enum Qics::QicsSelectionStyle [inherited]

Normal The selection will be drawn by the normal way.
Exclusive The selection will be drawn with border like in MS Excel.

enum Qics::QicsSelectCurrentCellPolicy [inherited]

Follow The current cell will follow the selection (QicsTable style).
Static The current cell will stay on selection anchor (MS Excel style).
Since:
2.3

enum Qics::QicsGridCellClipping [inherited]

Denotes the policy for displaying text that is too long to fit in its cell.

AllowPartial Shows as much of the text as possible.
NoDisplayOnPartial Do not display text if it cannot fit in the cell.
UseClippedSymbol Display a clipped symbol at the end of the partial text.

enum Qics::QicsGridType [inherited]

Specifies a type of grid object.

TableGrid A grid used to display normal table data.
RowHeaderGrid A grid used to display row header data.
ColumnHeaderGrid A grid used to display column header data.

enum Qics::QicsHeaderType [inherited]

Specifies the type of table header.

HeaderRow A row header.
HeaderColumn A column header.

enum Qics::QicsIndexType [inherited]

Specifies the type of table index.

RowIndex A row index.
ColumnIndex A column index.

enum Qics::QicsLineStyle [inherited]

Denotes the style of lines and borders in the table widget.

None No line or border.
Plain A simple, plain line or border.
Raised A raised line (using shadows).
Sunken A sunken line (using shadows).

enum Qics::QicsRepaintBehavior [inherited]

Specifies the recalculation and repainting behavior of tables and grids.

RepaintOff Do not perform any drawing or dimension calculations.
RepaintOn Draw as needed, keep all dimensions up to date.
RepaintCalcOnly Do not draw, but keep all dimensions up to date.

enum Qics::QicsScrollBarMode [inherited]

Specifies the various modes of QicsTable's scroll bars.

Auto QicsTable shows a scroll bar when the content is too large to fit and not otherwise.
AlwaysOff QicsTable never shows a scroll bar.
AlwaysOn QicsTable always shows a scroll bar.

enum Qics::QicsScrollDirection [inherited]

Denotes a direction for scrolling operations, or that an absolute scroll should occur.

ScrollNone no scroll allowed.
ScrollUp scrolling up on a certain number of rows.
ScrollDown scrolling down on a certain number of rows.
ScrollLeft scrolling left on a certain number of columns.
ScrollRight scrolling right on a certain number of columns.
ScrollToRow scrolling up or down to a certain row.
ScrollToColumn scrolling left or right to a certain column.

enum Qics::QicsSelectionPolicy [inherited]

Denotes the selection policy for the table.

SelectNone no selection allowed.
SelectSingle single cell selection.
SelectionMultiple multiple cell selection (including non-contiguous regions).
SelectSingleRow selecting a cell selects the entire row, only one row can be selected.
SelectMultipleRow selecting a cell selects the entire row, multiple rows can be selected.

enum Qics::QicsSortOrder [inherited]

Specifies whenever ordering should be ascending or descending.

Ascending Ascending order.
Descending Descending order.

enum Qics::QicsTableDisplayOption [inherited]

Specifies a printing display policy for elements of the table.

DisplayNever Do not display the element when printing.
DisplayAlways Always display the element when printing.
DisplayFirstPage Display the element only when printing the first page of the table.

enum Qics::QicsTraversalKeyEditBehavior [inherited]

Specifies the behavior of the traversal keys. (left, right, up, down, etc) while editing a cell.

TraverseWithinCell Traversal keys move the text cursor within the edited cell.
TraverseBetweenCells Traversal keys move the current cell highlight between cells in the table.

enum Qics::QicsCurrentCellDraggingPolicy [inherited]

Specifies the behavior of drag&drop operations when it has began from current cell.

DragCurrent - only current cell is dragging.
DragSelection - whole selection is dragging.

enum Qics::QicsCellWidthMode [inherited]

Specifies the behavior of set cell font.

ChangeOnlyHeight - changing only Height(Widht do't changing)
ChangeHeightWidth - changing Height and Widht
OnOverSpan - changing only Height (Widht do't changing) and on mode OverSpan

enum Qics::QicsCellDecorationStyle [inherited]

Specifies the cell decoration style for headers.

Flat Header cells are drawn flat, just like as ordinal cells.
Styled Header cells are drawn with different look.

Member Function Documentation

virtual QicsAbstractAttributeController* QicsRegionalAttributeController::createController ( ) [inline, virtual]

Creates new attribute controller.

Implements QicsAbstractAttributeController.

virtual void* QicsRegionalAttributeController::cellProperty	(	int	row,
		int	col,
		int	name
	)			`[virtual]`

Returns pointer to a property name at cell with row row and column col, 0 if not found.

Implements QicsAbstractAttributeController.

virtual bool QicsRegionalAttributeController::setCellProperty	(	int	row,
		int	col,
		int	name,
		const void *	val
	)			`[virtual]`

Sets a property name at cell with row row and column col to a value of val. Returns true if ok, false if such property cannot be set (i.e. not supported).

Implements QicsAbstractAttributeController.

virtual bool QicsRegionalAttributeController::clearCellProperty	(	int	row,
		int	col,
		int	name
	)			`[virtual]`

Clears property name at cell with row row and column col. Returns true if ok, false if such property cannot be cleared (i.e. not supported).

Implements QicsAbstractAttributeController.

virtual void QicsRegionalAttributeController::handleReinit	(	int	,
		int
	)			`[protected, virtual]`

Called internally from reinit(). Should be reimplemented in subclasses in order to handle reinitialization of cell attributes (i.e. clear).

Since:: 2.2.1

Reimplemented from QicsCommonAttributeController.

virtual void QicsRegionalAttributeController::handleInsertRows	(	int	,
		int
	)			`[protected, virtual]`

Called internally from insertRows(). Should be reimplemented in subclasses in order to handle change of cell attributes when rows are being inserted.

Since:: 2.2.1

Reimplemented from QicsCommonAttributeController.

virtual void QicsRegionalAttributeController::handleInsertColumns	(	int	,
		int
	)			`[protected, virtual]`

Called internally from insertColumns(). Should be reimplemented in subclasses in order to handle change of cell attributes when columns are being inserted.

Since:: 2.2.1

Reimplemented from QicsCommonAttributeController.

virtual void QicsRegionalAttributeController::handleDeleteRows	(	int	,
		int
	)			`[protected, virtual]`

Called internally from deleteRows(). Should be reimplemented in subclasses in order to handle change of cell attributes when rows are being deleted.

Since:: 2.2.1

Reimplemented from QicsCommonAttributeController.

virtual void QicsRegionalAttributeController::handleDeleteColumns	(	int	,
		int
	)			`[protected, virtual]`

Called internally from deleteColumns(). Should be reimplemented in subclasses in order to handle change of cell attributes when columns are being deleted.

Since:: 2.2.1

Reimplemented from QicsCommonAttributeController.

virtual void* QicsCommonAttributeController::rowProperty	(	int	row,
		int	name
	)			`[virtual, inherited]`

Returns pointer to a row row property name, 0 if not found.

Implements QicsAbstractAttributeController.

virtual void* QicsCommonAttributeController::columnProperty	(	int	col,
		int	name
	)			`[virtual, inherited]`

Returns pointer to a column col property name, 0 if not found.

Implements QicsAbstractAttributeController.

virtual void* QicsCommonAttributeController::defaultProperty ( int name ) [virtual, inherited]

Returns pointer to default property name, 0 if not found.

Implements QicsAbstractAttributeController.

virtual bool QicsCommonAttributeController::setRowProperty	(	int	row,
		int	name,
		const void *	val
	)			`[virtual, inherited]`

Sets a row row property name to a value of val. Returns true if ok, false if such property cannot be set (i.e. not supported).

Implements QicsAbstractAttributeController.

virtual bool QicsCommonAttributeController::setColumnProperty	(	int	col,
		int	name,
		const void *	val
	)			`[virtual, inherited]`

Sets a column col property name to a value of val. Returns true if ok, false if such property cannot be set (i.e. not supported).

Implements QicsAbstractAttributeController.

virtual bool QicsCommonAttributeController::setDefaultProperty	(	int	name,
		const void *	val
	)			`[virtual, inherited]`

Sets default property name to a value of val. Returns true if ok, false if such property cannot be set (i.e. not supported).

Implements QicsAbstractAttributeController.

virtual bool QicsCommonAttributeController::clearRowProperty	(	int	row,
		int	name
	)			`[virtual, inherited]`

Clears row row property name. Returns true if ok, false if such property cannot be cleared (i.e. not supported).

Implements QicsAbstractAttributeController.

virtual bool QicsCommonAttributeController::clearColumnProperty	(	int	col,
		int	name
	)			`[virtual, inherited]`

Clears column col property name. Returns true if ok, false if such property cannot be cleared (i.e. not supported).

Implements QicsAbstractAttributeController.

virtual bool QicsCommonAttributeController::isPropertySupported ( int ) [virtual, inherited]

Returns true if property name is supported. Else returns false.

Reimplemented from QicsAbstractAttributeController.

Reimplemented in QicsQtModelAttributeController.

virtual bool QicsCommonAttributeController::isDefaultPropertySupported ( int ) [virtual, inherited]

Returns true if default property name is supported. Else returns false.

Reimplemented from QicsAbstractAttributeController.

virtual QicsCellStyle* QicsCommonAttributeController::defaultStyle ( ) [inline, virtual, inherited]

Returns default style.

Implements QicsAbstractAttributeController.

virtual void QicsCommonAttributeController::setDefaultStyle ( QicsCellStyle * style ) [virtual, inherited]

Sets default style.

Implements QicsAbstractAttributeController.

virtual void QicsCommonAttributeController::setGridInfo ( QicsGridInfo * ) [inline, virtual, inherited]

Sets grid info of a parent.

Implements QicsAbstractAttributeController.

virtual void QicsCommonAttributeController::reinit	(	int	rows,
		int	columns
	)			`[virtual, inherited]`

Performs total reinitialization based on new amount of columns and rows.

Implements QicsAbstractAttributeController.

Reimplemented in QicsQtModelAttributeController.

virtual void QicsCommonAttributeController::insertRows	(	int	num,
		int	start_position
	)			`[virtual, inherited]`

Inserts num rows, starting at start_position.

Implements QicsAbstractAttributeController.

virtual void QicsCommonAttributeController::insertColumns	(	int	num,
		int	start_position
	)			`[virtual, inherited]`

Inserts num columns, starting at start_position.

Implements QicsAbstractAttributeController.

virtual void QicsCommonAttributeController::deleteRows	(	int	num,
		int	start_position
	)			`[virtual, inherited]`

Deletes num rows, starting at start_position.

Implements QicsAbstractAttributeController.

virtual void QicsCommonAttributeController::deleteColumns	(	int	num,
		int	start_position
	)			`[virtual, inherited]`

Deletes num columns, starting at start_position.

Implements QicsAbstractAttributeController.

virtual QicsCellStyle* QicsAbstractAttributeController::cellStyle	(	int	row,
		int	column
	)			`[virtual, inherited]`

Returns cell style from row and column.

virtual void QicsAbstractAttributeController::setCellStyle	(	int	row,
		int	column,
		QicsCellStyle *	style
	)			`[virtual, inherited]`

Sets cell style for row and column.

virtual QicsCellStyle* QicsAbstractAttributeController::rowStyle ( int row ) [virtual, inherited]

Returns cell style from row.

virtual void QicsAbstractAttributeController::setRowStyle	(	int	row,
		QicsCellStyle *	style
	)			`[virtual, inherited]`

Sets cell style for row.

virtual QicsCellStyle* QicsAbstractAttributeController::columnStyle ( int column ) [virtual, inherited]

Returns cell style from column.

virtual void QicsAbstractAttributeController::setColumnStyle	(	int	column,
		QicsCellStyle *	style
	)			`[virtual, inherited]`

Sets cell style for column.

QicsTable Documentation Set

QicsRegionalAttributeController Class Reference

Public Types

Public Member Functions

Protected Types

Protected Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

Member Function Documentation