QicsTable: QicsRow Class Reference

QicsRow is the programmer's access point for all attributes of individual rows. All attributes of individual rows can be set using this class. When an attribute of a row is set, the new value overrides any previous row setting as well as any setting for individual cells in the row. When retrieving attributes of a row, remember that the value you are retrieving is the common setting for the entire row. This value may have been explicitly set on this individual row, or may be the default value for the grid if no value was set for this row.

QicsRow is a flyweight class representing a single row in the table. Instances of this object are created only when necessary -- there is no large array of row objects contained in the table. Rather, they are created directly (via the public constructor) or indirectly (via QicsTable::row(), QicsTable::rowRef(), QicsHeader::row(), or QicsHeader::rowRef()) by the programmer when needed.

Persistent objects, created by the public constructor, by QicsTable::row() and by QicsHeader::row(), are valid until they are explicitly destroyed, or until the table itself is destroyed. This brings up the possibility that rows in the table may be inserted, deleted, or reordered while QicsRow objects persist. Because of this possibility, QicsRow objects can be created so that they always refer to the same row in the data model, or so that they always refer to the same row in the view (i.e. the table widget).

Any attribute settings that are made while using a row object that follows the model are considered to be model attribute settings. These settings will always pertain to this model row, even if rows are reordered. Attribute settings that are made while using a row object that does not follow the model are considered to be visual attribute settings. These settings will always pertain to the visual row, regardless of what model row is being displayed in that row of the table.

Member Enumeration Documentation

enum Qics::QicsWideKeyAction [inherited]

Denotes global key actions available for the table grid.

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

enum Qics::QicsBoxBorders [inherited]

Denotes the box borders of cell region.

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

enum Qics::QicsCopyPolicy [inherited]

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

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

enum Qics::QicsClearPolicy [inherited]

Denotes the clearing policy during cut and delete operations.

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

enum Qics::QicsSortMode [inherited]

Denotes the sort algorithm which is used.

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

enum Qics::QicsCellOverflowBehavior [inherited]

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

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

enum Qics::QicsCurrentCellStyle [inherited]

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

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

enum Qics::QicsSelectionStyle [inherited]

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

enum Qics::QicsSelectCurrentCellPolicy [inherited]

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

enum Qics::QicsGridCellClipping [inherited]

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

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

enum Qics::QicsGridType [inherited]

Specifies a type of grid object.

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

enum Qics::QicsHeaderType [inherited]

Specifies the type of table header.

HeaderRow A row header.
HeaderColumn A column header.

enum Qics::QicsIndexType [inherited]

Specifies the type of table index.

RowIndex A row index.
ColumnIndex A column index.

enum Qics::QicsLineStyle [inherited]

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

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

enum Qics::QicsRepaintBehavior [inherited]

Specifies the recalculation and repainting behavior of tables and grids.

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

enum Qics::QicsScrollBarMode [inherited]

Specifies the various modes of QicsTable's scroll bars.

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

enum Qics::QicsScrollDirection [inherited]

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

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

enum Qics::QicsSelectionPolicy [inherited]

Denotes the selection policy for the table.

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

enum Qics::QicsSortOrder [inherited]

Specifies whenever ordering should be ascending or descending.

Ascending Ascending order.
Descending Descending order.

enum Qics::QicsTableDisplayOption [inherited]

Specifies a printing display policy for elements of the table.

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

enum Qics::QicsTraversalKeyEditBehavior [inherited]

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

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

enum Qics::QicsCurrentCellDraggingPolicy [inherited]

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

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

enum Qics::QicsCellWidthMode [inherited]

Specifies the behavior of set cell font.

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

enum Qics::QicsCellDecorationStyle [inherited]

Specifies the cell decoration style for headers.

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

Constructor & Destructor Documentation

QicsRow::QicsRow	(	int	row,
		QicsTable *	table,
		bool	follow_model = `true`
	)

Constructor for the class.

Parameters:

	row	row index
	table	the cell's table
	follow_model	indices follow model?

Note:: The macro CREATE_OBJS_WITH_QICSTABLE must be defined in order to use this constructor. If you are using qmake, you can add "DEFINES=CREATE_OBJS_WITH_QICSTABLE" to your application's .pro file.

Member Function Documentation

int QicsRow::rowIndex ( void ) const

Returns the visual row index of this row object. See the "rowIndex" property for details.

See also:: setRowIndex() modelRowIndex()

int QicsRow::modelRowIndex ( void ) const

Returns the model row index of this row object. See the "modelRowIndex" property for details.

See also:: rowIndex()

bool QicsRow::isValid ( void ) const

Returns true if the row index is valid, false if it is not. A row index may become invalid if rows in the data model are deleted.

QicsDataModelRow QicsRow::dataValues	(	int	first_col = `0`,
		int	last_col = `-1`
	)			const

Returns the data values for this row.

See also:: setDataValues()

int QicsRow::heightInPixels ( void ) const

Returns the height of this row in pixels. See the "heightInPixels" property for details.

See also:: setHeightInPixels()

int QicsRow::heightInChars ( void ) const

Returns the height of this row in character units (i.e. lines). See the "heightInChars" property for details.

See also:: setHeightInChars()

int QicsRow::minHeightInPixels ( void ) const

Returns the minimum height of this row in pixels. See the "minHeightInPixels" property for details.

See also:: setMinHeightInPixels()

int QicsRow::minHeightInChars ( void ) const

Returns the minimum height of this row in character units (i.e. lines). See the "minHeightInChars" property for details.

See also:: setMinHeightInChars()

int QicsRow::maxHeightInPixels ( void ) const

Returns the maximum height of this row in pixels. See the "maxHeightInPixels" property for details.

See also:: setMaxHeightInPixels()

int QicsRow::maxHeightInChars ( void ) const

Returns the maximum height of this row in character units (i.e. lines). See the "maxHeightInChars" property for details.

See also:: setMaxHeightInChars()

bool QicsRow::isHidden ( void ) const

Returns whether this row is hidden or not.

bool QicsRow::stretchable ( void ) const

Returns true if this row is stretchable, or false if it is not. See the "stretchable" property for details.

See also:: setStretchable()

virtual bool QicsRow::selected ( void ) const [virtual]

Returns the selected attribute of the row.

Since:: 2.3

Reimplemented from QicsCellCommon.

void QicsRow::setRowIndex ( int idx ) [slot]

Sets the the row index of this object to idx. See the "rowIndex" property for details.

See also:: rowIndex()

void QicsRow::setDataValues ( QicsDataModelRow & vals ) [slot]

Sets the data values for this row.

See also:: dataValues()

void QicsRow::setHeightInPixels ( int height ) [slot]

Sets the height of this row in pixels. See the "heightInPixels" property for details.

See also:: heightInPixels()

void QicsRow::setHeightInChars ( int height ) [slot]

Sets the height of this row in character units (i.e. lines). See the "heightInChars" property for details.

See also:: heightInChars()

void QicsRow::setMinHeightInPixels ( int height ) [slot]

Sets the minimum height of this row in pixels. See the "minHeightInPixels" property for details.

See also:: minHeightInPixels()

void QicsRow::setMinHeightInChars ( int height ) [slot]

Sets the minimum height of this row in character units (i.e. lines). See the "minHeightInChars" property for details.

See also:: minHeightInChars()

void QicsRow::setMaxHeightInPixels ( int height ) [slot]

Sets the maximum height of this row in pixels. See the "maxHeightInPixels" property for details.

See also:: maxHeightInPixels()

void QicsRow::setMaxHeightInChars ( int height ) [slot]

Sets the maximum height of this row in character units (i.e. lines). See the "maxHeightInChars" property for details.

See also:: maxHeightInChars()

void QicsRow::hide ( void ) [slot]

Hides this row.

void QicsRow::show ( void ) [slot]

Shows this row.

void QicsRow::setStretchable ( bool b ) [slot]

Sets whether this row is stretchable. See the "stretchable" property for details.

See also:: stretchable()

QString QicsCellCommon::label ( void ) const [inherited]

Returns the label attribute of this cell. This string may be used by the cell displayer when rendering the contents of this cell. See the "label" property for details.

See also:: setLabel()

bool QicsCellCommon::enabled ( void ) const [inherited]

Returns the enabled attribute of the cell. See the "enabled" property for details.

See also:: setEnabled()

bool QicsCellCommon::readOnly ( void ) const [inherited]

Returns the read-only attribute of the cell. See the "readOnly" property for details.

See also:: setReadOnly()

QFont QicsCellCommon::font ( void ) const [inherited]

Returns the font attribute of the cell. See the "font" property for details.

See also:: setFont()

QPalette QicsCellCommon::palette ( void ) const [inherited]

Returns the palette attribute of the cell. See the "palette" property for details.

See also:: setPalette()

QColor QicsCellCommon::foregroundColor ( void ) const [inherited]

Returns the cell's foreground color. See the "foregroundColor" property for details.

See also:: setForegroundColor()

QColor QicsCellCommon::backgroundColor ( void ) const [inherited]

Returns the cell's background color. See the "backgroundColor" property for details.

See also:: setBackgroundColor()

QColor QicsCellCommon::selectedForegroundColor ( void ) const [inherited]

Returns the cell's selected foreground color. See the "selectedForegroundColor" property for details.

See also:: setSelectedForegroundColor()

QColor QicsCellCommon::selectedBackgroundColor ( void ) const [inherited]

Returns the cell's selected background color. See the "selectedBackgroundColor" property for details.

See also:: setSelectedBackgroundColor()

QPixmap QicsCellCommon::pixmap ( void ) const [inherited]

Returns the cell's pixmap. See the "pixmap" property for details.

See also:: setPixmap()

int QicsCellCommon::pixmapSpacing ( void ) const [inherited]

Returns the cell's pixmap spacing See the "pixmapSpacing" property for details.

See also:: setPixmap()

const QCursor& QicsCellCommon::cursor ( void ) const [inherited]

Returns the cursor for this cell. See the "cursor" property for details.

See also:: setCursor()
unsetCursor()

int QicsCellCommon::alignment ( void ) const [inherited]

Returns the alignment options for this cell. See the "alignment" property for details.

See also:: Qt::Alignment
setAlignment()

int QicsCellCommon::textFlags ( void ) const [inherited]

Returns the text flags attribute of the cell. See the "textFlags" property for details.

See also:: Qt::TextFlags
setTextFlags()

int QicsCellCommon::maxLength ( void ) const [inherited]

Returns the maximum length of the value in this cell. See the "maxLength" property for details.

See also:: setMaxLength()

int QicsCellCommon::margin ( void ) const [inherited]

Returns the margin of the cell (in pixels). See the "margin" property for details.

See also:: setMargin()

int QicsCellCommon::borderWidth ( void ) const [inherited]

Returns the border width of this cell. See the "borderWidth" property for details.

See also:: setBorderWidth()

QPen QicsCellCommon::topBorderPen ( void ) const [inherited]

Returns the pen used to draw the top border of this cell. See the "topBorderPen" property for details.

See also:: setTopBorderPen()

QPen QicsCellCommon::leftBorderPen ( void ) const [inherited]

Returns the pen used to draw the left border of this cell. See the "leftBorderPen" property for details.

See also:: setLeftBorderPen()

QPen QicsCellCommon::rightBorderPen ( void ) const [inherited]

Returns the pen used to draw the right border of this cell. See the "rightBorderPen" property for details.

See also:: setRightBorderPen()

QPen QicsCellCommon::bottomBorderPen ( void ) const [inherited]

Returns the pen used to draw the bottom border of this cell. See the "bottomBorderPen" property for details.

See also:: setBottomBorderPen()

QString QicsCellCommon::toolTipText ( void ) const [inherited]

Returns the tool tip attribute of this cell. This string will be displayed in a tooltip when the mouse is hovered over the cell. See the "toolTipText" property for details.

See also:: setToolTipText()

QColor QicsCellCommon::editForegroundColor ( void ) const [inherited]

Returns the cell's edit foreground color. See the "editForegroundColor" property for details.

See also:: setEditForegroundColor()

QColor QicsCellCommon::editBackgroundColor ( void ) const [inherited]

Returns the cell's edit background color. See the "editBackgroundColor" property for details.

See also:: setEditBackgroundColor()

bool QicsCellCommon::autoRecognition ( void ) [inherited]

Returns auto recognition flag for cell. See the "autoRecognition" property for details.

See also:: setAutoRecognition()

QicsPasteValidator* QicsCellCommon::pasteValidator ( void ) const [inherited]

Returns the paste validator object for this cell. See the "pasteValidator" property for details.

See also:: setPasteValidator()

QValidator* QicsCellCommon::validator ( void ) const [inherited]

Returns the default cell validator object. This validator will be used when cells are edited. See the "validator" property for details.

See also:: setValidator()

bool QicsCellCommon::canAcceptDrops ( void ) const [slot, inherited]

This method returns true is cell can recive any drag data, othervise returns false. Se also "setCanAcceptDrops" function.

QicsDataModel* QicsCellCommon::dataModel ( void ) const [inline, inherited]

Returns the data model associated with this object.

Reimplemented in QicsTableCommon.

QFont QicsCellCommon::selectedFont ( void ) const [inherited]

Returns the selected font attribute of the cell. See the "selectedFont" property for details.

See also:: setSelectedFont()

QColor QicsCellCommon::highlightForegroundColor ( void ) const [inherited]

Returns the cell's highlight foreground color. See the "highlightForegroundColor" property for details.

See also:: setHighlightForegroundColor()

Since:: 2.3

QColor QicsCellCommon::highlightBackgroundColor ( void ) const [inherited]

Returns the cell's highlight background color. See the "highlightBackgroundColor" property for details.

See also:: setHighlightBackgroundColor()

Since:: 2.3

QicsCellDisplay* QicsCellCommon::displayer ( void ) const [inherited]

Returns the QicsCellDisplay object for this cell. The cell display object controls aspects of displaying and editing the cell. See QicsCellDisplay and its subclasses for details.

See also:: setDisplayer()

QicsDataItemFormatter* QicsCellCommon::formatter ( void ) const [inherited]

Returns the QicsDataItemFormatter object for this cell. The formatter object controls the formatting of data values that are displayed in this cell. See QicsDataItemFormatter and its subclasses for details.

See also:: setFormatter()

void* QicsCellCommon::userData ( void ) const [inherited]

Returns a user-supplied pointer for this cell.

void QicsCellCommon::setMargin ( int margin ) [slot, inherited]

Sets the margin of the cell (in pixels). See the "margin" property for details.

See also:: margin()

void QicsCellCommon::setReadOnly ( bool b ) [slot, inherited]

Sets the read-only attribute of the cell. See the "readOnly" property for details.

See also:: readOnly()

void QicsCellCommon::setFont ( const QFont & font ) [slot, inherited]

Sets the font attribute of the cell. See the "font" property for details.

See also:: font()

void QicsCellCommon::setSelectedFont ( const QFont & font ) [slot, inherited]

Sets the selected font attribute of the cell. See the "selectedFont" property for details.

See also:: selectedFont()

void QicsCellCommon::setPalette ( const QPalette & pal ) [slot, inherited]

Sets the palette attribute of the cell. See the "palette" property for details.

See also:: palette()

void QicsCellCommon::setForegroundColor ( const QColor & p ) [slot, inherited]

Sets the cell's foreground color. See the "foregroundColor" property for details.

See also:: foregroundColor()

void QicsCellCommon::setBackgroundColor ( const QColor & p ) [slot, inherited]

Sets the cell's background color. See the "backgroundColor" property for details.

See also:: backgroundColor()

void QicsCellCommon::setSelectedForegroundColor ( const QColor & p ) [slot, inherited]

Sets the cell's selected foreground color. See the "selectedForegroundColor" property for details.

See also:: selectedForegroundColor()

void QicsCellCommon::setSelectedBackgroundColor ( const QColor & p ) [slot, inherited]

Sets the cell's selected background color. See the "selectedBackgroundColor" property for details.

See also:: selectedBackgroundColor()

void QicsCellCommon::setEditForegroundColor ( const QColor & p ) [slot, inherited]

Sets the cell's edit foreground color. See the "editForegroundColor" property for details.

See also:: editForegroundColor()

void QicsCellCommon::setEditBackgroundColor ( const QColor & p ) [slot, inherited]

Sets the cell's edit background color. See the "editBackgroundColor" property for details.

See also:: editBackgroundColor()

void QicsCellCommon::setHighlightForegroundColor ( const QColor & p ) [slot, inherited]

Sets the cell's highlight foreground color. See the "highlightForegroundColor" property for details.

See also:: highlightForegroundColor(), QicdGridCommon::highlightSelection()

Since:: 2.3

void QicsCellCommon::setHighlightBackgroundColor ( const QColor & p ) [slot, inherited]

Sets the cell's highlight background color. See the "highlightBackgroundColor" property for details.

See also:: highlightBackgroundColor(), QicdGridCommon::setHighlightSelection()

Since:: 2.3

void QicsCellCommon::setPixmap ( const QPixmap & p ) [slot, inherited]

Sets the cell's pixmap attribute. See the "pixmap" property for details.

See also:: pixmap()

void QicsCellCommon::setPixmap ( const QString & file_name ) [slot, inherited]

Sets the cell's pixmap attribute from a file. See the "pixmap" property for details.

See also:: pixmap()

void QicsCellCommon::setPixmapSpacing ( int sp ) [slot, inherited]

Sets the cell's pixmap spacing. See the "pixmapSpacing" property for details.

See also:: pixmap()

void QicsCellCommon::setDisplayer ( QicsCellDisplay * d ) [slot, inherited]

Sets the QicsCellDisplay object for this cell. The cell display object controls aspects of displaying and editing the cell. See QicsCellDisplay and its subclasses for details. Setting this value to 0 will cause the table to use the default cell display object for this cell.

See also:: displayer()

void QicsCellCommon::setFormatter ( QicsDataItemFormatter * d ) [slot, inherited]

Sets the QicsDataItemFormatter object for this cell. The formatter object controls the formatting of data values that are displayed in this cell. See QicsDataItemFormatter and its subclasses for details.

See also:: formatter()

void QicsCellCommon::setAlignment ( int flags ) [slot, inherited]

Sets the alignment options for this cell. See the "alignment" property for details.

See also:: Qt::Alignment
alignment()

void QicsCellCommon::setEnabled ( bool b ) [slot, inherited]

Sets the enabled attribute of the cell. See the "enabled" property for details.

See also:: enabled()

void QicsCellCommon::setTextFlags ( int flags ) [slot, inherited]

Sets the text flags attribute of the cell. See the "textFlags" property for details.

See also:: Qt::TextFlags
textFlags()

void QicsCellCommon::setValidator ( QValidator * v ) [slot, inherited]

Sets the default cell validator object. This validator will be used when cells are edited. See the "validator" property for details.

See also:: validator()

void QicsCellCommon::setPasteValidator ( QicsPasteValidator * v ) [slot, inherited]

Sets the paste validator object for this cell. See the "pasteValidator" property for details.

See also:: pasteValidator()

void QicsCellCommon::setLabel ( const QString & label ) [slot, inherited]

Sets the label attribute of this cell. This string may be used by the cell displayer when rendering the contents of this cell. See the "label" property for details.

See also:: label()

void QicsCellCommon::setMaxLength ( int len ) [slot, inherited]

Sets the maximum length of the value in this cell. See the "maxLength" property for details.

See also:: maxLength()

void QicsCellCommon::setCursor ( const QCursor & c ) [slot, inherited]

Sets the cursor for this cell. See the "cursor" property for details.

See also:: cursor()
unsetCursor()

void QicsCellCommon::unsetCursor ( void ) [slot, inherited]

Unsets the cursor for this cell. See the "cursor" property for details.

See also:: cursor()
setCursor()

void QicsCellCommon::setBorderWidth ( int bw ) [slot, inherited]

Sets the border width of this cell. See the "borderWidth" property for details.

See also:: borderWidth()

void QicsCellCommon::setTopBorderPen ( const QPen & pen ) [slot, inherited]

Sets the pen used to draw the top border of this cell. See the "topBorderPen" property for details.

See also:: topBorderPen()

void QicsCellCommon::setLeftBorderPen ( const QPen & pen ) [slot, inherited]

Sets the pen used to draw the left border of this cell. See the "leftBorderPen" property for details.

See also:: leftBorderPen()

void QicsCellCommon::setRightBorderPen ( const QPen & pen ) [slot, inherited]

Sets the pen used to draw the right border of this cell. See the "rightBorderPen" property for details.

See also:: rightBorderPen()

void QicsCellCommon::setBottomBorderPen ( const QPen & pen ) [slot, inherited]

Sets the pen used to draw the bottom border of this cell. See the "bottomBorderPen" property for details.

See also:: bottomBorderPen()

void QicsCellCommon::setUserData ( void * data ) [slot, inherited]

Sets a user-supplied pointer for this cell. The table will not use or delete this pointer. It remains under the programmer's control.

void QicsCellCommon::setToolTipText ( const QString & txt ) [slot, inherited]

Sets the tool tip attribute of this cell. This string will be displayed in a tooltip when the mouse is hovered over the cell. See the "toolTipText" property for details.

See also:: toolTip()

void QicsCellCommon::setAutoRecognition ( const bool flag ) [slot, inherited]

Sets automatical recognition for cell. See the "autoRecognition" property for details.

See also:: autoRecognition()

void QicsCellCommon::setCanAcceptDrops ( const bool ) [slot, inherited]

Sets allowing cell to recive drag and drop data. If you sets to false, cell will not recive and cannot send any drag data. By default all cells can recive and send/move they dataItems. Se get method "canAcceptDrops"

Member Data Documentation

int QicsRow::rowIndex

Specifies the visual row index of this object. The visual index is the index of this object as it appears in the associated table. This value is not necessarily the correct index into the associated data model (rows may have been reordered). Use the "modelRowIndex" property for the correct model index.

int QicsRow::modelRowIndex

Specifies the model row index of this object. The model index is the index of this object in the associated data model. This value is not necessarily the correct index into the current visual presentation of the table (rows may have been reordered). Use the "rowIndex" property for the correct visual index.

int QicsRow::heightInPixels

Specifies the height of this row in pixels. If the height of this row has been set in character units, retrieving this property will return the equivalent height in pixels.

The default value of this property is dependent on the height of the default font.

int QicsRow::heightInChars

Specifies the height of this row in character units. This means that setting this value to 1 will change the height of this row to be just large enough to display one line of text (plus the margin size and border width). If the height of this row has been set by pixel, retrieving this property will return the equivalent height in character units based on the current font.

The default value of this property is dependent on the height of the default font.

int QicsRow::minHeightInPixels

Specifies the minimum height of this row in pixels. If the minimum height of this row has been set by character units, retrieving this property will return the equivalent height in pixels.

The default value of this property is dependent on the height of the default font.

int QicsRow::minHeightInChars

Specifies the minimum height of this row in character units. This means that setting this value to 1 will change the minimum height of this row to be just large enough to display one line of text (plus the margin size and border width). If the minimum height of this row has been set by pixel, retrieving this property will return the equivalent height in character units based on the current font.

The default value of this property is dependent on the height of the default font.

int QicsRow::maxHeightInPixels

Specifies the maximum height of this row in pixels. If the maximum height of this row has been set in character units, retrieving this property will return the equivalent height in pixels.

int QicsRow::maxHeightInChars

Specifies the maximum height of this row in character units.

bool QicsRow::stretchable

Specifies if this row can be stretched. Visible rows that can be stretched will grow or shrink as necessary when the height of the table changes.

The default value of this property is false.

QString QicsCellCommon::label [inherited]

Specifies the label of the cell(s). This string may be used by the cell displayer when rendering the contents of the cell(s).

The default value of this property is the null string.

bool QicsCellCommon::enabled [inherited]

Specifies the enabled attribute of the cell(s). If the value of this property is false, the cell cannot be traversed to.

The default value of this property is true.

bool QicsCellCommon::readOnly [inherited]

Specifies if the cell(s) is/are not allowed to be modified.

The default value of this property is false.

bool QicsCellCommon::selected [inherited]

Specifies the current selection state of this cell/row/column.

The default value of this property is false.

QFont QicsCellCommon::font [inherited]

Specifies the font that will be used to draw text in the cell(s).

The default value of this property is the default font of the QicsTable widget.

QPalette QicsCellCommon::palette [inherited]

Specifies the palette that will be used when drawing in the cell(s).

The default value of this property is the default palette of the QicsTable widget.

QColor QicsCellCommon::foregroundColor [inherited]

This is convenience property which specifies the foreground color of the cell(s) by changing palette property. This color will be used when drawing any text in the cell(s) when it is not selected.

The default value of this property is the default foreground color of the QicsTable widget.

Note: Since setting property on row/column overrides cells property as well as setting table's property overrides rows/columns property, and foreground color is really part of palette property, setting foreground color on row/column will override any other color settings of cells in that row/column. For example, if you set the foreground on a cell, and then set the background on a row, the foreground of the cell will also be changed to default palette. To obtain desired behavior user should set colors in next sequence: 1. Set the table colors 2. Set the row/column colors 3. Set the cell colors

QColor QicsCellCommon::backgroundColor [inherited]

This is convenience property which specifies the background color of the cell(s) by changing palette property. This color will be used when the cell is not selected.

The default value of this property is the default background color of the QicsTable widget.

Note: Since setting property on row/column overrides cells property as well as setting table's property overrides rows/columns property, and background color is really part of palette property, setting background color on row/column will override any other color settings of cells in that row/column. For example, if you set the foreground on a cell, and then set the background on a row, the foreground of the cell will also be changed to default palette. To obtain desired behavior user should set colors in next sequence: 1. Set the table colors 2. Set the row/column colors 3. Set the cell colors

QColor QicsCellCommon::selectedForegroundColor [inherited]

This is convenience property which specifies the selected foreground color of the cell(s) by changing palette property. This color will be used when drawing any text in the cell when the cell is selected.

The default value of this property is the default selectedForeground color of the QicsTable widget.

Note: Since setting property on row/column overrides cells property as well as setting table's property overrides rows/columns property, and selected foreground color is really part of palette property, setting selected foreground color on row/column will override any other color settings of cells in that row/column. For example, if you set the foreground on a cell, and then set the background on a row, the foreground of the cell will also be changed to default palette. To obtain desired behavior user should set colors in next sequence: 1. Set the table colors 2. Set the row/column colors 3. Set the cell colors

QColor QicsCellCommon::selectedBackgroundColor [inherited]

This is convenience property which specifies the selected background color of the cell(s) by changing palette property. This color will be used when the cell is selected.

The default value of this property is the default selectedBackground color of the QicsTable widget.

Note: Since setting property on row/column overrides cells property as well as setting table's property overrides rows/columns property, and selected background color is really part of palette property, setting selected background color on row/column will override any other color settings of cells in that row/column. For example, if you set the foreground on a cell, and then set the background on a row, the foreground of the cell will also be changed to default palette. To obtain desired behavior user should set colors in next sequence: 1. Set the table colors 2. Set the row/column colors 3. Set the cell colors

QPixmap QicsCellCommon::pixmap [inherited]

Specifies the pixmap to use when drawing the cell(s). If set, the pixmap is drawn in the cell. If the cell also has a value in the QicsDataModel, the pixmap will be drawn at the left of the cell, and the value will be drawn to the right of the pixmap. If the pixmap is a null pixmap, no pixmap will be shown.

The default value of this property is the null pixmap.

int QicsCellCommon::pixmapSpacing [inherited]

Specifies the number of pixels between the pixmap and the text in the cell(s).

The default value of this property is 6.

QCursor QicsCellCommon::cursor [inherited]

Specifies the cursor for the cell(s). This cursor will be displayed whenever the mouse pointer is within the cell.

The default value of this property is the null cursor, which means that the default cursor for the table widget will be displayed.

int QicsCellCommon::alignment [inherited]

Specifies the alignment setting used when drawing the cell(s).

The default value of this property is Qt::AlignLeft.

See also:: Qt::Alignment

int QicsCellCommon::textFlags [inherited]

Specifies the text flag setting used when drawing the cell(s). The Qt::DontClip modifier will be ignored. The default value of this property is 0.

See also:: Qt::TextFlags

int QicsCellCommon::maxLength [inherited]

Specifies the maximum length of the value in the cell(s).

The default value of this property is 32767.

int QicsCellCommon::margin [inherited]

Specifies the cell margin (in pixels). The margin is the area between the cell border and the body of the cell that is not used for information display. It will always be filled with the background color of the cell(s).

The default value of this property is 1.

int QicsCellCommon::borderWidth [inherited]

Specifies the border width of the cell(s).

The default value of this property is 1.

QPen QicsCellCommon::topBorderPen [inherited]

Specifies the pen that will be used to draw the top border of the cell(s).

The default value of this property is the default QPen.

QPen QicsCellCommon::leftBorderPen [inherited]

Specifies the pen that will be used to draw the left border of the cell(s).

The default value of this property is the default QPen.

QPen QicsCellCommon::rightBorderPen [inherited]

Specifies the pen that will be used to draw the right border of the cell(s).

The default value of this property is the default QPen.

QPen QicsCellCommon::bottomBorderPen [inherited]

Specifies the pen that will be used to draw the bottom border of the cell(s).

The default value of this property is the default QPen.

QString QicsCellCommon::toolTipText [inherited]

Specifies text to be shown as a tool tip when the mouse pointer is hovered over the cell(s).

The default value of this property is the null string, which will cause no tool tip to be displayed.

QColor QicsCellCommon::editForegroundColor [inherited]

Specifies the edit foreground color of the cell(s). This color will be used when the cell is being edited.

The default value of this property is the default text color of the QicsTable widget.

QColor QicsCellCommon::editBackgroundColor [inherited]

Specifies the edit background color of the cell(s). This color will be used when the cell is being edited.

The default value of this property is the default base color of the QicsTable widget.

bool QicsCellCommon::autoRecognition [inherited]

Specifies the style of input data in cell. If set's true the QicsTable do recognizing of input data into cell (QicsDataInt, QicsDataString, QicsDataDate, QicsDataDateTime, QicsDataTime).

Property Documentation

QicsPasteValidator QicsCellCommon::pasteValidator [read, write, inherited]

Specifies validator object that will be used for cell input validation. This validator will be used when data pasted in cell/cells(through drag&drop or QicsTable::paste() method).

QValidator QicsCellCommon::validator [read, write, inherited]

Specifies validator object that will be used for cell input validation This validator will be used when this cell is edited.

bool QicsCellCommon::canAcceptDrops [inherited]

Specifies how cell object react on reciving drag-data. By default all cell's of QicsTable hase allow to use Drag'n'Drop feature.

QicsTable Documentation Set

QicsRow Class Reference

Row Properties

Public Types

Public Slots

Public Member Functions

Public Attributes

Protected Slots

Protected Member Functions

Protected Attributes

Properties

Private Member Functions

Friends

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation

Property Documentation


Row Properties
int	rowIndex
int	modelRowIndex
int	heightInPixels
int	heightInChars
int	minHeightInPixels
int	minHeightInChars
int	maxHeightInPixels
int	maxHeightInChars
bool	stretchable
Public Types
enum	QicsWideKeyAction { Del_DeleteSelected, CtrlA_SelectAll }
enum	QicsBoxBorders { TopBorder = 1, BottomBorder = 2, LeftBorder = 4, RightBorder = 8, AllBorders = 1+2+4+8 }
enum	QicsCopyPolicy { CopyData = 1, CopyAttributes = 2, CopyDimensions = 4, CopySpans = 8, CopyAll = 1+2+4+8 }
enum	QicsClearPolicy { ClearData = 1, ClearAttributes = 2, ClearSpans = 4, ClearAll = 1+2+4 }
enum	QicsSortMode { QicsStableSort = 0, QicsQuickSort }
enum	QicsCellOverflowBehavior { Clip = 0, Overflow, ToolTip }
enum	QicsCurrentCellStyle { Spreadsheet = 0, NormalSelected }
enum	QicsSelectionStyle { Normal = 0, Exclusive }
enum	QicsSelectCurrentCellPolicy { Follow = 0, Static }
enum	QicsFillHandleEventType { FillHandlePressed = 0, FillHandleReleased, FillHandleDoubleClicked, FillHandleDragged }
enum	QicsGridCellClipping { AllowPartial = 0, NoDisplayOnPartial, UseClippedSymbol }
enum	QicsGridType { TableGrid = 0, RowHeaderGrid, ColumnHeaderGrid }
enum	QicsHeaderType { RowHeader = 0, ColumnHeader }
enum	QicsIndexType { NoIndex = 0, RowIndex, ColumnIndex, RowAndColumnIndex }
enum	QicsLineStyle { None = 0, Plain, Raised, Sunken }
enum	QicsRepaintBehavior { RepaintOff = 0, RepaintOn = 1, RepaintCalcOnly = 2 }
enum	QicsScrollBarMode { Auto = 0, AlwaysOff, AlwaysOn }
enum	QicsScrollDirection { ScrollNone = 0, ScrollUp = 1, ScrollDown = 2, ScrollLeft = 4, ScrollRight = 8, ScrollToRow = 16, ScrollToColumn = 32 }
enum	QicsSelectionPolicy { SelectNone = 0, SelectSingle, SelectMultiple, SelectSingleRow, SelectMultipleRow }
enum	QicsSelectionType { SelectionNone = 0, SelectionBegin, SelectionDrag, SelectionEnd, SelectionExtend, SelectionAdd, SelectionReplace }
enum	QicsSortOrder { Ascending = 0, Descending }
enum	QicsTableDisplayOption { DisplayNever = 0, DisplayAlways, DisplayFirstPage }
enum	QicsTraversalKeyEditBehavior { TraverseWithinCell = 0, TraverseBetweenCells }
enum	QicsCurrentCellDraggingPolicy { DragCurrent = 0, DragSelection }
enum	QicsCellWidthMode { ChangeOnlyHeight = 0, ChangeHeightWidth }
enum	QicsCellDecorationStyle { Flat = 0, Styled = 1 }
Public Slots
void	setRowIndex (int idx)
void	setDataValues (QicsDataModelRow &vals)
void	setHeightInPixels (int height)
void	setHeightInChars (int height)
void	setMinHeightInPixels (int height)
void	setMinHeightInChars (int height)
void	setMaxHeightInPixels (int height)
void	setMaxHeightInChars (int height)
void	hide (void)
void	show (void)
void	setStretchable (bool b)
bool	canAcceptDrops (void) const
void	setMargin (int margin)
void	setReadOnly (bool b)
void	setFont (const QFont &font)
void	setSelectedFont (const QFont &font)
void	setPalette (const QPalette &pal)
void	setForegroundColor (const QColor &p)
void	setBackgroundColor (const QColor &p)
void	setSelectedForegroundColor (const QColor &p)
void	setSelectedBackgroundColor (const QColor &p)
void	setEditForegroundColor (const QColor &p)
void	setEditBackgroundColor (const QColor &p)
void	setHighlightForegroundColor (const QColor &p)
void	setHighlightBackgroundColor (const QColor &p)
void	setPixmap (const QPixmap &p)
void	setPixmap (const QString &file_name)
void	setPixmapSpacing (int sp)
void	setDisplayer (QicsCellDisplay *d)
void	setFormatter (QicsDataItemFormatter *d)
void	setAlignment (int flags)
void	setEnabled (bool b)
void	setTextFlags (int flags)
void	setValidator (QValidator *v)
void	setPasteValidator (QicsPasteValidator *v)
void	setLabel (const QString &label)
void	setMaxLength (int len)
void	setCursor (const QCursor &c)
void	unsetCursor (void)
void	setBorderWidth (int bw)
void	setTopBorderPen (const QPen &pen)
void	setLeftBorderPen (const QPen &pen)
void	setRightBorderPen (const QPen &pen)
void	setBottomBorderPen (const QPen &pen)
void	setUserData (void *data)
void	setToolTipText (const QString &txt)
void	setAutoRecognition (const bool flag)
void	setCanAcceptDrops (const bool)
QicsGridInfo &	gridInfo ()
Public Member Functions
	QicsRow (int row, QicsTable *table, bool follow_model=true)
	QicsRow (int row, QicsGridInfo info, bool follow_model=true, QObject parent=0)
virtual void	setInfo (QicsGridInfo *info)
int	rowIndex (void) const
int	modelRowIndex (void) const
bool	isValid (void) const
QicsDataModelRow	dataValues (int first_col=0, int last_col=-1) const
int	heightInPixels (void) const
int	heightInChars (void) const
int	minHeightInPixels (void) const
int	minHeightInChars (void) const
int	maxHeightInPixels (void) const
int	maxHeightInChars (void) const
bool	isHidden (void) const
bool	isFiltered (void) const
bool	stretchable (void) const
virtual bool	selected (void) const
QString	label (void) const
bool	enabled (void) const
bool	readOnly (void) const
QFont	font (void) const
QPalette	palette (void) const
QColor	foregroundColor (void) const
QColor	backgroundColor (void) const
QColor	selectedForegroundColor (void) const
QColor	selectedBackgroundColor (void) const
QPixmap	pixmap (void) const
int	pixmapSpacing (void) const
const QCursor &	cursor (void) const
int	alignment (void) const
int	textFlags (void) const
int	maxLength (void) const
int	margin (void) const
int	borderWidth (void) const
QPen	topBorderPen (void) const
QPen	leftBorderPen (void) const
QPen	rightBorderPen (void) const
QPen	bottomBorderPen (void) const
QString	toolTipText (void) const
QColor	editForegroundColor (void) const
QColor	editBackgroundColor (void) const
bool	autoRecognition (void)
QicsPasteValidator *	pasteValidator (void) const
QValidator *	validator (void) const
QicsDataModel *	dataModel (void) const
QFont	selectedFont (void) const
QColor	highlightForegroundColor (void) const
QColor	highlightBackgroundColor (void) const
QicsCellDisplay *	displayer (void) const
QicsDataItemFormatter *	formatter (void) const
void *	userData (void) const
Public Attributes
QString	label
bool	enabled
bool	readOnly
bool	selected
QFont	font
QPalette	palette
QColor	foregroundColor
QColor	backgroundColor
QColor	selectedForegroundColor
QColor	selectedBackgroundColor
QPixmap	pixmap
int	pixmapSpacing
QCursor	cursor
int	alignment
int	textFlags
int	maxLength
int	margin
int	borderWidth
QPen	topBorderPen
QPen	leftBorderPen
QPen	rightBorderPen
QPen	bottomBorderPen
QString	toolTipText
QColor	editForegroundColor
QColor	editBackgroundColor
bool	autoRecognition
Protected Slots
void	handleModelRowInsert (int nrows, int pos)
void	handleModelRowDelete (int nrows, int pos)
void	handleOrderChanged (Qics::QicsIndexType type, QVector< int > &visChange)
void	changeDataModel (QicsDataModel old_dt, QicsDataModel new_dt)
void	gridDeleted ()
Protected Member Functions
void	init (void)
virtual void	setAttr (QicsCellStyle::QicsCellStyleProperty attr, const void *val)
virtual void *	getAttr (QicsCellStyle::QicsCellStyleProperty attr) const
virtual void	clearAttr (QicsCellStyle::QicsCellStyleProperty attr)
virtual void	setDMMargin (int margin)
virtual void	setDMFont (const QFont &font)
virtual void	setDMBorderWidth (int bw)
int	modelOrVisualRowIndex (void) const
virtual void	setDMFitSize (int, int)
QicsStyleManager &	styleManager (void) const
QicsDimensionManager &	dimensionManager (void) const
Protected Attributes
int	myRow
QPointer< QicsGridInfo >	myInfo
bool	myFollowModel
Properties
QicsPasteValidator	pasteValidator
QValidator	validator
bool	canAcceptDrops
Private Member Functions
void	commonInit (QicsGridInfo *info)
Friends
class	QicsTableCommon
class	QicsHeader