ICS

QicsTable Documentation Set

QicsTextCellDisplay Class Reference

A cell displayer for text and pixmaps. More...

#include <QicsTextCellDisplay.h>

Inherits QObject, and QicsMovableEntryWidgetCellDisplay.

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 }

Signals

void textEdited (int row, int col, const QString &str)

Public Member Functions

 QicsTextCellDisplay (QWidget *parent=0)
virtual void displayCell (QicsGrid *grid, int row, int col, const QicsDataItem *itm, QRect &rect, QPainter *painter)
virtual QRect contentRect (QicsGrid *grid, int row, int col, const QicsDataItem *itm, QRect &rect, QPainter *painter)
virtual void startEdit (QicsScreenGrid *, int row, int col, const QicsDataItem *itm)
virtual void moveEdit (QicsScreenGrid *grid, int row, int col, const QRect &rect)
virtual void endEdit (QicsScreenGrid *, int row, int col)
virtual bool editWhenCurrent (void) const
virtual void setEditWhenCurrent (bool yes)
virtual bool isEmpty (QicsGridInfo *info, int row, int col, const QicsDataItem *itm) const
virtual bool contentScrollEnabled (void) const
virtual void setContentScrollEnabled (bool yes)
bool iconShiftsText (void) const
void setIconShiftsText (bool yes)
virtual bool handleKeyEvent (QicsScreenGrid *grid, int row, int col, QKeyEvent *ke)
virtual QSize sizeHint (QicsGrid *grid, int row, int col, const QicsDataItem *itm)
virtual QString tooltipText (QicsGridInfo *info, int row, int col, const QicsDataItem *itm, const QRect &rect) const
virtual QString cellDisplayName () const
virtual QWidget * widget ()
virtual QDomElement toDomXml (QString tag, QDomDocument *doc)
virtual void configureFromDomXml (const QDomElement &e)
virtual QicsCellDisplayclone ()
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 needsVisibilityNotification (void) const
virtual QDomElement toDomXml (const QString &tag, QDomDocument *doc)
virtual void drawCellBorders (QicsGridInfo *info, int row, int col, const QRect &rect, QPainter *painter)
bool isActiveLook () const
void setActiveLook (bool on)
virtual void aboutToClear (QicsGridInfo *, int, int)

Static Public Member Functions

static bool defaultActiveLook ()
static void setDefaultActiveLook (bool on)

Static Public Attributes

static const QString TextCellDisplayName
static const QString BasicCellDisplayName
static const int QicsLAST_ROW = INT_MAX-1
static const int QicsLAST_COLUMN = INT_MAX-1

Protected Types

typedef QMap< QicsScreenGrid
*, QicsEntryWidgetInfo * > 
QicsEntryWidgetInfoPL

Protected Slots

void handleTextChanged (const QString &str)
void setLastFocusReason (Qt::FocusReason)

Protected Member Functions

QWidget * newEntryWidget (QicsScreenGrid *grid)
virtual bool canDisplayAll (QicsGridInfo *info, const QRect &rect, int row, int col, const QString &text, int text_flags, const QFont &font, const QPixmap &pix) const
virtual bool eventFilter (QObject *o, QEvent *e)
virtual bool setValue (QicsEntryWidgetInfo *info)
virtual void resetValue (QicsEntryWidgetInfo *info)
QicsEntryWidgetInfogetInfoFromGrid (QicsScreenGrid *grid)
QicsEntryWidgetInfogetInfoFromEntry (const QWidget *widget)
QicsEntryWidgetInfotakeInfoFromGrid (QicsScreenGrid *grid)
virtual QRect entryWidgetRect (QicsGridInfo *ginfo, int row, int col, QRect cell_rect)
void celldisplay_init ()
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

QEvent * myLastEvent
QicsTextCellDisplayWidget * myWidget
bool myEditWhenCurrent
bool myContentScrollEnabled
bool myIconShiftsText
QicsEntryWidgetInfoPL myEntryList
QPointer< QicsCellmyCell
QPointer< QicsCellmyEditCell
QPointer< QicsRowmyRow
QPointer< QicsColumnmyColumn
QPointer< QicsMainGridmyGrid
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 QicsGridInfoginfo
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 for text and pixmaps.

The text cell display object draws text and/or a pixmap for each cell that is it assigned to. It uses a QLineEdit widget for data entry.

QicsTextCellDisplay displays text and pixmaps, taking into consideration a number of cell and grid properties. These properties are:

See Customizing Table Display Using Cell Display Objects for more information on creating or modifying a cell display class.


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.

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.

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

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.

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.

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

QicsTextCellDisplay::QicsTextCellDisplay ( QWidget *  parent = 0  ) 

Constructor for use by programmers.


Member Function Documentation

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

Displays the cell (row, col ) in grid widget grid. The cell will be displayed in region rect, using painter.

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.
rect the rectangle to paint into
painter a painting context

Implements QicsCellDisplay.

virtual QRect QicsTextCellDisplay::contentRect ( QicsGrid ,
int  ,
int  ,
const QicsDataItem ,
QRect &  rect,
QPainter *   
) [virtual]

Returns the full rect of the content of the displayer.

Reimplemented from QicsCellDisplay.

virtual void QicsTextCellDisplay::startEdit ( QicsScreenGrid ,
int  ,
int  ,
const QicsDataItem  
) [virtual]

Begin an edit operation in cell (row, col ). This method is intended to be used as a "preparation" for an edit operation. It will be called by the grid in response to a user action or a programmatic call. Note that this method does not specify a location in the grid widget for the edit operation to take place. The location will be specified in a subsequent call to moveEdit().

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

Reimplemented from QicsCellDisplay.

virtual void QicsTextCellDisplay::moveEdit ( QicsScreenGrid grid,
int  row,
int  col,
const QRect &  rect 
) [virtual]

This method is called by the grid widget when the cell currently being edited has changed location in the grid. This would most commonly occur when the table is scrolled while an edit operation is underway.

Parameters:
grid the controlling grid
row the row in visual coordinates
col the column in visual coordinates
rect the new location of the cell

Reimplemented from QicsMovableEntryWidgetCellDisplay.

virtual void QicsTextCellDisplay::endEdit ( QicsScreenGrid ,
int  ,
int   
) [virtual]

This method is called by the grid widget when an edit operation of a cell should be ended. This would most commonly occur when the user traverses out of the cell via keyboard or mouse action.

Parameters:
grid the controlling grid
row the row in visual coordinates
col the column in visual coordinates

Reimplemented from QicsMovableEntryWidgetCellDisplay.

virtual bool QicsTextCellDisplay::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.

Reimplemented from QicsMovableEntryWidgetCellDisplay.

virtual bool QicsTextCellDisplay::isEmpty ( QicsGridInfo info,
int  row,
int  col,
const QicsDataItem itm 
) const [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.

bool QicsTextCellDisplay::iconShiftsText ( void   )  const [inline]

Returns state of text shifting when icon is present.

See also:
setIconShiftsText
Since:
2.3

void QicsTextCellDisplay::setIconShiftsText ( bool  yes  )  [inline]

Sets state of text shifting when icon is present to yes. If set, text will be shifted to the left if icon is present (default).

See also:
iconShiftsText
Since:
2.3

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

Handler for keyboard events that occur within cell (row, col ). This handler will forward key events to the text widget if the text widget is currently being used to edit cell (row, col ). Note that row and col are in visual coordinates.

Reimplemented from QicsCellDisplay.

virtual QSize QicsTextCellDisplay::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 QString QicsTextCellDisplay::tooltipText ( QicsGridInfo info,
int  row,
int  col,
const QicsDataItem itm,
const QRect &  rect 
) const [virtual]

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 from QicsCellDisplay.

virtual QString QicsTextCellDisplay::cellDisplayName (  )  const [virtual]

Returns displayer string name.

Reimplemented from QicsCellDisplay.

virtual QWidget* QicsTextCellDisplay::widget (  )  [virtual]

Returns widget that cell displayer uses.

Reimplemented from QicsCellDisplay.

virtual void QicsTextCellDisplay::configureFromDomXml ( const QDomElement &  e  )  [virtual]

Helper function. Restore displayer state from QDomElement.

Reimplemented from QicsCellDisplay.

void QicsTextCellDisplay::textEdited ( int  row,
int  col,
const QString &  str 
) [signal]

This signal is emitted whenever the text is edited. The str argument is the next text, row and col - row and column where text has been edited.

QWidget* QicsTextCellDisplay::newEntryWidget ( QicsScreenGrid grid  )  [protected, virtual]

Creates a new entry widget as a child of grid. When deriving from this class, you should implement this method so that it returns a new instance of the type of entry widget you want to use.

Implements QicsMovableEntryWidgetCellDisplay.

virtual bool QicsTextCellDisplay::canDisplayAll ( QicsGridInfo info,
const QRect &  rect,
int  row,
int  col,
const QString &  text,
int  text_flags,
const QFont &  font,
const QPixmap &  pix 
) const [protected, virtual]

Returns true if the pixmap (pix) and text (text, using text_flags and font) can be completely displayed in the area specified by rect.

Parameters:
info grid info object
rect area to display into
row row index in visual coordinates
col column index in visual coordinates
text text to display
text_flags flags for displaying text
font font to display text in
pix pixmap to display

virtual bool QicsTextCellDisplay::eventFilter ( QObject *  o,
QEvent *  e 
) [protected, virtual]

Event handler for the lineedit widget.

virtual bool QicsTextCellDisplay::setValue ( QicsEntryWidgetInfo info  )  [protected, virtual]

Attempts to retrieve text from the lineedit widget, validate it, convert the text to a QicsDataItem, and set the new value in the data model. Returns true if successful, false otherwise.

virtual void QicsTextCellDisplay::resetValue ( QicsEntryWidgetInfo info  )  [protected, virtual]

Resets the value in the lineedit widget to the value in the data model that is being displayed.

QicsEntryWidgetInfo* QicsMovableEntryWidgetCellDisplay::getInfoFromGrid ( QicsScreenGrid grid  )  [protected, inherited]

Returns the entry widget information for the specified grid widget.

QicsEntryWidgetInfo* QicsMovableEntryWidgetCellDisplay::getInfoFromEntry ( const QWidget *  widget  )  [protected, inherited]

Returns the entry widget information for the specified entry widget.

virtual QRect QicsMovableEntryWidgetCellDisplay::entryWidgetRect ( QicsGridInfo ginfo,
int  row,
int  col,
QRect  cell_rect 
) [protected, virtual, inherited]

Returns the rectangle which specifies the location and size for the entry widget to be placed.

Parameters:
ginfo grid info object
row the cell's row index
col the cell's column index
cell_rect the location and size of the cell to be edited

Reimplemented in QicsCheckCellDisplay, and QicsPushButtonCellDisplay.

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::needsVisibilityNotification ( void   )  const [inline, virtual, inherited]

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

Reimplemented in QicsWidgetCellDisplay.

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::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

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::aboutToClear ( QicsGridInfo ,
int  ,
int   
) [inline, virtual, inherited]

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

Since:
2.4

Reimplemented in QicsWidgetCellDisplay.

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:

All trademarks and copyrights on this page are properties of their respective owners.
The rest is copyright 1999-2007 Integrated Computer Solutions, Inc.