IliTableGadget Class Reference

Field gadget class. More...

#include <ilviews/dataccess/gadgets/tablegad.h>

Inheritance diagram for IliTableGadget:

Public Member Functions
	IliTableGadget (IlvDisplay display, IliTable table, IlBoolean owner, const IlvRect &rect, IlUShort thickness=IlvDefaultGadgetThickness, IlvPalette *palette=0)
	This constructor initializes a table gadget that is connected to a table.
	IliTableGadget (IlvDisplay display, const IlvRect &rect, IlUShort thickness=IlvDefaultGadgetThickness, IlvPalette palette=0)
	This constructor initializes a table gadget that is connected to a default table.
void	addErrorMessage (const char *msg)
	Forwards an application error message to all the error sinks that have been added with the `addErrorSink` member function.
void	addErrorMessage (const IliErrorMessage &msg)
	Forwards an error message to all the error sinks that have been added with the `addErrorSink` member function.
void	addErrorSink (IliErrorSink *sink)
	All errors that occur on the table-gadget table or on the table-gadget data source (if it is bound to a data source) and all errors that are thrown by one of the `addErrorMessage` member functions, will be forwarded to this error sink.
void	allowColumnMove (IlBoolean flag)
	Allows or not the column moving by the end-user.
void	allowColumnResize (IlBoolean flag)
	Enables/disables the column resizing by the end-user.
void	allowRowMove (IlBoolean flag)
	Enables/disables the row moving by the end-user.
void	allowRowResize (IlBoolean flag)
	Enables/disables the end-user to resize rows.
IlBoolean	areToolTipsEnabled () const
	Returns `IlTrue` if tooltip display is enabled.
IliValue	at (IlInt rowno, const char *colname) const
	Returns a value.
IliValue	at (IlInt rowno, IlInt colno) const
	Returns a value.
void	bindToDataSource (IlBoolean flag)
	Enables/Disables the bind data source option.
virtual void	cancel ()
	Cancels any user input awaiting validation.
IlBoolean	cellBBox (const IliTableSelection &sel, IlvRect &rect, const IlvTransformer *t=0) const
	Returns the bounding box of a selection, according to one (optional) transformer.
void	copyToClipboard () const
	Copies the contents of the current selection to the clipboard.
void	copyToClipboard (const IliTableSelection &sel) const
	Copies the contents of one selection to the clipboard.
void	defaultDrawCell () const
	This member function may be called from the `onDrawCell` virtual member function or from the corresponding callback.
void	disableImmediateRefresh (IlBoolean disable)
	Disables the immediate refreshes of the gadget.
void	dontDeleteRow ()
	Cancels the row deletion.
void	dontValidateCell ()
	Called from the `onValidateCell` virtual member function, or from its corresponding callback.
void	dontValidateRow ()
	Cancels the row validation.
virtual void	drawCell (IlvPort dst, IlInt rowno, IlInt colno, const char label, IlvAlignment align, IlBoolean selected, const IlvRect &bbox, IlvPalette palette, const IlvRegion clip) const
	Draws a cell.
virtual void	drawCorner (IlvPort dst, IlBoolean selected, const IlvRect &bbox, const IlvRegion clip) const
	Draws the upper left corner of the table gadget.
virtual void	drawHeader (IlvPort dst, IlInt colno, const char label, IlBoolean selected, const IlvRect &bbox, const IlvRegion *clip) const
	Draws a header.
virtual void	drawHorzRule (IlvPort dst, IlvPos x1, IlvPos x2, IlvPos y, IlInt rowno, IlInt colnoLeft, IlInt colnoRight, IlvPalette palette, const IlvRegion *clip) const
	Draws a horizontal rule of the table gadget grid.
virtual void	drawMarker (IlvPort dst, IlInt rowno, IlBoolean selected, IlBoolean current, const IlvRect &bbox, const IlvRegion clip) const
	Draws a marker.
virtual void	drawVertRule (IlvPort dst, IlvPos y1, IlvPos y2, IlvPos x, IlInt colno, IlInt rownoTop, IlInt rownoBot, IlvPalette palette, const IlvRegion *clip) const
	Draws a vertical rule of the table gadget grid.
void	enableKeyboardDeleteRow (IlBoolean flag)
	Enables/disables the user to delete the current row using the delete key.
void	enableKeyboardRefresh (IlBoolean flag)
	Enables/disables the refresh key by the user.
void	enableMultiSelection (IlBoolean flag)
	Enables/disables multi-selection mode.
void	enableRowSelect (IlBoolean flag)
	Enables/disables row selection mode.
void	enableSort (IlBoolean flag)
	Enables/disables the row sorting.
void	enableToolTips (IlBoolean flag)
	Enables or disables the display of the tooltips.
void	endOfBatch ()
	Used in conjunction with the `startOfBatch` member function to terminate a series of modifications on the table gadget. Calls to `startOfBatch` and `endOfBatch` can be nested.
void	ensureSelectionVisible ()
	Scrolls the table gadget so that its current selection becomes visible in the bounding box of the table gadget.
void	ensureVisible (IliTableSelection sel)
	Scrolls the table gadget so that the selection becomes visible in the bounding box of the table gadget.
virtual IlBoolean	f_complete ()
	Updates the internal value of the field, according to its current external representation and its foreign table, provided completion is enabled for the field.
virtual IlBoolean	f_externalToInternal ()
	Updates the internal value of a field according to its current external representation.
virtual IliTablePropertyManager *	f_getEffectiveTablePropertyManager ()
	Returns the effective table property manager.
virtual const IliTablePropertyManager *	f_getEffectiveTablePropertyManager () const
	Returns the effective table property manager.
virtual const IliValue &	f_getValue (IlBoolean internalP=IlFalse) const
	Returns the value of the field.
virtual void	f_internalToExternal ()
	Updates the external representation of the field and its display according to its current internal value.
virtual IlBoolean	f_isAutoFitPullDown () const
	Returns `IlTrue` if the width of the pull-down menu is automatically computed so that its contents fit.
virtual IlBoolean	f_isConsistent () const
	Returns `IlTrue` if the internal value of the field corresponds to its current external representation.
virtual IlBoolean	f_isInputModified () const
	Returns `IlTrue` if the external representation has been edited by the end-user.
virtual IlBoolean	f_isReadOnly () const
	Returns `IlTrue` if the field is read-only.
virtual void	f_setAutoFitPullDown (IlBoolean flag)
	Enables/disables the automatic width computing of the pull-down menu.
virtual void	f_setInputModified (IlBoolean f)
	Sets the input-modified attribute of the field.
virtual void	f_setReadOnly (IlBoolean f)
	Sets the read-only property for the field.
virtual void	f_setTablePropertyManagerName (const char *name)
	Sets the name of the table property manager to use.
virtual IlBoolean	f_setValue (const IliValue &, IlBoolean internalP=IlFalse)
	Sets the value of the field.
virtual void	f_useTableProperties (IlBoolean)
	Enables/Disables the use of the table properties.
IliTableFittingMode	getAutoFittingMode () const
	Returns the auto-fitting mode.
IlInt	getBatchCount () const
	Returns the current number of nested calls to `startOfBatch`.
IlvColor *	getCellBackground () const
	Returns the background color used to draw cells.
IlvFont *	getCellFont () const
	Returns the font used to draw cells.
IlvColor *	getCellForeground () const
	Returns the foreground color used to draw cells.
IliCellPaletteStruct *	getCellPaletteStruct () const
	Returns the description of the cell for which text and fill palettes are currently required, as well as the default values for these palettes.
IlInt	getColumnDisplayWidth (IlInt colno) const
	Returns the column width, in pixels.
IliFieldItf *	getColumnEditor (IlInt colno) const
	Returns the field that is used as an editor for a column.
IlInt	getColumnsCount () const
	Returns the number of columns in the underlying table.
IlAny	getCompareData () const
	Returns the user data that can be used to compare two rows.
IliCompareFunction	getCompareFunction () const
	Returns the function that is used to compare two rows.
IlInt	getCurrentColumn () const
	Returns current column.
IlInt	getCurrentRow () const
	Returns current row.
virtual IliFieldItf *	getCustomEditor (IlInt rowno, IlInt colno, IliFieldItf *fld) const
	Returns the field to use as an editor for a cell.
IlInt	getDeletedRow () const
	Returns the deleted row position.
IliDrawCellStruct *	getDrawCellStruct () const
	Returns the description of the cell that is currently being drawn.
IliErrorReporter *	getErrorReporter () const
	Returns the error reporter that is used by the `reportErrors` member functions.
IlInt	getExtendedRowsCount () const
	Returns the number of rows in the underlying table (plus one if the insert row is currently shown).
IlInt	getFetchedRow () const
	Returns the fetched row position.
IlInt	getFirstColumn () const
	Returns the position of the first column shown (from left to right).
IlInt	getFirstRow () const
	Returns the position in the underlying table of the first row shown (from top to bottom).
IlInt	getFixedColumnsCount () const
	Returns the number of columns that do not scroll. These are the left-most columns.
IlvDim	getHeaderHeight () const
	Returns header height, in pixels, of the column headers.
virtual IlvPalette *	getHeaderTextPalette (IlInt colno) const
	Returns the header text palette.
IlvDim	getMarkerWidth () const
	Returns the marker width, in pixels, of the row markers.
IlInt	getRealIndex (IlInt colno) const
	Returns the position, in the underlying table, of the column in the table gadget.
virtual IlvPalette *	getReliefPalette () const
	Returns the relief palette.
IlvDim	getRowHeight () const
	Returns the height, in pixels, of the rows in the table gadget.
IlInt	getRowsCount () const
	Returns the number of rows in the underlying table.
IlvScrollBar *	getScrollBar (IlvPosition which) const
	Returns a scroll bar.
IliShowMode	getScrollBarShowMode (IlvPosition which) const
	Returns the show mode for a scroll bar.
void	getSelection (IliTableSelection &sel) const
	Returns the current selection in the table gadget.
IliTable *	getTable ()
	Returns the underlying table of the table gadget.
const IliTable *	getTable () const
	Returns the underlying table of the table gadget.
IliTablePropertyManager *	getTablePropertyManager ()
	Returns the table property manager used.
const IliTablePropertyManager *	getTablePropertyManager () const
	Returns the table property manager used.
const char *	getTablePropertyManagerName () const
	Returns the table property manager name.
virtual void	getToolTipsText (const IlvPoint &pt, IliString &s)
	Returns the tooltip text that must be displayed.
const IliValue &	getValue (IliName colname) const
	Returns the value at the column named `colname` in the row buffer of the table gadget.
const IliValue &	getValue (IlInt colno) const
	Returns the value at column `colno` in the row buffer of the table gadget.
IlInt	getVisibleRowsCount (IlBoolean &lastRowClipped) const
	Returns the maximum row count that are shown in the table gadget.
IlInt	getVisualIndex (IlInt colno) const
	Returns the position, in the table gadget, of the column in the underlying table.
IlBoolean	gotoInsertRow ()
	Attempts to move the current row to the insert row.
virtual IlBoolean	gotoNextColumn ()
	Attempts to move the current column to the next shown column.
virtual IlBoolean	gotoNextRow ()
	Attempts to move the current row to the next row.
virtual IlBoolean	gotoPreviousColumn ()
	Attempts to move the current column to the previous shown column.
virtual IlBoolean	gotoPreviousRow ()
	Attempts to move the current row to the previous row.
IlBoolean	hasCustomCellPalettes () const
	Returns `IlTrue` if the table gadget calls the `onGetCellPalette` virtual member function for each cell being drawn.
IlBoolean	isBoundToDataSource () const
	Returns `IlTrue` if the table gadget is bound to its data source.
IlBoolean	isCellEditorShown () const
	Returns `IlTrue` if the cell editor is shown in the selected cell when the cell is read-only.
IlBoolean	isColumnGeometryLocal () const
	Returns `IlTrue` if the end-user is able to change the order of the columns.
IlBoolean	isColumnMoveAllowed () const
	Returns `IlTrue` if the end-user is able to change the order of the columns.
IlBoolean	isColumnResizeAllowed () const
	Returns `IlTrue` if the end-user is able to resize columns.
IlBoolean	isColumnVisible (IlInt colno) const
	Returns the column visibility.
IlBoolean	isConfirmOnDeleteRequired () const
	Returns `IlTrue` if the user is prompted for a confirmation before row deletion.
IlBoolean	isImmediateRefreshDisabled () const
	Returns `IlTrue` if the immediate refreshes are disabled.
IlBoolean	isInInsertMode () const
	Returns `IlTrue` if the current row is the insert row and if the current row buffer is modified.
IlBoolean	isInsertRow (IlInt rowno) const
	Returns `IlTrue` if a row designates the insert row.
IlBoolean	isInUpdateMode () const
	Returns `IlTrue` if the current row corresponds to an existing table row (that is, it is not the insert row), and if the current row buffer is modified.
IlBoolean	isKeyboardDeleteRowEnabled () const
	Returns `IlTrue` if the user can use the delete key to delete the current row.
IlBoolean	isKeyboardRefreshEnabled () const
	Returns `IlTrue` if the user can use the refresh key.
IlBoolean	isMultiSelectionEnabled () const
	Returns `IlTrue` if the table gadget event handler allows the end-user to select more than one row or column.
IlBoolean	isOnInsertRow () const
	Returns `IlTrue` if the current row is the insert row.
IlBoolean	isReadOnly () const
	Returns `IlTrue` if the table gadget is read-only.
IlBoolean	isRowMoveAllowed () const
	Returns `IlTrue` if the end-user is able to change the order of the rows.
IlBoolean	isRowResizeAllowed () const
	Returns `IlTrue` if the end-user is able to resize rows.
IlBoolean	isRowSelectEnabled () const
	Returns `IlTrue` if the row select mode is enabled.
IlBoolean	isSelectionAlwaysShown () const
	Returns `IlTrue` if the selection of the table gadget is always highlighted.
IlBoolean	isShowingGrid () const
	Returns `IlTrue` if the table gadget is drawn with a grid.
IlBoolean	isShowingHeaders () const
	Returns `IlTrue` if the column headers are shown.
IlBoolean	isShowingInsertRow () const
	Returns `IlTrue` if the insert row is shown.
IlBoolean	isShowingMarkers () const
	Returns `IlTrue` if the row markers are shown.
IlBoolean	isSortEnabled () const
	Returns `IlTrue` if the table gadget event handler will sort the rows according to the column header on which the user clicks.
IlBoolean	isTableOwner () const
	Returns `IlTrue` if the table gadget owns its table.
IlBoolean	isUsingRelief () const
	Returns `IlTrue` if the table gadget is drawn with a relief border.
IlBoolean	isUsingTableProperties () const
	Returns `IlTrue` if the table gadget is sensitive to table properties.
IlBoolean	moveColumn (IlInt from, IlInt to)
	Attempts to move the column from a position to another position.
virtual void	onCancelEdits ()
	Called just after the edits in the current row have been canceled.
virtual void	onDeleteRow ()
	Called just before a row in the underlying table is deleted.
virtual void	onDoubleClick ()
	Called just after a double-click on the table gadget.
virtual void	onDrawCell ()
	Called to draw a cell in the table gadget.
virtual void	onEnterCell ()
	Called just after a new cell is entered.
virtual void	onEnterInsertMode ()
	Called just after the current row buffer becomes modified, when the current row is the insert row.
virtual void	onEnterRow ()
	Called just after a new row is entered.
virtual void	onEnterUpdateMode ()
	Called just after the current row buffer becomes modified (when the current row is not the insert row).
virtual void	onFetchRow ()
	Called just after a new row has been retrieved from a remote database and cached in the underlying table.
virtual void	onGetCellPalette ()
	Called when the text and fill palettes of a cell are required (either to draw the cell or to configure the cell editor).
virtual void	onPrepareDeleteRow ()
	Called when the user attempts to delete a row through this table gadget.
virtual void	onPrepareInsert ()
	Called when an attempt is made to validate the current row, when the current row is the insert row.
virtual void	onPrepareUpdate ()
	Called when an attempt is made to validate the current row (when the current row is not the insert row).
virtual void	onQuitCell ()
	Called just before the selection moves out of a cell.
virtual void	onQuitInsertMode ()
	Called just after the current row has been successfully validated, when the current row is the insert row.
virtual void	onQuitRow ()
	Called just before the selection moves out of a row.
virtual void	onQuitUpdateMode ()
	Called just after the current (non insert) row has been successfully validated.
virtual void	onSelectionChange ()
	Called just after the selection has changed (whatever the change).
virtual void	onValidateCell ()
	Called when an attempt is made to move the selection out of a cell.
virtual void	onValidateRow ()
	Called when an attempt is made to validate the current row.
void	pasteFromClipboard ()
	Pastes the contents of the clipboard into the current selection.
void	pasteFromClipboard (const IliTableSelection &sel)
	Pastes the contents of the clipboard into the selection.
IlBoolean	pointToSelection (const IlvPoint &pt, IliTableSelection &sel, const IlvTransformer *t=0) const
	Returns the selection pointed by a point.
void	refreshAll ()
	Redraws the table gadget in its entirety.
void	refreshCell (IlInt rowno, IlInt colno)
	Redraws a cell.
void	refreshColumn (IlInt colno)
	Redraws a column.
void	refreshRow (IlInt rowno)
	Redraws a row.
void	removeErrorSink (IliErrorSink *sink)
	Removes an error sink from this table gadget.
void	reportErrors (const IliErrorList &errorList) const
	Reports the errors that are contained in a error list.
void	requireConfirmOnDelete (IlBoolean flag)
	Enables/disables confirmation before row deletion.
virtual void	scrollTo (IlInt rowno, IlInt colno)
	Scrolls to a cell.
void	scrollToColumn (IlInt colno)
	Scrolls to a column.
void	scrollToRow (IlInt rowno)
	Scrolls to a row.
IlBoolean	selectAll ()
	Attempts to select all rows and columns.
IlBoolean	selectCell (IlInt rowno, IlInt colno)
	Attempts to select the cell at a row and a column.
IlBoolean	selectColumn (IlInt colno)
	Attempts to select a column.
IlBoolean	selectNone ()
	Attempts to deselect the current selection.
IlBoolean	selectRow (IlInt rowno)
	Attempts to select a row.
void	setAutoFittingMode (IliTableFittingMode mode)
	Sets the auto-fitting mode.
virtual void	setCellBackground (IlvColor *color)
	Sets the background color used to draw cells.
virtual void	setCellFont (IlvFont *font)
	Sets the font used to draw cells.
virtual void	setCellForeground (IlvColor *color)
	Sets the foreground color used to draw cells.
void	setColumnDisplayWidth (IlInt colno, IlInt width)
	Sets column width, in pixels.
IlBoolean	setColumnEditor (IlInt colno, IliFieldItf *fld, IlBoolean owner=IlTrue)
	Sets the field that is used as an editor for column.
void	setColumnGeometryLocal (IlBoolean flag)
	Enables/disables the column moving.
void	setColumnVisible (IlInt colno, IlBoolean flag)
	Sets column visibility.
void	setCompareFunction (IliCompareFunction fct, IlAny arg=0)
	Defines the function `fct` and user data that must be used to compare two rows.
void	setCustomCellPalettes (IlBoolean flag)
	Enables/disables the use of specific palettes for a cell.
void	setErrorReporter (IliErrorReporter *reporter)
	Sets the error reporter.
IlBoolean	setFixedColumnsCount (IlInt count)
	Sets the number of columns that do not scroll.
void	setHeaderHeight (IlvDim h)
	Sets header height.
void	setMarkerWidth (IlvDim w)
	Sets the marker width.
IlBoolean	setReadOnly (IlBoolean flag)
	Sets the table gadget as read-only or not.
void	setReliefPalette (IlvPalette *pal)
	Sets the relief palette.
void	setRowHeight (IlvDim h)
	Sets the height of the rows in a table gadget.
virtual IlBoolean	setSelection (const IliTableSelection &sel)
	Attempts to set the table gadget selection.
virtual void	setTable (IliTable *table, IlBoolean owner=IlTrue)
	Connects the table gadget to a table.
void	setTablePropertyManager (IliTablePropertyManager *propMgr)
	Sets the table property manager.
void	setTablePropertyManagerName (const char *name)
	Sets the table property manager name.
IlBoolean	setValue (IliName colname, const IliValue &value)
	Sets the value at the column named `colname`, in the row buffer of the table gadget, to `value`.
IlBoolean	setValue (IlInt colno, const IliValue &value)
	Sets the value at column `colno`, in the row buffer of the table gadget, to `value`.
void	setVisibleRowsCount (IlInt count)
	Changes the height of the table gadget so that the maximum number of rows can be shown.
void	showCellEditor (IlBoolean flag)
	Specifies that the cell editor is shown in read-only cells.
void	showGrid (IlBoolean flag)
	Shows/Hides grid.
void	showHeaders (IlBoolean flag)
	Shows/Hides the column headers.
IlBoolean	showInsertRow (IlBoolean flag)
	Shows/Hides insert row.
void	showMarkers (IlBoolean flag)
	Shows/Hides row markers.
void	showScrollBar (IlvPosition which, IliShowMode mode)
	Sets the show mode for a scroll bar.
void	showSelectionAlways (IlBoolean flag)
	Shows/hides the selection.
void	sortColumn (IlInt colno)
	Sorts the rows according to ascending or descending order of column.
void	startOfBatch ()
	Used to start a series of modifications to the table gadget. It allows the table gadget to significantly reduce the time needed to reformat itself.
void	useRelief (IlBoolean flag)
	Shows/Hides relief border.
void	useTableProperties (IlBoolean flag)
	Sets the table gadget sensitivity about table properties.
virtual IlBoolean	validate (IlBoolean interactive=IlFalse)
	Validates the current row.
Static Public Member Functions
static IlvSymbol *	CancelEditsSymbol ()
	Returns the name of the callback that will be called by the corresponding virtual member function.
static IlvSymbol *	DeleteRowSymbol ()
	Returns the name of the callback that will be called by the corresponding virtual member function.
static IlvSymbol *	DoubleClickSymbol ()
	Returns the name of the callback that will be called by the corresponding virtual member function.
static IlvSymbol *	DrawCellSymbol ()
	Returns the name of the callback that will be called by the corresponding virtual member function.
static IlvSymbol *	EnterCellSymbol ()
	Returns the name of the callback that will be called by the corresponding virtual member function.
static IlvSymbol *	EnterInsertModeSymbol ()
	Returns the name of the callback that will be called by the corresponding virtual member function.
static IlvSymbol *	EnterRowSymbol ()
	Returns the name of the callback that will be called by the corresponding virtual member function.
static IlvSymbol *	EnterUpdateModeSymbol ()
	Returns the name of the callback that will be called by the corresponding virtual member function.
static IlvSymbol *	FetchRowSymbol ()
	Returns the name of the callback that will be called by the corresponding virtual member function.
static IlvSymbol *	GetCellPaletteSymbol ()
	Returns the name of the callback that will be called by the corresponding virtual member function.
static void	GetRefreshShortCut (IlUShort &modifiers, IlUShort &key)
	Returns the definition of the shortcut key that refreshes all.
static IlvSymbol *	PrepareDeleteRowSymbol ()
	Returns the name of the callback that will be called by the corresponding virtual member function.
static IlvSymbol *	PrepareInsertSymbol ()
	Returns the name of the callback that will be called by the corresponding virtual member function.
static IlvSymbol *	PrepareUpdateSymbol ()
	Returns the name of the callback that will be called by the corresponding virtual member function.
static IlvSymbol *	QuitCellSymbol ()
	Returns the name of the callback that will be called by the corresponding virtual member function.
static IlvSymbol *	QuitInsertModeSymbol ()
	Returns the name of the callback that will be called by the corresponding virtual member function.
static IlvSymbol *	QuitRowSymbol ()
	Returns the name of the callback that will be called by the corresponding virtual member function.
static IlvSymbol *	QuitUpdateModeSymbol ()
	Returns the name of the callback that will be called by the corresponding virtual member function.
static IlvSymbol *	SelectionChangeSymbol ()
	Returns the name of the callback that will be called by the corresponding virtual member function.
static void	SetRefreshShortCut (IlUShort modifiers, IlUShort key)
	Sets the definition of the shortcut key that refreshes all.
static IlvSymbol *	ValidateCellSymbol ()
	Returns the name of the callback that will be called by the corresponding virtual member function.
static IlvSymbol *	ValidateRowSymbol ()
	Returns the name of the callback that will be called by the corresponding virtual member function.

Detailed Description

Field gadget class.

Library: dbgadget

The IliTableGadget class defines gadgets that can edit and display tables. It works in conjunction with the IliTable class.

About clipboard

The table gadget can copy the contents of a given selection to the clipboard in the form of a character string. Each value in the selection is formatted according to the format and input mask of the column to which this column belongs. If the selection contains more than one column or more than one row, then each row is separated by a new line character and each column is separated by a tab character.

About Callbacks

Some virtual member functions described in this documentation are normally called by the table gadget itself when certain events occur. The behavior of the table gadget can be customized by defining a subclass of IliTableGadget and overriding these virtual member functions. Alternatively, it is possible to customize the behavior of a table gadget without subclassing. This can be done by setting callbacks (see the IlvGraphic::setCallback member function).

The default implementation of these virtual member functions is to call the corresponding callback.

See also:: IliDataSource, IliErrorMessage, IliErrorReporter, IliErrorSink, IliSchema, IliTable, IliCellPaletteStruct, IliDrawCellStruct, IliTableSelection, IliShowMode, IliTableFittingMode, IliTableSelectionType.

Constructor & Destructor Documentation

IliTableGadget::IliTableGadget	(	IlvDisplay *	display,
		const IlvRect &	rect,
		IlUShort	thickness = `IlvDefaultGadgetThickness`,
		IlvPalette *	palette = `0`
	)

This constructor initializes a table gadget that is connected to a default table.

Parameters:

	display	The display.
	rect	The location.
	thickness	The border thickness.
	palette	The palette.

IliTableGadget::IliTableGadget	(	IlvDisplay *	display,
		IliTable *	table,
		IlBoolean	owner,
		const IlvRect &	rect,
		IlUShort	thickness = `IlvDefaultGadgetThickness`,
		IlvPalette *	palette = `0`
	)

This constructor initializes a table gadget that is connected to a table.

Parameters:

	display	The display.
	table	The table.
	owner	The table owner, if `IlTrue`, the table gadget becomes the table owner.
	rect	The location.
	thickness	The border thickness.
	palette	The palette.

Member Function Documentation

void IliTableGadget::addErrorMessage ( const char * msg )

Forwards an application error message to all the error sinks that have been added with the addErrorSink member function.

This member function may be called by one of the onValidateCell, onValidateRow, onPrepareInsert, or onPrepareInsert virtual member functions, or by the corresponding callbacks.

Parameters:

msg

The error message.

void IliTableGadget::addErrorMessage ( const IliErrorMessage & msg )

Forwards an error message to all the error sinks that have been added with the addErrorSink member function.

This member function may be called by one of the onValidateCell, onValidateRow, onPrepareInsert, or onPrepareInsert virtual member functions, or by the corresponding callbacks.

Parameters:

msg

The error message.

void IliTableGadget::addErrorSink ( IliErrorSink * sink )

All errors that occur on the table-gadget table or on the table-gadget data source (if it is bound to a data source) and all errors that are thrown by one of the addErrorMessage member functions, will be forwarded to this error sink.

Note that the table gadget will not delete the error sink at destruction time, so the same error sink may be safely shared by many table gadgets.

Parameters:

sink

The error sink.

void IliTableGadget::allowColumnMove ( IlBoolean flag )

Allows or not the column moving by the end-user.

Parameters:

flag If IlTrue, allows the end-user to move columns around. Otherwise, this feature is disabled.

void IliTableGadget::allowColumnResize ( IlBoolean flag )

Enables/disables the column resizing by the end-user.

Parameters:

flag If IlTrue, allows the end-user to resize columns. Otherwise, this feature is disabled.

void IliTableGadget::allowRowMove ( IlBoolean flag )

Enables/disables the row moving by the end-user.

Parameters:

flag If IlTrue, allows the end-user to move rows around. Otherwise, this feature is disabled.

void IliTableGadget::allowRowResize ( IlBoolean flag )

Enables/disables the end-user to resize rows.

Parameters:

flag If IlTrue, allows the end-user to resize rows. Otherwise, this feature is disabled.

IlBoolean IliTableGadget::areToolTipsEnabled ( ) const

Returns IlTrue if tooltip display is enabled.

Returns:: The tooltip displaying permission.

IliValue IliTableGadget::at	(	IlInt	rowno,
		const char *	colname
	)			const

Returns a value.

Parameters:

	rowno	The row position, if it designates the current row, the value comes from the underlying table. If not, the value comes from the row buffer of the table gadget.
	colname	The column name.

Returns:: The value.

IliValue IliTableGadget::at	(	IlInt	rowno,
		IlInt	colno
	)			const

Returns a value.

Parameters:

	rowno	The row position, if it designates the current row, the value comes from the underlying table. If not, the value comes from the row buffer of the table gadget.
	colno	The column position as it appears in the table gadget (see the `getVisualColno` member function description).

Returns:: The value.

void IliTableGadget::bindToDataSource ( IlBoolean flag )

Enables/Disables the bind data source option.

Parameters:

flag If IlTrue, binds the table gadget to its data source and unbinds it otherwise.

virtual void IliTableGadget::cancel ( ) [virtual]

Cancels any user input awaiting validation.

The row buffer of the table gadget becomes unmodified. This member function calls the onCancelEdits virtual member function.

Note that if the table gadget is bound to a data source, then the onCancelEdits is called on the data source instead of on the table gadget.

static IlvSymbol* IliTableGadget::CancelEditsSymbol ( ) [static]

Returns the name of the callback that will be called by the corresponding virtual member function.

Returns:: The callback name.

IlBoolean IliTableGadget::cellBBox	(	const IliTableSelection &	sel,
		IlvRect &	rect,
		const IlvTransformer *	t = `0`
	)			const

Returns the bounding box of a selection, according to one (optional) transformer.

Parameters:

	sel	The selection.
	rect	The computed bounding box.
	t	The transformer.

Returns:: IlTrue if the bounding box of the selection intersects the bounding box of the table gadget.

void IliTableGadget::copyToClipboard ( const IliTableSelection & sel ) const

Copies the contents of one selection to the clipboard.

Parameters:

sel

The selection.

static IlvSymbol* IliTableGadget::DeleteRowSymbol ( ) [static]

Returns the name of the callback that will be called by the corresponding virtual member function.

Returns:: The callback name.

void IliTableGadget::disableImmediateRefresh ( IlBoolean disable )

Disables the immediate refreshes of the gadget.

This function is used to disable the immediate refreshes. The immedite refreshes are replaced by refreshes which are executed after the last call to the reDrawView function of the container.

Parameters:

disable If IlTrue the immediate refreshes are disabled.

void IliTableGadget::dontDeleteRow ( )

Cancels the row deletion.

Call this member function from the onPrepareDeleteRow virtual member function or from its corresponding callback to cancel the row deletion.

void IliTableGadget::dontValidateRow ( )

Cancels the row validation.

Called from one of the onValidateRow, onPrepareInsert, or onPrepareUpdate virtual member functions, or from one of their corresponding callbacks. Note that if the table gadget is bound to its data source, this member function has no application.

static IlvSymbol* IliTableGadget::DoubleClickSymbol ( ) [static]

Returns the name of the callback that will be called by the corresponding virtual member function.

Returns:: The callback name.

virtual void IliTableGadget::drawCell	(	IlvPort *	dst,
		IlInt	rowno,
		IlInt	colno,
		const char *	label,
		IlvAlignment	align,
		IlBoolean	selected,
		const IlvRect &	bbox,
		IlvPalette *	palette,
		const IlvRegion *	clip
	)			const `[virtual]`

Draws a cell.

Parameters:

	dst	The port.
	rowno	The row position.
	colno	The column position.
	label	The label.
	align	The alignment.
	selected	If `IlTrue`, it is selected.
	bbox	The bounding box.
	palette	The palette.
	clip	The region of clipping.

static IlvSymbol* IliTableGadget::DrawCellSymbol ( ) [static]

Returns the name of the callback that will be called by the corresponding virtual member function.

Returns:: The callback name.

virtual void IliTableGadget::drawCorner	(	IlvPort *	dst,
		IlBoolean	selected,
		const IlvRect &	bbox,
		const IlvRegion *	clip
	)			const `[virtual]`

Draws the upper left corner of the table gadget.

Parameters:

	dst	The port.
	selected	If `IlTrue`, it is selected.
	bbox	The bounding box.
	clip	The region of clipping.

virtual void IliTableGadget::drawHeader	(	IlvPort *	dst,
		IlInt	colno,
		const char *	label,
		IlBoolean	selected,
		const IlvRect &	bbox,
		const IlvRegion *	clip
	)			const `[virtual]`

Draws a header.

Parameters:

	dst	The port.
	colno	The column position.
	label	The label.
	selected	If `IlTrue`, it is selected.
	bbox	The bounding box.
	clip	The region of clipping.

virtual void IliTableGadget::drawHorzRule	(	IlvPort *	dst,
		IlvPos	x1,
		IlvPos	x2,
		IlvPos	y,
		IlInt	rowno,
		IlInt	colnoLeft,
		IlInt	colnoRight,
		IlvPalette *	palette,
		const IlvRegion *	clip
	)			const `[virtual]`

Draws a horizontal rule of the table gadget grid.

Draws a horizontal rule of the table gadget grid in the dst port.

Parameters:

	dst	The port.
	x1	The x start position.
	x2	The x last position.
	y	The y position.
	rowno	The row position.
	colnoLeft	The first column position.
	colnoRight	The last column position.
	palette	The palette.
	clip	The region of clipping.

Reimplemented in IliInspectorGadget.

virtual void IliTableGadget::drawMarker	(	IlvPort *	dst,
		IlInt	rowno,
		IlBoolean	selected,
		IlBoolean	current,
		const IlvRect &	bbox,
		const IlvRegion *	clip
	)			const `[virtual]`

Draws a marker.

Parameters:

	dst	The port.
	rowno	The row position.
	selected	If `IlTrue`, it is selected.
	current	If `IlTrue`, it is the marker of the current row.
	bbox	The bounding box.
	clip	The region of clipping.

Reimplemented in IliInspectorGadget.

virtual void IliTableGadget::drawVertRule	(	IlvPort *	dst,
		IlvPos	y1,
		IlvPos	y2,
		IlvPos	x,
		IlInt	colno,
		IlInt	rownoTop,
		IlInt	rownoBot,
		IlvPalette *	palette,
		const IlvRegion *	clip
	)			const `[virtual]`

Draws a vertical rule of the table gadget grid.

Parameters:

	dst	The port.
	y1	The y start position.
	y2	The y last position.
	x	The x position.
	colno	The column position.
	rownoTop	The first row position.
	rownoBot	The last row position.
	palette	The palette.
	clip	The region of clipping.

Reimplemented in IliInspectorGadget.

void IliTableGadget::enableKeyboardDeleteRow ( IlBoolean flag )

Enables/disables the user to delete the current row using the delete key.

Parameters:

flag If IlTrue, enables the user to delete the current row using the delete key. Otherwise, this feature is disabled.

void IliTableGadget::enableKeyboardRefresh ( IlBoolean flag )

Enables/disables the refresh key by the user.

Enables the user to call the IliTable::select member function, on the underlying table with the refresh key, if flag is IlTrue (by default the F9 function key, but see the SetRefreshShortCut member function description). Otherwise, this feature will be disabled.

void IliTableGadget::enableMultiSelection ( IlBoolean flag )

Enables/disables multi-selection mode.

Note that this mode only affects the behavior of the event-handler.

Parameters:

flag If IlTrue, enables multi-selection mode. Otherwise, multi-selection mode is disabled.

void IliTableGadget::enableRowSelect ( IlBoolean flag )

Enables/disables row selection mode.

Parameters:

flag If IlTrue, enables row select mode. Otherwise row select mode is disabled.

void IliTableGadget::enableSort ( IlBoolean flag )

Enables/disables the row sorting.

Parameters:

flag If IlTrue, enables the sort mode. Otherwise, the sort mode is disabled. Note that this mode only affects the behavior of the event-handler.

void IliTableGadget::enableToolTips ( IlBoolean flag )

Enables or disables the display of the tooltips.

Parameters:

flag

The tooltip show flag.

void IliTableGadget::ensureVisible ( IliTableSelection sel )

Scrolls the table gadget so that the selection becomes visible in the bounding box of the table gadget.

Parameters:

sel

The selection.

static IlvSymbol* IliTableGadget::EnterCellSymbol ( ) [static]

Returns the name of the callback that will be called by the corresponding virtual member function.

Returns:: The callback name.

static IlvSymbol* IliTableGadget::EnterInsertModeSymbol ( ) [static]

Returns the name of the callback that will be called by the corresponding virtual member function.

Returns:: The callback name.

static IlvSymbol* IliTableGadget::EnterRowSymbol ( ) [static]

Returns the name of the callback that will be called by the corresponding virtual member function.

Returns:: The callback name.

static IlvSymbol* IliTableGadget::EnterUpdateModeSymbol ( ) [static]

Returns the name of the callback that will be called by the corresponding virtual member function.

Returns:: The callback name.

virtual IlBoolean IliTableGadget::f_complete ( ) [virtual]

Updates the internal value of the field, according to its current external representation and its foreign table, provided completion is enabled for the field.

For more information on completion, see the f_iscompletionEnabled member function.

Returns:: IlTrue if successful.

Reimplemented from IliFieldItf.

virtual IlBoolean IliTableGadget::f_externalToInternal ( ) [virtual]

Updates the internal value of a field according to its current external representation.

Returns:: IlTrue if successful and IlFalse otherwise. Note that this may fail due to the fact that not all external representations can be converted to a value object. For example, this is especially true for text fields that are used to edit numeric or date values.

Reimplemented from IliFieldItf.

virtual IliTablePropertyManager* IliTableGadget::f_getEffectiveTablePropertyManager ( ) [virtual]

Returns the effective table property manager.

Returns:

The effective table property manager that is obtained as follows:

If the useTableProperties property is IlFalse or if the data source to which the field is connected has its useTableProperties property set to IlFalse, this member function returns NULL.
Otherwise, if the tablePropertyManagerName property is not empty, the table property manager with that name is returned.
Otherwise, if the data source to which the field is connected has a tablePropertyManagerName property that is not empty, the table property manager with that name is returned.
Otherwise, the table default property manager is returned.

Reimplemented from IliFieldItf.

virtual const IliTablePropertyManager* IliTableGadget::f_getEffectiveTablePropertyManager ( ) const [virtual]

Returns the effective table property manager.

Returns:

The effective table property manager that is obtained as follows:

If the useTableProperties property is IlFalse or if the data source to which the field is connected has its useTableProperties property set to IlFalse, this member function returns NULL.
Otherwise, if the tablePropertyManagerName property is not empty, the table property manager with that name is returned.
Otherwise, if the data source to which the field is connected has a tablePropertyManagerName property that is not empty, the table property manager with that name is returned.
Otherwise, the table default property manager is returned.

Reimplemented from IliFieldItf.

virtual const IliValue& IliTableGadget::f_getValue ( IlBoolean internal = IlFalse ) const [virtual]

Returns the value of the field.

Parameters:

internal If IlTrue, the returned value does not necessarily reflect the state of the field as the user sees it.

Returns:: The value.

Reimplemented from IliFieldItf.

virtual IlBoolean IliTableGadget::f_isAutoFitPullDown ( ) const [virtual]

Returns IlTrue if the width of the pull-down menu is automatically computed so that its contents fit.

Returns:

IlTrue if the width of the pull-down menu is automatically computed so that its contents fit. The value returned by this virtual member function is currently meaningful only when the field gadget is one of the following:

IliTableComboBox
IliTableGadget

For a table gadget, this property applies to all table combo boxes contained in the table gadget.

Reimplemented from IliFieldItf.

virtual IlBoolean IliTableGadget::f_isConsistent ( ) const [virtual]

Returns IlTrue if the internal value of the field corresponds to its current external representation.

A return value of IlFalse means that the external representation of the field has been edited by the end-user since the last time one of the member functions, f_setValue, f_externalToInternal, f_internalToExternal or f_complete was successfully called.

Returns:: IlTrue if the internal value of the field corresponds to its current external representation.

Reimplemented from IliFieldItf.

virtual IlBoolean IliTableGadget::f_isInputModified ( ) const [virtual]

Returns IlTrue if the external representation has been edited by the end-user.

Returns:: IlTrue if the external representation has been edited by the end-user since the last time one of the member functions, f_setValue, f_externalToInternal, f_internalToExternal, or f_complete was successfully called.

Reimplemented from IliFieldItf.

virtual IlBoolean IliTableGadget::f_isReadOnly ( ) const [virtual]

Returns IlTrue if the field is read-only.

Returns:: IlTrue if the field is read-only.

Reimplemented from IliFieldItf.

virtual void IliTableGadget::f_setAutoFitPullDown ( IlBoolean flag ) [virtual]

Enables/disables the automatic width computing of the pull-down menu.

Parameters:

flag If IlTrue, the width of the pull-down menu is automatically computed so that its contents fit. See the description of f_isAutoFitPullDown for more information on this property.

Reimplemented from IliFieldItf.

virtual void IliTableGadget::f_setInputModified ( IlBoolean flag ) [virtual]

Sets the input-modified attribute of the field.

This member function is presented here for completeness. However, it should be used with care since it may cause the field, and other related components, to be in error with regard to the current state of the field.

Parameters:

flag

The input-modified attribute.

Reimplemented from IliFieldItf.

virtual void IliTableGadget::f_setReadOnly ( IlBoolean flag ) [virtual]

Sets the read-only property for the field.

Parameters:

flag

The read-only flag.

Reimplemented from IliFieldItf.

virtual void IliTableGadget::f_setTablePropertyManagerName ( const char * name ) [virtual]

Sets the name of the table property manager to use.

Parameters:

name The table property manager. If name is NULL or an empty string, the default table property manager will be used.

Reimplemented from IliFieldItf.

virtual IlBoolean IliTableGadget::f_setValue	(	const IliValue &	val,
		IlBoolean	internal = `IlFalse`
	)			`[virtual]`

Sets the value of the field.

Parameters:

	val	The value.
	internal	If `IlFalse`, then the external representation and the display of the field are automatically updated.

Returns:: IlTrue if successful, and IlFalse otherwise.

Reimplemented from IliFieldItf.

virtual void IliTableGadget::f_useTableProperties ( IlBoolean flag ) [virtual]

Enables/Disables the use of the table properties.

Parameters:

flag If IlTrue, the field will use table properties.

Reimplemented from IliFieldItf.

static IlvSymbol* IliTableGadget::FetchRowSymbol ( ) [static]

Returns the name of the callback that will be called by the corresponding virtual member function.

Returns:: The callback name.

IliTableFittingMode IliTableGadget::getAutoFittingMode ( ) const

Returns the auto-fitting mode.

This mode determines how the table gadget recalculates its column widths when the table gadget itself is resized. The return value may be any of the following:

IliFitNone
IliFitProportional
IliFitLast

Initially, this property is set to IliFitNone.

Returns:: The auto-fitting mode.

IlInt IliTableGadget::getBatchCount ( ) const

Returns the current number of nested calls to startOfBatch.

Returns:: The call count.

IlvColor* IliTableGadget::getCellBackground ( ) const

Returns the background color used to draw cells.

Initially, this property is set to the background color of the table gadget palette.

Returns:: The color.

IlvFont* IliTableGadget::getCellFont ( ) const

Returns the font used to draw cells.

Initially, this property is set to the font of the table gadget palette.

Returns:: The font.

IlvColor* IliTableGadget::getCellForeground ( ) const

Returns the foreground color used to draw cells.

Initially, this property is set to the foreground color of the table gadget palette.

Returns:: The color.

IliCellPaletteStruct* IliTableGadget::getCellPaletteStruct ( ) const

Returns the description of the cell for which text and fill palettes are currently required, as well as the default values for these palettes.

This member function may be called from the onGetCellPalette virtual member function, or from the corresponding callback.

Returns:: The cell palette description.

static IlvSymbol* IliTableGadget::GetCellPaletteSymbol ( ) [static]

Returns the name of the callback that will be called by the corresponding virtual member function.

Returns:: The callback name.

IlInt IliTableGadget::getColumnDisplayWidth ( IlInt colno ) const

Returns the column width, in pixels.

Parameters:

colno

The column position.

Returns:: The width.

IliFieldItf* IliTableGadget::getColumnEditor ( IlInt colno ) const

Returns the field that is used as an editor for a column.

Parameters:

colno

The column position.

Returns:: The field or NULL if the column does not have an editor.

IlInt IliTableGadget::getColumnsCount ( ) const

Returns the number of columns in the underlying table.

Returns:: The column count.

IlAny IliTableGadget::getCompareData ( ) const

Returns the user data that can be used to compare two rows.

Returns:: The user data.

IliCompareFunction IliTableGadget::getCompareFunction ( ) const

Returns the function that is used to compare two rows.

Returns:: The function.

IlInt IliTableGadget::getCurrentColumn ( ) const

Returns current column.

Returns:: The current column or -1 if there is no current column.

IlInt IliTableGadget::getCurrentRow ( ) const

Returns current row.

Returns:: The current row or -1 if there is no current row.

virtual IliFieldItf* IliTableGadget::getCustomEditor	(	IlInt	rowno,
		IlInt	colno,
		IliFieldItf *	fld
	)			const `[virtual]`

Returns the field to use as an editor for a cell.

This virtual member function is called, with the fld parameter set to the column editor, each time a new cell is entered. The default implementation returns the fld parameter. However, it is possible to return any other editor in a subclass of IliTableGadget.

Parameters:

	rowno	The row position.
	colno	The column position.
	fld	The default editor.

Returns:: The field.

Reimplemented in IliInspectorGadget.

IlInt IliTableGadget::getDeletedRow ( ) const

Returns the deleted row position.

Returns:: The position of the row that is currently being deleted if called from the onDeleteRow member function, or returns the position of the row that is to be deleted if called from the onPrepareDeleteRow member function (or from the corresponding callback).

IliDrawCellStruct* IliTableGadget::getDrawCellStruct ( ) const

Returns the description of the cell that is currently being drawn.

This member function may be called from the onDrawCell virtual member function or from the corresponding callback.

Returns:: The draw cell description.

IliErrorReporter* IliTableGadget::getErrorReporter ( ) const

Returns the error reporter that is used by the reportErrors member functions.

When this property is null a default error reporter is used. Initially this property is null.

Returns:: The error reporter.

IlInt IliTableGadget::getExtendedRowsCount ( ) const

Returns the number of rows in the underlying table (plus one if the insert row is currently shown).

Returns:: The row count.

IlInt IliTableGadget::getFetchedRow ( ) const

Returns the fetched row position.

Returns:: The position of the row that is currently being fetched. This member function may be called from the onFetchRow member function or from the corresponding callback.

IlInt IliTableGadget::getFirstColumn ( ) const

Returns the position of the first column shown (from left to right).

Returns:: The column position.

IlInt IliTableGadget::getFirstRow ( ) const

Returns the position in the underlying table of the first row shown (from top to bottom).

Returns:: The row position.

IlInt IliTableGadget::getFixedColumnsCount ( ) const

Returns the number of columns that do not scroll. These are the left-most columns.

Initially, this property is set to 0.

Returns:: The fixed column count.

IlvDim IliTableGadget::getHeaderHeight ( ) const

Returns header height, in pixels, of the column headers.

Initially, the header height is set according to the font height used to draw them.

Returns:: The height.

virtual IlvPalette* IliTableGadget::getHeaderTextPalette ( IlInt colno ) const [virtual]

Returns the header text palette.

Parameters:

colno

The column position.

Returns:: The header text palette for a column. If the column position is invalid, this function returns null.

IlvDim IliTableGadget::getMarkerWidth ( ) const

Returns the marker width, in pixels, of the row markers.

Returns:: The width.

IlInt IliTableGadget::getRealIndex ( IlInt colno ) const

Returns the position, in the underlying table, of the column in the table gadget.

Parameters:

colno

The column position.

Returns:: The real position. If the column geometry is not local, the return value equals colno.

static void IliTableGadget::GetRefreshShortCut	(	IlUShort &	modifiers,
		IlUShort &	key
	)			`[static]`

Returns the definition of the shortcut key that refreshes all.

The definition of the shortcut key that will trigger a call to the IliTable::select member function for all table gadgets. The default for this property is the unmodified F9 key.

Parameters:

	modifiers	The modifiers.
	key	The key.

Returns:: The refresh key.

virtual IlvPalette* IliTableGadget::getReliefPalette ( ) const [virtual]

Returns the relief palette.

The relief palette is used to draw the relief border, the markers and the headers.

Returns:: The relief palette.

IlvDim IliTableGadget::getRowHeight ( ) const

Returns the height, in pixels, of the rows in the table gadget.

Note that all rows have the same height. Initially the row height is set according to the font height used to draw cells.

Returns:: The row height.

IlInt IliTableGadget::getRowsCount ( ) const

Returns the number of rows in the underlying table.

Returns:: The row count.

IlvScrollBar* IliTableGadget::getScrollBar ( IlvPosition which ) const

Returns a scroll bar.

Parameters:

which

The scroll bar position.

Returns:: The horizontal scroll bar, if which is set to IlvHorizontal and the vertical scroll bar if which is set to IlvVertical. This member function returns NULL if the designated scroll bar is not shown.

IliShowMode IliTableGadget::getScrollBarShowMode ( IlvPosition which ) const

Returns the show mode for a scroll bar.

Parameters:

which

The scroll bar position.

Returns:: The show mode.

void IliTableGadget::getSelection ( IliTableSelection & sel ) const

Returns the current selection in the table gadget.

Parameters:

sel

The current selection.

Returns:: The current selection.

IliTable* IliTableGadget::getTable ( )

Returns the underlying table of the table gadget.

If the table gadget is connected to a data source, the underlying table can also be obtained by calling:

 IliFieldItf::f_getDataSource()->getTable();

Returns:: The table.

const IliTable* IliTableGadget::getTable ( ) const

Returns the underlying table of the table gadget.

If the table gadget is connected to a data source, the underlying table can also be obtained by calling:

 IliFieldItf::f_getDataSource()->getTable();

Returns:: The table.

IliTablePropertyManager* IliTableGadget::getTablePropertyManager ( )

Returns the table property manager used.

Returns:: The table property manager.

const IliTablePropertyManager* IliTableGadget::getTablePropertyManager ( ) const

Returns the table property manager used.

Returns:: The table property manager.

const char* IliTableGadget::getTablePropertyManagerName ( ) const

Returns the table property manager name.

Note, the name of the default property manager is NULL.

Returns:: The name of the table property manager.

virtual void IliTableGadget::getToolTipsText	(	const IlvPoint &	pt,
		IliString &	s
	)			`[virtual]`

Returns the tooltip text that must be displayed.

By default, this function returns the title of the column header when the mouse is positioned over a header. Otherwise, this function returns an empty string of characters, which means "no display".

Parameters:

	pt	The mouse position.
	s	The tooltip text.

Returns:: The tooltip text.

const IliValue& IliTableGadget::getValue ( IliName colname ) const

Returns the value at the column named colname in the row buffer of the table gadget.

Parameters:

colname

The column name.

Returns:: The value.

const IliValue& IliTableGadget::getValue ( IlInt colno ) const

Returns the value at column colno in the row buffer of the table gadget.

Parameters:

colno

The column position.

Returns:: The value.

IlInt IliTableGadget::getVisibleRowsCount ( IlBoolean & lastRowClipped ) const

Returns the maximum row count that are shown in the table gadget.

Parameters:

lastRowClipped If IlTrue, the last of these rows cannot be shown in its entirety. The actual number of rows in the underlying table is not taken into account.

Returns:: The maximum number of rows.

IlInt IliTableGadget::getVisualIndex ( IlInt colno ) const

Returns the position, in the table gadget, of the column in the underlying table.

Parameters:

colno

The column position.

Returns:: The position. If the column geometry is not local, the return value equals colno.

IlBoolean IliTableGadget::gotoInsertRow ( )

Attempts to move the current row to the insert row.

Returns:: IlTrue if successful.

virtual IlBoolean IliTableGadget::gotoNextColumn ( ) [virtual]

Attempts to move the current column to the next shown column.

Returns:: IlTrue if successful.

virtual IlBoolean IliTableGadget::gotoNextRow ( ) [virtual]

Attempts to move the current row to the next row.

Returns:: IlTrue if successful.

virtual IlBoolean IliTableGadget::gotoPreviousColumn ( ) [virtual]

Attempts to move the current column to the previous shown column.

Returns:: IlTrue if successful.

virtual IlBoolean IliTableGadget::gotoPreviousRow ( ) [virtual]

Attempts to move the current row to the previous row.

Returns:: IlTrue if successful.

IlBoolean IliTableGadget::hasCustomCellPalettes ( ) const

Returns IlTrue if the table gadget calls the onGetCellPalette virtual member function for each cell being drawn.

Initially this property is set to IlFalse.

Returns:: The custom cell palette using flag.

IlBoolean IliTableGadget::isBoundToDataSource ( ) const

Returns IlTrue if the table gadget is bound to its data source.

When the table gadget is bound to its data source, the current row of the table gadget is synchronized with the current row of the data source.

Returns:: The bound data source flag.

IlBoolean IliTableGadget::isCellEditorShown ( ) const

Returns IlTrue if the cell editor is shown in the selected cell when the cell is read-only.

The default for this property is IlTrue.

Returns:: IlTrue if the cell editor is shown in the selected cell when the cell is read-only. This member function returns IlFalse if the cell editor is only shown when the selected cell is read-write.

IlBoolean IliTableGadget::isColumnGeometryLocal ( ) const

Returns IlTrue if the end-user is able to change the order of the columns.

Note that this member function does consider whether the underlying table has this capability. Initially, this property is set IlTrue.

Returns:: The column geometry local flag.

IlBoolean IliTableGadget::isColumnMoveAllowed ( ) const

Returns IlTrue if the end-user is able to change the order of the columns.

Note that this member function does consider whether the underlying table has this capability. Initially, this property is set IlTrue.

Returns:: The column moving permission.

IlBoolean IliTableGadget::isColumnResizeAllowed ( ) const

Returns IlTrue if the end-user is able to resize columns.

Initially, this property is set IlTrue.

Returns:: The column resizing permission.

IlBoolean IliTableGadget::isColumnVisible ( IlInt colno ) const

Returns the column visibility.

Note that for the end-user to see the column it must be shown, its size must be greater than zero, and it must lie within the bounds of the table gadget.

Parameters:

colno

The column position.

Returns:: The column visibility.

IlBoolean IliTableGadget::isConfirmOnDeleteRequired ( ) const

Returns IlTrue if the user is prompted for a confirmation before row deletion.

Initially, this property is set to IlTrue.

Returns:: The confirmation required flag.

IlBoolean IliTableGadget::isImmediateRefreshDisabled ( ) const

Returns IlTrue if the immediate refreshes are disabled.

Returns:: IlTrue if the immediate refreshes are disabled, the default value is IlFalse.

IlBoolean IliTableGadget::isInInsertMode ( ) const

Returns IlTrue if the current row is the insert row and if the current row buffer is modified.

Returns:: The insert mode flag.

IlBoolean IliTableGadget::isInsertRow ( IlInt rowno ) const

Returns IlTrue if a row designates the insert row.

Parameters:

rowno

The row position.

Returns:: The insert row flag.

IlBoolean IliTableGadget::isInUpdateMode ( ) const

Returns IlTrue if the current row corresponds to an existing table row (that is, it is not the insert row), and if the current row buffer is modified.

Returns:: The update mode flag.

IlBoolean IliTableGadget::isKeyboardDeleteRowEnabled ( ) const

Returns IlTrue if the user can use the delete key to delete the current row.

Initially, this property is set to IlTrue.

Returns:: The delete key using flag.

IlBoolean IliTableGadget::isKeyboardRefreshEnabled ( ) const

Returns IlTrue if the user can use the refresh key.

When the user uses the refresh key, the IliTable::select member function on the underlying table is called. By default the refresh key is the F9 function key. The refresh key can be changed with the SetRefreshShortCut member function. Initially, this property is set to IlTrue.

Returns:: The refresh key status.

IlBoolean IliTableGadget::isMultiSelectionEnabled ( ) const

Returns IlTrue if the table gadget event handler allows the end-user to select more than one row or column.

Initially, this property is set to IlTrue.

Returns:: The multi-selection permission.

IlBoolean IliTableGadget::isOnInsertRow ( ) const

Returns IlTrue if the current row is the insert row.

Returns:: The insert row flag.

IlBoolean IliTableGadget::isReadOnly ( ) const

Returns IlTrue if the table gadget is read-only.

Initially, this property is set to IlFalse.

Returns:: The read-only flag.

IlBoolean IliTableGadget::isRowMoveAllowed ( ) const

Returns IlTrue if the end-user is able to change the order of the rows.

Note that this member function does not consider whether the underlying table has this capability or not. Initially, this property is set IlTrue.

Returns:: The row moving permission.

IlBoolean IliTableGadget::isRowResizeAllowed ( ) const

Returns IlTrue if the end-user is able to resize rows.

Initially, this property is set to IlTrue.

Returns:: The row resizing permission.

IlBoolean IliTableGadget::isRowSelectEnabled ( ) const

Returns IlTrue if the row select mode is enabled.

When the row select mode is enabled, whenever the user attempts to select a cell, the row containing this cell is selected instead. The default for this property is IlFalse.

Returns:: The row select mode status.

IlBoolean IliTableGadget::isSelectionAlwaysShown ( ) const

Returns IlTrue if the selection of the table gadget is always highlighted.

Returns:: The selection show status.

IlBoolean IliTableGadget::isShowingGrid ( ) const

Returns IlTrue if the table gadget is drawn with a grid.

Initially, this property is set to IlTrue.

Returns:: The grid flag.

IlBoolean IliTableGadget::isShowingHeaders ( ) const

Returns IlTrue if the column headers are shown.

Initially, headers are shown.

Returns:: The show flag.

IlBoolean IliTableGadget::isShowingInsertRow ( ) const

Returns IlTrue if the insert row is shown.

Returns:: The show flag.

IlBoolean IliTableGadget::isShowingMarkers ( ) const

Returns IlTrue if the row markers are shown.

Returns:: The show flag.

IlBoolean IliTableGadget::isSortEnabled ( ) const

Returns IlTrue if the table gadget event handler will sort the rows according to the column header on which the user clicks.

Initially, this property is set to IlFalse.

Returns:: The sort flag.

IlBoolean IliTableGadget::isTableOwner ( ) const

Returns IlTrue if the table gadget owns its table.

Returns:: The owner flag.

IlBoolean IliTableGadget::isUsingRelief ( ) const

Returns IlTrue if the table gadget is drawn with a relief border.

Initially, this property is set to IlTrue.

Returns:: The relief flag.

IlBoolean IliTableGadget::isUsingTableProperties ( ) const

Returns IlTrue if the table gadget is sensitive to table properties.

Note that contrary to other subclasses of IliFieldItf, the table gadget is not sensitive to the useTableProperties and tablePropertyManagerName properties of its data source.

Returns:: The sensitivity about the table properties.

IlBoolean IliTableGadget::moveColumn	(	IlInt	from,
		IlInt	to
	)

Attempts to move the column from a position to another position.

Parameters:

	from	The origin position.
	to	The destination position.

Returns:: IlTrue if successful.

virtual void IliTableGadget::onCancelEdits ( ) [virtual]

Called just after the edits in the current row have been canceled.

The default implementation of this virtual member function calls the CancelEdits callback. Note that if the table gadget is bound to its data source, this virtual member function is not called.

virtual void IliTableGadget::onDeleteRow ( ) [virtual]

Called just before a row in the underlying table is deleted.

The index of the deleted row can be retrieved with the getDeletedRow member function. The default implementation of this virtual member function calls the DeleteRow callback.

virtual void IliTableGadget::onDoubleClick ( ) [virtual]

Called just after a double-click on the table gadget.

The default implementation of this virtual member function calls the DoubleClick callback.

virtual void IliTableGadget::onDrawCell ( ) [virtual]

Called to draw a cell in the table gadget.

The cell to be drawn is described, along with other useful information, in the object returned by the getDrawCellStruct member function. The default implementation is as follows: a DrawCell callback is called, if it has been defined, otherwise the defaultDrawCell member function is called. Do not override this virtual member function in subclasses of IliTableGadget. If necessary, the drawCell virtual member function can be redefined in subclasses.

virtual void IliTableGadget::onEnterCell ( ) [virtual]

Called just after a new cell is entered.

The default implementation of this virtual member function calls the EnterCell callback.

virtual void IliTableGadget::onEnterInsertMode ( ) [virtual]

Called just after the current row buffer becomes modified, when the current row is the insert row.

The default implementation of this virtual member function calls the EnterInsertMode callback. Note that if the table gadget is bound to its data source, this virtual member function is not called.

virtual void IliTableGadget::onEnterRow ( ) [virtual]

Called just after a new row is entered.

The default implementation of this virtual member function calls the EnterCell callback.

virtual void IliTableGadget::onEnterUpdateMode ( ) [virtual]

Called just after the current row buffer becomes modified (when the current row is not the insert row).

The default implementation of this virtual member function calls the EnterUpdateMode callback. Note that if the table gadget is bound to its data source, this virtual member function is not called.

virtual void IliTableGadget::onFetchRow ( ) [virtual]

Called just after a new row has been retrieved from a remote database and cached in the underlying table.

The index of the fetched row can be retrieved with the getFetchedRow member function. The default implementation of this virtual member function calls the FetchRow callback.

virtual void IliTableGadget::onGetCellPalette ( ) [virtual]

Called when the text and fill palettes of a cell are required (either to draw the cell or to configure the cell editor).

The cell for which the palettes are required is described in the object returned by the getCellPaletteStruct member function. This object also contains the default text and fill palettes. If the application requires the use of palettes other than the default, for a given cell, it must change the value for these palettes in the object returned by getCellPaletteStruct. The default implementation calls the GetCellPalette callback. Note that this virtual member function will not be called by the table gadget unless a GetCellPalette callback has been set or the setCustomCellPalettes member function has been called with an IlTrue argument.

virtual void IliTableGadget::onPrepareDeleteRow ( ) [virtual]

Called when the user attempts to delete a row through this table gadget.

The index of the row to be deleted can be obtained by calling the getDeletedRow member function. This virtual member function can be overridden to do the following:

Check any application-defined constraints. If the constraints are not satisfied, the dontDeleteRow should be called. In this case, the row will not be deleted.
In addition, the addErrorMessage member function can be called to describe the reason for the failure.

The default implementation of this virtual member function calls the PrepareDeleteRow callback. Note that if the table gadget is bound to a data-source, this virtual member function is not called.

virtual void IliTableGadget::onPrepareInsert ( ) [virtual]

Called when an attempt is made to validate the current row, when the current row is the insert row.

The default implementation of this virtual member function calls the PrepareInsert callback. When you override this virtual member function or if you define a PrepareInsert callback, you can call the dontValidateRow member function to cancel the validation. In this case, you can also call the addErrorMessage member function to provide the user with an error message. Alternatively, you can change some of the values in the current row before it is inserted into the underlying table. Note that if the table gadget is bound to its data source, this virtual member function is not called.

virtual void IliTableGadget::onPrepareUpdate ( ) [virtual]

Called when an attempt is made to validate the current row (when the current row is not the insert row).

The default implementation of this virtual member function calls the PrepareUpdate callback. When you override this virtual member function or if you define a PrepareUpdate callback, you can call the dontValidateRow member function to cancel the validation. In this case, you can also call the addErrorMessage member function to provide the user with an error message. Alternatively, you can change some of the values in the current row before the underlying table is updated. Note that if the table gadget is bound to its data source, this virtual member function is not called.

virtual void IliTableGadget::onQuitCell ( ) [virtual]

Called just before the selection moves out of a cell.

The default implementation of this virtual member function calls the QuitCell callback.

virtual void IliTableGadget::onQuitInsertMode ( ) [virtual]

Called just after the current row has been successfully validated, when the current row is the insert row.

The default implementation of this virtual member function calls the QuitInsertMode callback. Note that if the table gadget is bound to its data source, this virtual member function is not called.

virtual void IliTableGadget::onQuitRow ( ) [virtual]

Called just before the selection moves out of a row.

The default implementation of this virtual member function calls the QuitRow callback.

virtual void IliTableGadget::onQuitUpdateMode ( ) [virtual]

Called just after the current (non insert) row has been successfully validated.

The default implementation of this virtual member function calls the QuitUpdateMode callback. Note that if the table gadget is bound to its data source, this virtual member function is not called.

virtual void IliTableGadget::onSelectionChange ( ) [virtual]

Called just after the selection has changed (whatever the change).

The default implementation of this virtual member function calls the SelectionChange callback.

virtual void IliTableGadget::onValidateCell ( ) [virtual]

Called when an attempt is made to move the selection out of a cell.

The default implementation of this virtual member function calls the ValidateCell callback. When you override this virtual member function, or if you define a ValidateCell callback, you can call the dontValidateCell member function to inhibit the selection change. In this case, you can also call the addErrorMessage member function to generate an error message for the user.

virtual void IliTableGadget::onValidateRow ( ) [virtual]

Called when an attempt is made to validate the current row.

The default implementation of this virtual member function calls the ValidateRow callback. When you override this virtual member function, or if you define a ValidateRow callback, you can call the dontValidateRow member function to cancel the validation. In this case, you can also call the addErrorMessage member function to generate an error message for the user. Alternatively, you can change some of the values in the current row before the underlying table is updated. Note that if the table gadget is bound to its data source, this virtual member function is not called.

void IliTableGadget::pasteFromClipboard ( const IliTableSelection & sel )

Pastes the contents of the clipboard into the selection.

Parameters:

sel

The selection.

IlBoolean IliTableGadget::pointToSelection	(	const IlvPoint &	pt,
		IliTableSelection &	sel,
		const IlvTransformer *	t = `0`
	)			const

Returns the selection pointed by a point.

Parameters:

	pt	The point.
	sel	The computed selection.
	t	The transformer.

Returns:: IlTrue if this selection is not empty.

static IlvSymbol* IliTableGadget::PrepareDeleteRowSymbol ( ) [static]

Returns the name of the callback that will be called by the corresponding virtual member function.

Returns:: The callback name.

static IlvSymbol* IliTableGadget::PrepareInsertSymbol ( ) [static]

Returns the name of the callback that will be called by the corresponding virtual member function.

Returns:: The callback name.

static IlvSymbol* IliTableGadget::PrepareUpdateSymbol ( ) [static]

Returns the name of the callback that will be called by the corresponding virtual member function.

Returns:: The callback name.

static IlvSymbol* IliTableGadget::QuitCellSymbol ( ) [static]

Returns the name of the callback that will be called by the corresponding virtual member function.

Returns:: The callback name.

static IlvSymbol* IliTableGadget::QuitInsertModeSymbol ( ) [static]

Returns the name of the callback that will be called by the corresponding virtual member function.

Returns:: The callback name.

static IlvSymbol* IliTableGadget::QuitRowSymbol ( ) [static]

Returns the name of the callback that will be called by the corresponding virtual member function.

Returns:: The callback name.

static IlvSymbol* IliTableGadget::QuitUpdateModeSymbol ( ) [static]

Returns the name of the callback that will be called by the corresponding virtual member function.

Returns:: The callback name.

void IliTableGadget::refreshCell	(	IlInt	rowno,
		IlInt	colno
	)

Redraws a cell.

Parameters:

	rowno	The row position.
	colno	The column position as it appears in the underlying table (see the `getRealColno` member function).

void IliTableGadget::refreshColumn ( IlInt colno )

Redraws a column.

Parameters:

colno The column position as it appears in the underlying table (see the getRealColno member function).

void IliTableGadget::refreshRow ( IlInt rowno )

Redraws a row.

Redraws the row at position rowno.

Parameters:

rowno

The row position.

void IliTableGadget::removeErrorSink ( IliErrorSink * sink )

Removes an error sink from this table gadget.

Parameters:

sink

The error sink.

void IliTableGadget::reportErrors ( const IliErrorList & errorList ) const

Reports the errors that are contained in a error list.

This member function makes use of the error reporter returned by getErrorReporter if any. Otherwise it uses a default error reporter.

Parameters:

errorlist

The error list.

void IliTableGadget::requireConfirmOnDelete ( IlBoolean flag )

Enables/disables confirmation before row deletion.

Parameters:

flag If IlTrue, the user is prompted for confirmation before deleting a row. Otherwise, any row deletion requests will proceed without confirmation.

virtual void IliTableGadget::scrollTo	(	IlInt	rowno,
		IlInt	colno
	)			`[virtual]`

Scrolls to a cell.

Parameters:

	rowno	The row position.
	colno	The column position.

void IliTableGadget::scrollToColumn ( IlInt colno )

Scrolls to a column.

Parameters:

colno

The column position.

void IliTableGadget::scrollToRow ( IlInt rowno )

Scrolls to a row.

Parameters:

rowno

The row position.

IlBoolean IliTableGadget::selectAll ( )

Attempts to select all rows and columns.

Returns:: IlTrue if successful.

IlBoolean IliTableGadget::selectCell	(	IlInt	rowno,
		IlInt	colno
	)

Attempts to select the cell at a row and a column.

Parameters:

	rowno	The cell row.
	colno	The cell column.

Returns:: IlTrue if successful.

IlBoolean IliTableGadget::selectColumn ( IlInt colno )

Attempts to select a column.

Parameters:

colno

The column position.

Returns:: IlTrue if successful.

static IlvSymbol* IliTableGadget::SelectionChangeSymbol ( ) [static]

Returns the name of the callback that will be called by the corresponding virtual member function.

Returns:: The callback name.

IlBoolean IliTableGadget::selectNone ( )

Attempts to deselect the current selection.

Returns:: IlTrue if successful.

IlBoolean IliTableGadget::selectRow ( IlInt rowno )

Attempts to select a row.

Parameters:

rowno

The row position.

Returns:: -1 if successful.

void IliTableGadget::setAutoFittingMode ( IliTableFittingMode mode )

Sets the auto-fitting mode.

Parameters:

mode

The auto-fitting mode.

virtual void IliTableGadget::setCellBackground ( IlvColor * color ) [virtual]

Sets the background color used to draw cells.

Parameters:

color

The new color.

virtual void IliTableGadget::setCellFont ( IlvFont * font ) [virtual]

Sets the font used to draw cells.

Parameters:

font

The new font.

virtual void IliTableGadget::setCellForeground ( IlvColor * color ) [virtual]

Sets the foreground color used to draw cells.

Parameters:

color

The new color.

void IliTableGadget::setColumnDisplayWidth	(	IlInt	colno,
		IlInt	width
	)

Sets column width, in pixels.

Parameters:

	colno	The column position.
	width	The column width.

IlBoolean IliTableGadget::setColumnEditor	(	IlInt	colno,
		IliFieldItf *	fld,
		IlBoolean	owner = `IlTrue`
	)

Sets the field that is used as an editor for column.

Parameters:

	colno	The column position.
	fld	The editor.
	owner	If `IlTrue`, the table gadget becomes the owner of the field.

void IliTableGadget::setColumnGeometryLocal ( IlBoolean flag )

Enables/disables the column moving.

Parameters:

flag If IlTrue, enables the column moving.

void IliTableGadget::setColumnVisible	(	IlInt	colno,
		IlBoolean	flag
	)

Sets column visibility.

Parameters:

	colno	The column position.
	flag	If `IlTrue`, shows the column and hides it otherwise.

void IliTableGadget::setCompareFunction	(	IliCompareFunction	fct,
		IlAny	arg = `0`
	)

Defines the function fct and user data that must be used to compare two rows.

Parameters:

	fct	The function to compare.
	arg	The user data.

void IliTableGadget::setCustomCellPalettes ( IlBoolean flag )

Enables/disables the use of specific palettes for a cell.

This member function must be called with a value of IlTrue for the flag parameter by any subclass of the table gadget that overrides the onGetCellPalette virtual member function.

Parameters:

flag

The use of specific palette flag

void IliTableGadget::setErrorReporter ( IliErrorReporter * reporter )

Sets the error reporter.

Note that the table gadget will not delete the error reporter at destruction time, so the same error reporter may be safely shared by many table gadgets.

Parameters:

reporter

The new error reporter.

IlBoolean IliTableGadget::setFixedColumnsCount ( IlInt count )

Sets the number of columns that do not scroll.

Parameters:

count

The column count.

Returns:: IlTrue if successful, and IlFalse if count is greater that the current number of columns.

void IliTableGadget::setHeaderHeight ( IlvDim h )

Sets header height.

Parameters:

h

The header height.

void IliTableGadget::setMarkerWidth ( IlvDim w )

Sets the marker width.

Parameters:

w

The marker width.

IlBoolean IliTableGadget::setReadOnly ( IlBoolean flag )

Sets the table gadget as read-only or not.

Parameters:

flag If IlTrue, sets the table gadget as read-only. The table gadget is set to read-write otherwise.

static void IliTableGadget::SetRefreshShortCut	(	IlUShort	modifiers,
		IlUShort	key
	)			`[static]`

Sets the definition of the shortcut key that refreshes all.

Parameters:

	modifiers	The modifiers.
	key	The key, if `key` has a value `0` then no shortcut key is defined.

void IliTableGadget::setReliefPalette ( IlvPalette * pal )

Sets the relief palette.

The relief palette is used to draw the relief border, the markers and the headers.

Parameters:

pal

The relief palette.

void IliTableGadget::setRowHeight ( IlvDim h )

Sets the height of the rows in a table gadget.

Parameters:

h

The row height.

virtual IlBoolean IliTableGadget::setSelection ( const IliTableSelection & sel ) [virtual]

Attempts to set the table gadget selection.

Parameters:

sel

The new selection.

Returns:: IlTrue if successful.

Reimplemented in IliInspectorGadget.

virtual void IliTableGadget::setTable	(	IliTable *	table,
		IlBoolean	owner = `IlTrue`
	)			`[virtual]`

Connects the table gadget to a table.

You do not need to use this method if you connect the table gadget to a data source using the IliFieldItf::f_setDataSource or IliFieldItf::f_setDataSourceName member functions.

Parameters:

	table	The table.
	owner	The table owner, if `IlTrue`, the table gadget becomes the owner.

void IliTableGadget::setTablePropertyManager ( IliTablePropertyManager * propMgr )

Sets the table property manager.

Parameters:

propMgr

The table property manager.

void IliTableGadget::setTablePropertyManagerName ( const char * name )

Sets the table property manager name.

Parameters:

name The table property manager name. If the name is NULL or an empty string, the default table property manager is used.

IlBoolean IliTableGadget::setValue	(	IliName	colname,
		const IliValue &	value
	)

Sets the value at the column named colname, in the row buffer of the table gadget, to value.

Parameters:

	colname	The column name.
	value	The value.

IlBoolean IliTableGadget::setValue	(	IlInt	colno,
		const IliValue &	value
	)

Sets the value at column colno, in the row buffer of the table gadget, to value.

Parameters:

	colno	The column position.
	value	The value.

void IliTableGadget::setVisibleRowsCount ( IlInt count )

Changes the height of the table gadget so that the maximum number of rows can be shown.

Parameters:

count

The maximum number of rows that can be shown.

void IliTableGadget::showCellEditor ( IlBoolean flag )

Specifies that the cell editor is shown in read-only cells.

Parameters:

flag If IlTrue, specifies that the cell editor is shown in read-only cells. Otherwise, the cell editor is only shown in read-write cells.

void IliTableGadget::showGrid ( IlBoolean flag )

Shows/Hides grid.

Parameters:

flag If IlTrue, draws the table gadget with a grid. Otherwise, a grid is not drawn.

void IliTableGadget::showHeaders ( IlBoolean flag )

Shows/Hides the column headers.

Parameters:

flag If IlTrue, shows the column headers. Otherwise hides the column headers.

IlBoolean IliTableGadget::showInsertRow ( IlBoolean flag )

Shows/Hides insert row.

Parameters:

flag If IlTrue, shows the insert row. Otherwise hides the insert row.

void IliTableGadget::showMarkers ( IlBoolean flag )

Shows/Hides row markers.

Parameters:

flag If IlTrue, shows the row markers. Otherwise hides the row markers.

void IliTableGadget::showScrollBar	(	IlvPosition	which,
		IliShowMode	mode
	)

Sets the show mode for a scroll bar.

Changes the show mode of the scroll bar, designated by the which parameter, to mode. The parameter mode may take any of the following values:

IliShowNever
IliShowAsNeeded
IliShowAlways

Parameters:

	which	The scroll bar position.
	mode	The show mode.

void IliTableGadget::showSelectionAlways ( IlBoolean flag )

Shows/hides the selection.

Parameters:

flag If IlTrue, the selection of the table gadget will always be highlighted. Otherwise, it will be only be highlighted when the table gadget has the focus.

void IliTableGadget::sortColumn ( IlInt colno )

Sorts the rows according to ascending or descending order of column.

The global functions IliAscOrder and IliDescOrder are used to indicate the type of sort. Example:

 //Sorts column 2 in ascending order
 tg->sortColumn(IliAscOrder(2));
 //Sorts column 3 in descending order
 tg->sortColumn(IliDescOrder(3));

Parameters:

colno

The column position.

void IliTableGadget::useRelief ( IlBoolean flag )

Shows/Hides relief border.

Parameters:

flag If IlTrue, draws the table gadget with a relief border. Otherwise, it will be drawn without a relief border.

void IliTableGadget::useTableProperties ( IlBoolean flag )

Sets the table gadget sensitivity about table properties.

Parameters:

flag If IlTrue, the table gadget becomes sensitive to table properties. It becomes insensitive if flag is IlFalse .

virtual IlBoolean IliTableGadget::validate ( IlBoolean interactive = IlFalse ) [virtual]

Validates the current row.

Validation proceeds in the following manner:

If the row buffer of the table gadget is unmodified, validation succeeds immediately.
Otherwise, some system defined constraints are checked on the current row buffer. If these constraints are not satisfied, validation fails.
The onValidateRow virtual method is then called, which checks any application defined constraints. If these are not satisfied, it calls the dontValidateRow member function, and validation fails.
One of the onPrepareInsert or onPrepareUpdate virtual member functions is then called (depending on whether the current row is an inserted row).
A new row is then inserted into the underlying table, or an existing row is updated in the underlying table (depending on whether the current row is an inserted row). If successful, one of the onQuitInsertMode or onQuitUpdateMode is called and IlTrue is returned.

If successful, the row buffer of the table gadget becomes unmodified.

If the interactive parameter is IlTrue, any errors that may occur are automatically reported to the user by calling the reportErrors member function. If the interactive parameter is IlFalse, errors are not reported.

Note that if the table gadget is bound to a data source, the onValidateRow, onPrepareInsert, onPrepareUpdate, onQuitInsertMode, and onQuitUpdateMode virtual member functions are called on the data source, instead of on the table gadget.

Parameters:

interactive

The interactive flag.

Returns:: IlTrue if successful.

static IlvSymbol* IliTableGadget::ValidateCellSymbol ( ) [static]

Returns the name of the callback that will be called by the corresponding virtual member function.

Returns:: The callback name.

static IlvSymbol* IliTableGadget::ValidateRowSymbol ( ) [static]

Returns the name of the callback that will be called by the corresponding virtual member function.

Returns:: The callback name.

Rogue Wave ViewsData Access Package API Reference Guide

IliTableGadget Class Reference

Public Member Functions

Static Public Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Rogue Wave Views
Data Access Package API Reference Guide