QicsWidgetCellDisplay Class Reference

A cell displayer which uses a single widget for display. More...

#include <QicsWidgetCellDisplay.h>

Inherits QObject, and QicsCellDisplay.

List of all members.

Public Types

enum QicsWideKeyAction {
  Del_DeleteSelected, CtrlA_SelectAll, CtrlC_Copy, CtrlV_Paste,
  CtrlX_Cut
}

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 { NoChange = 0, ChangeOnlyHeight, ChangeHeightWidth }

enum QicsCellDecorationStyle { Flat = 0, Styled = 1 }

enum QicsHeaderDragStyle { SimpleDrag = 0, StyledDrag = 1 }

enum QicsAutoFitMode { Native = 0, Excel }

Public Member Functions

QicsWidgetCellDisplay (QWidget *displayWidget, QObject *parent=0)

virtual ~QicsWidgetCellDisplay ()

virtual void displayCell (QicsGrid *, int row, int col, const QicsDataItem *itm, QRect &rect, QPainter *painter)

virtual void startEdit (QicsScreenGrid *, int, int, const QicsDataItem *)

virtual void moveEdit (QicsScreenGrid *, int, int, const QRect &)

virtual void endEdit (QicsScreenGrid *, int, int)

virtual QSize sizeHint (QicsGrid *grid, int row, int col, const QicsDataItem *itm)

virtual bool editWhenCurrent (void) const

virtual bool eventFilter (QObject *watched, QEvent *e)

virtual bool needsVisibilityNotification (void) const

virtual QWidget * widget ()

virtual bool isEmpty (QicsGridInfo *, int, int, const QicsDataItem *) const

virtual void aboutToClear (QicsGridInfo *, int, int)

virtual QicsCellDisplay * clone ()

virtual Qt::FocusReason lastFocusReason ()

bool isEditing ()

virtual bool useWholeRow () const

void setSpanned (bool span)

virtual bool handleMouseEvent (QicsScreenGrid *grid, int row, int col, QMouseEvent *me)

virtual bool handleKeyEvent (QicsScreenGrid *grid, int row, int col, QKeyEvent *ke)

virtual QString tooltipText (QicsGridInfo *info, int row, int col, const QicsDataItem *itm, const QRect &rect) const

virtual QString cellDisplayName () const

virtual QDomElement toDomXml (const QString &tag, QDomDocument *doc)

virtual void configureFromDomXml (const QDomElement &e)

virtual void drawCellBorders (QicsGridInfo *info, int row, int col, const QRect &rect, QPainter *painter)

virtual QRect contentRect (QicsGrid *, int, int, const QicsDataItem *, QRect &rect, QPainter *)

bool isActiveLook () const

void setActiveLook (bool on)

Static Public Member Functions

static bool defaultActiveLook ()

static void setDefaultActiveLook (bool on)

Static Public Attributes

static const QString BasicCellDisplayName

static const int QicsLAST_ROW = INT_MAX-1

static const int QicsLAST_COLUMN = INT_MAX-1

Protected Member Functions

void setWidget (QWidget *displayWidget)

virtual void drawBackground (QicsGridInfo *info, int row, int col, const QRect &rect, const QPalette &pal, QPainter *painter, bool is_current=false, bool is_selected=false)

virtual void drawBorder (QicsGridInfo *info, int row, int col, const QRect &rect, const QPalette &pal, QPainter *painter, bool is_current=false, bool is_selected=false)

virtual bool isCellSelected (QicsGridInfo *info, int row, int col)

virtual QPalette & cellPalette (bool enabled, bool for_printer=false)

virtual QRect displayableCellArea (QicsGridInfo *ginfo, int row, int col, const QRect &cr_full, bool consider_margin=true, bool consider_border=true) const

virtual QString textToDisplay (QicsGridInfo *info, int row, int col, const QicsDataItem *itm) const

virtual QPixmap pixmapToDisplay (QicsGridInfo *info, int row, int col, const QicsDataItem *itm) const

void commonInit (QicsGrid *grid, int row, int col, const QicsDataItem *itm, QRect &rect, QPainter *painter, QWidget *wdg, bool draw_bg, bool consider_frame)

Protected Attributes

QWidget * myWidget

QObjectCleanupHandler * objectCleanupHandler

QPointer< QicsCell > myCell

QPointer< QicsCell > myEditCell

QPointer< QicsRow > myRow

QPointer< QicsColumn > myColumn

QPointer< QicsMainGrid > myGrid

QPointer< QStyle > myStyle

bool myIsEditing

bool myActiveLook

bool mySpanned

Qt::FocusReason myLastFocusReason

Static Protected Attributes

static bool active_look

static bool for_printer

static bool is_enabled

static bool is_current

static bool is_selected

static QicsGridInfo * ginfo

static QStyle::State style_flags

static QPalette pal

static QRect cr

static QColor fg

static QColor bg

static QStyle * the_style

static QString qs

Detailed Description

A cell displayer which uses a single widget for display.

QicsWidgetCellDisplay displays a single widget in a cell.

Please note: it is possible to use one displayer for one cell only. You should not set the same displayer for several cells, or for a column/row. This is because after the displayer is installed for a cell, ownership of the widget transferred to the table grid. If you need to install another widget of the same class, please create new widget and new displayer.

Widget to display should be passed to the constructor. There's an example how to integrate QDial into the cell at (0,0).

 QicsTable *myTable;
 // myTable initialized here...
 QDial *myDial = new QDial();
 QicsWidgetCellDisplay *myDialDisplay = new QicsWidgetCellDisplay(myDial, myTable);
 myTable->cellRef(0,0).setDisplayer(myDialDisplay);

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

NoChange - does not change size of cells.
ChangeOnlyHeight - changing only height of the cell when new font is applies (cell width is not changed).
ChangeHeightWidth - changing height and width.

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.

enum Qics::QicsHeaderDragStyle [inherited]

Specifies row/column drag style for headers.

SimpleDrag Only drag cursor is used to indicate drag process.
StyledDrag Extended image is used to indicate drag process.

enum Qics::QicsAutoFitMode [inherited]

Specifies autofit modes.

Native It toggles between the user defined and minimal width (default).
Excel It is just setting the minimal width.

Constructor & Destructor Documentation

QicsWidgetCellDisplay::QicsWidgetCellDisplay	(	QWidget *	displayWidget,
		QObject *	parent = `0`
	)

Constructor for use by programmers.

virtual QicsWidgetCellDisplay::~QicsWidgetCellDisplay ( ) [virtual]

Destructor is virtual because this class may be subclassed.

Member Function Documentation

virtual void QicsWidgetCellDisplay::displayCell	(	QicsGrid *	,
		int	row,
		int	col,
		const QicsDataItem *	itm,
		QRect &	rect,
		QPainter *	painter
	)			`[virtual]`

Displays the widget in the specified location.

Implements QicsCellDisplay.

virtual void QicsWidgetCellDisplay::startEdit	(	QicsScreenGrid *	,
		int	,
		int	,
		const QicsDataItem *
	)			`[inline, virtual]`

This method is a no-op in this class, because the widget is always displayed, therefore there is no entry widget to update.

Reimplemented from QicsCellDisplay.

virtual void QicsWidgetCellDisplay::moveEdit	(	QicsScreenGrid *	,
		int	,
		int	,
		const QRect &
	)			`[inline, virtual]`

This method is a no-op in this class, because the widget is always displayed, therefore there is no entry widget to place.

Implements QicsCellDisplay.

virtual void QicsWidgetCellDisplay::endEdit	(	QicsScreenGrid *	,
		int	,
		int
	)			`[virtual]`

This method is a no-op in this class, but may be reimplmented in subclasses.

Reimplemented from QicsCellDisplay.

virtual QSize QicsWidgetCellDisplay::sizeHint	(	QicsGrid *	grid,
		int	row,
		int	col,
		const QicsDataItem *	itm
	)			`[virtual]`

Returns the size that cell (row, col ) needs to be if it is to completely display itm.

Parameters:

	grid	the controlling grid
	row	the row in visual coordinates
	col	the column in visual coordinates
	itm	the value to display. This value may be 0.

Implements QicsCellDisplay.

virtual bool QicsWidgetCellDisplay::editWhenCurrent ( void ) const [inline, virtual]

Returns true if cells using this displayer should automatically be put into edit mode when they become the current cell in the table.

Implements QicsCellDisplay.

virtual bool QicsWidgetCellDisplay::needsVisibilityNotification ( void ) const [inline, virtual]

Returns true if this displayer should be notified when its cells are no longer visible in the grid, false otherwise.

Reimplemented from QicsCellDisplay.

virtual QWidget* QicsWidgetCellDisplay::widget ( void ) [inline, virtual]

Returns widget that cell displayer uses or '0' otherwise.

Reimplemented from QicsCellDisplay.

virtual bool QicsWidgetCellDisplay::isEmpty	(	QicsGridInfo *	info,
		int	row,
		int	col,
		const QicsDataItem *	itm
	)			const `[inline, virtual]`

Returns true if the contents of cell (row, col ) (given data item itm ) are empty, false otherwise.

Parameters:

	info	grid info object
	row	the row in visual coordinates
	col	the column in visual coordinates
	itm	item that will be displayed in the cell

Implements QicsCellDisplay.

virtual void QicsWidgetCellDisplay::aboutToClear	(	QicsGridInfo *	,
		int	,
		int
	)			`[virtual]`

Called internally when the displayer is about to be cleared from the cell at row, col.

Since:: 2.4

Reimplemented from QicsCellDisplay.

bool QicsCellDisplay::isEditing ( ) [inline, inherited]

Returns true if cell displayer is editing now, otherwise returns false.

virtual bool QicsCellDisplay::useWholeRow ( ) const [inline, virtual, inherited]

Informs that it is row displayer (which handles drawing of the whole row).

See also:: setSpanned()

Since:: 2.4

void QicsCellDisplay::setSpanned ( bool span ) [inline, inherited]

Spans/unspans all the cells according to span.

See also:: useWholeRow()

Since:: 2.4

virtual bool QicsCellDisplay::handleMouseEvent	(	QicsScreenGrid *	grid,
		int	row,
		int	col,
		QMouseEvent *	me
	)			`[virtual, inherited]`

Handler for mouse events that occur within cell (row, col ). The handler must return true if the event was handled by the cell displayer (and thus should not be handled by the grid), or false otherwise.

Parameters:

	grid	the controlling grid
	row	the row in visual coordinates
	col	the column in visual coordinates
	me	the mouse event

Reimplemented in QicsCheckCellDisplay, QicsComboCellDisplay, QicsDateTimeCellDisplay, and QicsPushButtonCellDisplay.

virtual bool QicsCellDisplay::handleKeyEvent	(	QicsScreenGrid *	grid,
		int	row,
		int	col,
		QKeyEvent *	ke
	)			`[virtual, inherited]`

Handler for keyboard events that occur within cell (row, col ). The handler must return true if the event was handled by the cell displayer (and thus should not be handled by the grid), or false otherwise.

Parameters:

	grid	the controlling grid
	row	the row in visual coordinates
	col	the column in visual coordinates
	ke	the keyboard event

Reimplemented in QicsCheckCellDisplay, QicsComboCellDisplay, QicsDateTimeCellDisplay, QicsPushButtonCellDisplay, and QicsTextCellDisplay.

virtual QString QicsCellDisplay::tooltipText	(	QicsGridInfo *	info,
		int	row,
		int	col,
		const QicsDataItem *	itm,
		const QRect &	rect
	)			const `[virtual, inherited]`

Returns the text that a grid widget can display in a tooltip when the user hovers the mouse pointer over this cell.

Parameters:

	info	grid info object
	row	the row in visual coordinates
	col	the column in visual coordinates
	itm	item that will be displayed in the cell
	rect	size of the cell

Reimplemented in QicsTextCellDisplay.

virtual QString QicsCellDisplay::cellDisplayName ( ) const [virtual, inherited]

Returns displayer string name.

Reimplemented in QicsCheckCellDisplay, QicsComboCellDisplay, QicsDateTimeCellDisplay, QicsPushButtonCellDisplay, and QicsTextCellDisplay.

virtual QDomElement QicsCellDisplay::toDomXml	(	const QString &	tag,
		QDomDocument *	doc
	)			`[virtual, inherited]`

Helper function. Save displayer state to QDomDocument.

Reimplemented in QicsCheckCellDisplay, QicsComboCellDisplay, QicsDateTimeCellDisplay, and QicsPushButtonCellDisplay.

virtual void QicsCellDisplay::configureFromDomXml ( const QDomElement & e ) [virtual, inherited]

Helper function. Restore displayer state from QDomElement.

Reimplemented in QicsCheckCellDisplay, QicsComboCellDisplay, QicsDateTimeCellDisplay, QicsPushButtonCellDisplay, and QicsTextCellDisplay.

virtual void QicsCellDisplay::drawCellBorders	(	QicsGridInfo *	info,
		int	row,
		int	col,
		const QRect &	rect,
		QPainter *	painter
	)			`[virtual, inherited]`

Draws the borders of cell (row, col ) (based on cell borders properties contained in info at the location specified by rect.

Parameters:

	info	grid info object
	row	the row in visual coordinates
	col	the column in visual coordinates
	rect	location to draw in
	painter	painter to draw with

virtual QRect QicsCellDisplay::contentRect	(	QicsGrid *	,
		int	,
		int	,
		const QicsDataItem *	,
		QRect &	rect,
		QPainter *
	)			`[inline, virtual, inherited]`

Returns the full rect of the content of the displayer.

Reimplemented in QicsTextCellDisplay.

bool QicsCellDisplay::isActiveLook ( ) const [inline, inherited]

Returns the active look state. If true, cells will not be drawn differently even if disabled.

Since:: 2.4

void QicsCellDisplay::setActiveLook ( bool on ) [inline, inherited]

Sets the active look state to on. If true, cells will not be drawn differently even if disabled.

Since:: 2.4

static bool QicsCellDisplay::defaultActiveLook ( ) [inline, static, inherited]

Returns the default active look state. If true, cells will not be drawn differently even if disabled.

Since:: 2.4

static void QicsCellDisplay::setDefaultActiveLook ( bool on ) [inline, static, inherited]

Sets the default active look state to on. If on is true, cells will not be drawn differently even if disabled. All the newly created cell displayers will be initialized with this default state of active look.

Since:: 2.4

virtual void QicsCellDisplay::drawBackground	(	QicsGridInfo *	info,
		int	row,
		int	col,
		const QRect &	rect,
		const QPalette &	pal,
		QPainter *	painter,
		bool	is_current = `false`,
		bool	is_selected = `false`
	)			`[protected, virtual, inherited]`

Draws the background of cell (row, col ) using painter (based on cell and grid properties contained info) at the location specified by rect.

Parameters:

	info	grid info object
	row	the row in visual coordinates
	col	the column in visual coordinates
	rect	location to draw in
	pal	color group to draw with
	painter	painter to draw with
	is_current	is this cell the current cell?
	is_selected	is this cell selected?

virtual void QicsCellDisplay::drawBorder	(	QicsGridInfo *	info,
		int	row,
		int	col,
		const QRect &	rect,
		const QPalette &	pal,
		QPainter *	painter,
		bool	is_current = `false`,
		bool	is_selected = `false`
	)			`[protected, virtual, inherited]`

Draws the border of cell (row, col ) (based on cell and grid properties contained in info at the location specified by rect.

Parameters:

	info	grid info object
	row	the row in visual coordinates
	col	the column in visual coordinates
	rect	location to draw in
	pal	color group to draw with
	painter	painter to draw with
	is_current	is this cell the current cell?
	is_selected	is this cell selected?

virtual bool QicsCellDisplay::isCellSelected	(	QicsGridInfo *	info,
		int	row,
		int	col
	)			`[protected, virtual, inherited]`

Returns true if cell (row, col ) is selected in grids described by info. If the grid(s) are main table grids, this method simply determines if the cell is contained in the current selection list. If the grid(s) are header grids, this method determines if all the cells in the header cell's row or column are selected.

Parameters:

	info	grid info object
	row	the row in visual coordinates
	col	the column in visual coordinates

virtual QPalette& QicsCellDisplay::cellPalette	(	bool	enabled,
		bool	for_printer = `false`
	)			`[protected, virtual, inherited]`

Returns the palette to be used when drawing in cell (row, col ), using grid information from info. If for_printer is true, the palette will have a white background color substituted for any background colors that are the same as the default background color of the grid.

Parameters:

	info	grid info object
	row	the row in visual coordinates
	col	the column in visual coordinates
	for_printer	will this palette be used to print?

virtual QRect QicsCellDisplay::displayableCellArea	(	QicsGridInfo *	ginfo,
		int	row,
		int	col,
		const QRect &	cr_full,
		bool	consider_margin = `true`,
		bool	consider_border = `true`
	)			const `[protected, virtual, inherited]`

Returns a rectangle specifying the area of cell (row, col ) that can be used to display information. This rectangle is based on the full area of the cell (contained in cr_full ), minus the area reserved for the cell's border and margin.

Parameters:

	info	grid info object
	row	the row in visual coordinates
	col	the column in visual coordinates
	cr_full	the full area of the cell
	consider_margin	should the returned area exclude the margin of the cell?
	consider_border	should the returned area exclude the border of the cell?

virtual QString QicsCellDisplay::textToDisplay	(	QicsGridInfo *	info,
		int	row,
		int	col,
		const QicsDataItem *	itm
	)			const `[protected, virtual, inherited]`

Same as previous but assumes that myCell is set already.

Returns the label string for cell (row, col ).

This default method returns the value of the label property of the cell.

This method is intended to be reimplemented by subclasses of QicsCheckCellDisplay. The programmer should implement this method so that it returns the appropriate value for the given cell.

Parameters:

	info	grid info object
	row	the visual row index of the cell
	col	the visual column index of the cell
	itm	the data item for this cell (this value may be 0)

Reimplemented in QicsCheckCellDisplay, QicsDateTimeCellDisplay, and QicsPushButtonCellDisplay.

virtual QPixmap QicsCellDisplay::pixmapToDisplay	(	QicsGridInfo *	info,
		int	row,
		int	col,
		const QicsDataItem *	itm
	)			const `[protected, virtual, inherited]`

Returns the pixmap for cell (row, col ).

This default method returns the pixmap that was set for this cell via QicsCell::setPixmap , or 0 if no such pixmap exists.

This method is intended to be reimplemented by subclasses of QicsCheckCellDisplay. The programmer should implement this method so that it returns the appropriate value for the given cell. If no pixmap should be displayed, return the null pixmap.

Parameters:

	info	grid info object
	row	the visual row index of the cell
	col	the visual column index of the cell
	itm	the data item for this cell (this value may be 0)

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

QicsWidgetCellDisplay.h


Public Types
enum	QicsWideKeyAction { Del_DeleteSelected, CtrlA_SelectAll, CtrlC_Copy, CtrlV_Paste, CtrlX_Cut }
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 { NoChange = 0, ChangeOnlyHeight, ChangeHeightWidth }
enum	QicsCellDecorationStyle { Flat = 0, Styled = 1 }
enum	QicsHeaderDragStyle { SimpleDrag = 0, StyledDrag = 1 }
enum	QicsAutoFitMode { Native = 0, Excel }
Public Member Functions
	QicsWidgetCellDisplay (QWidget displayWidget, QObject parent=0)
virtual	~QicsWidgetCellDisplay ()
virtual void	displayCell (QicsGrid , int row, int col, const QicsDataItem itm, QRect &rect, QPainter *painter)
virtual void	startEdit (QicsScreenGrid , int, int, const QicsDataItem )
virtual void	moveEdit (QicsScreenGrid *, int, int, const QRect &)
virtual void	endEdit (QicsScreenGrid *, int, int)
virtual QSize	sizeHint (QicsGrid grid, int row, int col, const QicsDataItem itm)
virtual bool	editWhenCurrent (void) const
virtual bool	eventFilter (QObject watched, QEvent e)
virtual bool	needsVisibilityNotification (void) const
virtual QWidget *	widget ()
virtual bool	isEmpty (QicsGridInfo , int, int, const QicsDataItem ) const
virtual void	aboutToClear (QicsGridInfo *, int, int)
virtual QicsCellDisplay *	clone ()
virtual Qt::FocusReason	lastFocusReason ()
bool	isEditing ()
virtual bool	useWholeRow () const
void	setSpanned (bool span)
virtual bool	handleMouseEvent (QicsScreenGrid grid, int row, int col, QMouseEvent me)
virtual bool	handleKeyEvent (QicsScreenGrid grid, int row, int col, QKeyEvent ke)
virtual QString	tooltipText (QicsGridInfo info, int row, int col, const QicsDataItem itm, const QRect &rect) const
virtual QString	cellDisplayName () const
virtual QDomElement	toDomXml (const QString &tag, QDomDocument *doc)
virtual void	configureFromDomXml (const QDomElement &e)
virtual void	drawCellBorders (QicsGridInfo info, int row, int col, const QRect &rect, QPainter painter)
virtual QRect	contentRect (QicsGrid , int, int, const QicsDataItem , QRect &rect, QPainter *)
bool	isActiveLook () const
void	setActiveLook (bool on)
Static Public Member Functions
static bool	defaultActiveLook ()
static void	setDefaultActiveLook (bool on)
Static Public Attributes
static const QString	BasicCellDisplayName
static const int	QicsLAST_ROW = INT_MAX-1
static const int	QicsLAST_COLUMN = INT_MAX-1
Protected Member Functions
void	setWidget (QWidget *displayWidget)
virtual void	drawBackground (QicsGridInfo info, int row, int col, const QRect &rect, const QPalette &pal, QPainter painter, bool is_current=false, bool is_selected=false)
virtual void	drawBorder (QicsGridInfo info, int row, int col, const QRect &rect, const QPalette &pal, QPainter painter, bool is_current=false, bool is_selected=false)
virtual bool	isCellSelected (QicsGridInfo *info, int row, int col)
virtual QPalette &	cellPalette (bool enabled, bool for_printer=false)
virtual QRect	displayableCellArea (QicsGridInfo *ginfo, int row, int col, const QRect &cr_full, bool consider_margin=true, bool consider_border=true) const
virtual QString	textToDisplay (QicsGridInfo info, int row, int col, const QicsDataItem itm) const
virtual QPixmap	pixmapToDisplay (QicsGridInfo info, int row, int col, const QicsDataItem itm) const
void	commonInit (QicsGrid grid, int row, int col, const QicsDataItem itm, QRect &rect, QPainter painter, QWidget wdg, bool draw_bg, bool consider_frame)
Protected Attributes
QWidget *	myWidget
QObjectCleanupHandler *	objectCleanupHandler
QPointer< QicsCell >	myCell
QPointer< QicsCell >	myEditCell
QPointer< QicsRow >	myRow
QPointer< QicsColumn >	myColumn
QPointer< QicsMainGrid >	myGrid
QPointer< QStyle >	myStyle
bool	myIsEditing
bool	myActiveLook
bool	mySpanned
Qt::FocusReason	myLastFocusReason
Static Protected Attributes
static bool	active_look
static bool	for_printer
static bool	is_enabled
static bool	is_current
static bool	is_selected
static QicsGridInfo *	ginfo
static QStyle::State	style_flags
static QPalette	pal
static QRect	cr
static QColor	fg
static QColor	bg
static QStyle *	the_style
static QString	qs

QicsTable Documentation Set

QicsWidgetCellDisplay Class Reference

Public Types

Public Member Functions

Static Public Member Functions

Static Public Attributes

Protected Member Functions

Protected Attributes

Static Protected Attributes

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation