IliTableSelection Class Reference

Structure. More...

#include <ilviews/dataccess/tblsel.h>

Inherited by IliFloatingTableSelection.

List of all members.

Public Member Functions
	IliTableSelection (IliTableSelectionType t=IliSelectNone, IlInt r=0, IlInt c=0)
	This constructor initializes the table selection.
void	addColumn (IlInt colno)
	Adds a column to the selection.
void	addRange (IlInt from, IlInt to)
	Adds a range in the selection.
void	addRow (IlInt rowno)
	Adds to the selection a row.
IlBoolean	contains (const IliTableSelection &sel) const
	Returns IlTrue if a selection is included in the selection.
IlBoolean	containsCell (IlInt rowno, IlInt colno) const
	Returns IlTrue if a cell is included in the selection.
IlBoolean	containsColumn (IlInt colno) const
	Returns IlTrue if a column is included in the selection.
IlBoolean	containsRange (IlInt from, IlInt to) const
	IlTrue if the range set of rows belongs to the selection.
IlBoolean	containsRow (IlInt rowno) const
	Returns IlTrue if a row is included in the selection.
IlInt	getColumn () const
	Returns the column position of the selected column or cell.
IlInt	getColumnAt (IlInt idx) const
	Returns a column position from the selection.
IlInt	getColumnsCount () const
	Returns the number of columns included in the selection.
void	getRangeAt (IlInt idx, IlInt &from, IlInt &to) const
	Returns a range from the selection.
IlInt	getRangesCount () const
	Returns the number of ranges included in the selection.
IlInt	getRow () const
	Returns the row position of the selected row or cell.
IlInt	getRowAt (IlInt idx) const
	Returns a row position from the selection.
IlInt	getRowsCount () const
	Returns the number of rows included in the selection.
IliTableSelectionType	getType () const
	Returns the selection type.
IlBoolean	isCell () const
	Returns IlTrue if one cell is selected.
IlBoolean	isColumn () const
	IlTrue if one column is selected.
IlBoolean	isColumnOrCell () const
	Returns IlTrue if one column or one cell is selected.
IlBoolean	isEmpty () const
	Returns IlTrue if the selection is empty.
IlBoolean	isFull () const
	Returns IlTrue if the table-gadget is selected in its entirety.
IlBoolean	isMulti () const
	Returns IlTrue if the selection contains more than one row or column.
IlBoolean	isRow () const
	Returns IlTrue if one row is selected.
IlBoolean	isRowOrCell () const
	Returns IlTrue if one row or one cell is selected.
void	removeColumn (IlInt colno)
	Removes a column from the selection.
void	removeRange (IlInt from, IlInt to)
	Removes a range from the selection.
void	removeRow (IlInt rowno)
	Removes a row from the selection.
void	setColumn (IlInt colno)
	Sets the column position of the selected column or cell.
void	setRow (IlInt rowno)
	Sets the row position of the selected row or cell.
void	setType (IliTableSelectionType type)
	Sets the selection type.

---

Detailed Description

Structure.

Library: dataccess

This class describes a selection in a table gadget.

See also:

IliTableGadget, IliTableSelectionType

---

Constructor & Destructor Documentation

IliTableSelection::IliTableSelection	(	IliTableSelectionType	t = IliSelectNone,
		IlInt	r = 0,
		IlInt	c = 0
	)

This constructor initializes the table selection.

Parameters:

	t	The selection type.
	rowno	The row position.
	colno	The column position.

---

Member Function Documentation

void IliTableSelection::addColumn

(

IlInt

colno

)

Adds a column to the selection.

Parameters:

colno

The column position in the table-gadget.

void IliTableSelection::addRange	(	IlInt	from,
		IlInt	to
	)

Adds a range in the selection.

This range designates either a set of rows or a set of columns (depending on whether the type of the selection is IliSelectRow or IliSelectColumn.)

Parameters:

	from	The lower bound (inclusive) of the range.
	to	The upper bound (inclusive) of the range.

void IliTableSelection::addRow

(

IlInt

rowno

)

Adds to the selection a row.

Parameters:

rowno

The row position in the table-gadget.

IlBoolean IliTableSelection::contains

(

const IliTableSelection &

sel

)

const

Returns IlTrue if a selection is included in the selection.

Parameters:

sel

The selection.

Returns:

IlTrue if a selection is included in the selection.

IlBoolean IliTableSelection::containsCell	(	IlInt	rowno,
		IlInt	colno
	)			const

Returns IlTrue if a cell is included in the selection.

This can happen if the type of the selection is IliSelectCell, IliSelectRow, IliSelectColumn, or IliSelectAll.

Parameters:

	rowno	The row position.
	colno	The column position.

Returns:

IlTrue if a cell is included in the selection.

IlBoolean IliTableSelection::containsColumn

(

IlInt

colno

)

const

Returns IlTrue if a column is included in the selection.

This can only happen if the type of the selection is IliSelectColumn or IliSelectAll.

Parameters:

colno

The column position.

Returns:

IlTrue if a column is included in the selection.

IlBoolean IliTableSelection::containsRange	(	IlInt	from,
		IlInt	to
	)			const

IlTrue if the range set of rows belongs to the selection.

Parameters:

	from	The lower bound (inclusive) of the range.
	to	The upper bound (inclusive) of the range.

Returns:

IlTrue if the range set of rows belongs to the selection.

IlBoolean IliTableSelection::containsRow

(

IlInt

rowno

)

const

Returns IlTrue if a row is included in the selection.

This can only happen if the type of the selection is IliSelectRow or IliSelectAll.

Parameters:

rowno

The row position.

Returns:

IlTrue if a row is included in the selection.

IlInt IliTableSelection::getColumn

(

)

const

Returns the column position of the selected column or cell.

Returns:

The position.

IlInt IliTableSelection::getColumnAt

(

IlInt

idx

)

const

Returns a column position from the selection.

Parameters:

idx

The index in the selection. The value is between 0 and getColumnsCount().

Returns:

The column position.

IlInt IliTableSelection::getColumnsCount

(

)

const

Returns the number of columns included in the selection.

Returns:

The count.

void IliTableSelection::getRangeAt	(	IlInt	idx,
		IlInt &	from,
		IlInt &	to
	)			const

Returns a range from the selection.

Parameters:

	idx	The range index in the selection. The value is between 0 and getRangesCount().
	from	The lower bound (inclusive) of the range.
	to	The upper bound (inclusive) of the range.

Returns:

The range.

IlInt IliTableSelection::getRangesCount

(

)

const

Returns the number of ranges included in the selection.

Returns:

The count.

IlInt IliTableSelection::getRow

(

)

const

Returns the row position of the selected row or cell.

Returns:

The position.

IlInt IliTableSelection::getRowAt

(

IlInt

idx

)

const

Returns a row position from the selection.

Parameters:

idx

The index in the selection. The value is between 0 and getRowsCount().

Returns:

The row position.

IlInt IliTableSelection::getRowsCount

(

)

const

Returns the number of rows included in the selection.

Returns:

The count.

IliTableSelectionType IliTableSelection::getType

(

)

const

Returns the selection type.

Returns:

The type.

IlBoolean IliTableSelection::isCell

(

)

const

Returns IlTrue if one cell is selected.

Returns:

IlTrue if one cell is selected. In this case, the selected cell is identified by the getRow and getColumn member functions.

IlBoolean IliTableSelection::isColumn

(

)

const

IlTrue if one column is selected.

In this case, the selected column is identified by the getColumn member function.

Returns:

IlTrue if one column is selected.

IlBoolean IliTableSelection::isColumnOrCell

(

)

const

Returns IlTrue if one column or one cell is selected.

Returns:

IlTrue if one column or one cell is selected.

IlBoolean IliTableSelection::isEmpty

(

)

const

Returns IlTrue if the selection is empty.

Returns:

IlTrue if the selection is empty.

IlBoolean IliTableSelection::isFull

(

)

const

Returns IlTrue if the table-gadget is selected in its entirety.

Returns:

IlTrue if the table-gadget is selected in its entirety.

IlBoolean IliTableSelection::isMulti

(

)

const

Returns IlTrue if the selection contains more than one row or column.

Returns:

IlTrue if the selection contains more than one row or column.

IlBoolean IliTableSelection::isRow

(

)

const

Returns IlTrue if one row is selected.

In this case,the selected row is identified by the getRow member function.

Returns:

IlTrue if one row is selected.

IlBoolean IliTableSelection::isRowOrCell

(

)

const

Returns IlTrue if one row or one cell is selected.

Returns:

IlTrue if one row or one cell is selected.

void IliTableSelection::removeColumn

(

IlInt

colno

)

Removes a column from the selection.

Parameters:

colno

The column position in the table-gadget.

void IliTableSelection::removeRange	(	IlInt	from,
		IlInt	to
	)

Removes a range from the selection.

Depending on whether the type of the selection is IliSelectRow or IliSelectColumn, this member function will remove from the selection all rows, (or all columns) whose position falls within the range.

Parameters:

	from	The lower bound (inclusive) of the range.
	to	The upper bound (inclusive) of the range.

void IliTableSelection::removeRow

(

IlInt

rowno

)

Removes a row from the selection.

Parameters:

rowno

The row position in the table-gadget.

void IliTableSelection::setColumn

(

IlInt

colno

)

Sets the column position of the selected column or cell.

Parameters:

colno

The column position.

void IliTableSelection::setRow

(

IlInt

rowno

)

Sets the row position of the selected row or cell.

Parameters:

rowno

The row position.

void IliTableSelection::setType

(

IliTableSelectionType

type

)

Sets the selection type.

Parameters:

type

The selection type.