#include <QicsCellDisplay.h>
Inherits QicsCellDisplay.
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 | |
| QicsNoWidgetCellDisplay () | |
| virtual | ~QicsNoWidgetCellDisplay () |
| virtual void | startEdit (QicsScreenGrid *, int row, int col, const QicsDataItem *) |
| virtual void | moveEdit (QicsScreenGrid *, int row, int col, const QRect &rect) |
| virtual void | endEdit (QicsScreenGrid *grid, int row, int col) |
| virtual bool | editWhenCurrent (void) const |
| virtual QicsCellDisplay * | clone () |
| virtual void | displayCell (QicsGrid *grid, int row, int col, const QicsDataItem *itm, QRect &rect, QPainter *painter)=0 |
| 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 QSize | sizeHint (QicsGrid *grid, int row, int col, const QicsDataItem *itm)=0 |
| virtual bool | needsVisibilityNotification (void) const |
| virtual bool | isEmpty (QicsGridInfo *info, int row, int col, const QicsDataItem *itm) const =0 |
| virtual QString | tooltipText (QicsGridInfo *info, int row, int col, const QicsDataItem *itm, const QRect &rect) const |
| virtual QWidget * | widget () |
| 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) |
| virtual void | aboutToClear (QicsGridInfo *, int, int) |
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 | |
| 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 | |
| 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 |
QicsNoWidgetCellDisplay is an abstract class that implements portions of the interface defined by QicsCellDisplay. QicsNoWidgetCellDisplay contains internal methods and data to help implement a cell display class that handles all aspects of the cell, including any editing and user interaction, as well as the actual drawing of cell contents.
See Customizing Table Display Using Cell Display Objects for more information on creating a cell display class.
enum Qics::QicsWideKeyAction [inherited] |
Denotes global key actions available for the table grid.
enum Qics::QicsBoxBorders [inherited] |
Denotes the box borders of cell region.
enum Qics::QicsCopyPolicy [inherited] |
Denotes the copying policy during copy/paste and drag/drop operations.
enum Qics::QicsClearPolicy [inherited] |
Denotes the clearing policy during cut and delete operations.
enum Qics::QicsSortMode [inherited] |
Denotes the sort algorithm which is used.
enum Qics::QicsCellOverflowBehavior [inherited] |
Denotes the behavior of grids when handling cells whose contents cannot be displayed in the boundaries of the cell.
enum Qics::QicsCurrentCellStyle [inherited] |
Denotes the visual style that the current cell of the table will be drawn with.
enum Qics::QicsSelectionStyle [inherited] |
enum Qics::QicsSelectCurrentCellPolicy [inherited] |
enum Qics::QicsGridCellClipping [inherited] |
Denotes the policy for displaying text that is too long to fit in its cell.
enum Qics::QicsGridType [inherited] |
Specifies a type of grid object.
enum Qics::QicsHeaderType [inherited] |
Specifies the type of table header.
enum Qics::QicsIndexType [inherited] |
Specifies the type of table index.
enum Qics::QicsLineStyle [inherited] |
Denotes the style of lines and borders in the table widget.
enum Qics::QicsRepaintBehavior [inherited] |
Specifies the recalculation and repainting behavior of tables and grids.
enum Qics::QicsScrollBarMode [inherited] |
enum Qics::QicsScrollDirection [inherited] |
Denotes a direction for scrolling operations, or that an absolute scroll should occur.
enum Qics::QicsSelectionPolicy [inherited] |
Denotes the selection policy for the table.
enum Qics::QicsSortOrder [inherited] |
Specifies whenever ordering should be ascending or descending.
enum Qics::QicsTableDisplayOption [inherited] |
Specifies a printing display policy for elements of the table.
enum Qics::QicsTraversalKeyEditBehavior [inherited] |
Specifies the behavior of the traversal keys. (left, right, up, down, etc) while editing a cell.
enum Qics::QicsCurrentCellDraggingPolicy [inherited] |
Specifies the behavior of drag&drop operations when it has began from current cell.
enum Qics::QicsCellWidthMode [inherited] |
Specifies the behavior of set cell font.
enum Qics::QicsCellDecorationStyle [inherited] |
Specifies the cell decoration style for headers.
enum Qics::QicsHeaderDragStyle [inherited] |
Specifies row/column drag style for headers.
enum Qics::QicsAutoFitMode [inherited] |
Specifies autofit modes.
| QicsNoWidgetCellDisplay::QicsNoWidgetCellDisplay | ( | ) |
Constructor for the abstract class. Should never be called by the programmer. This is intended only for use by subclass constructors.
| virtual QicsNoWidgetCellDisplay::~QicsNoWidgetCellDisplay | ( | ) | [virtual] |
Destructor for the class.
| virtual void QicsNoWidgetCellDisplay::startEdit | ( | QicsScreenGrid * | , | |
| int | row, | |||
| int | col, | |||
| const QicsDataItem * | ||||
| ) | [virtual] |
This method is a no-op in this abstract class.
Reimplemented from QicsCellDisplay.
| virtual void QicsNoWidgetCellDisplay::moveEdit | ( | QicsScreenGrid * | , | |
| int | row, | |||
| int | col, | |||
| const QRect & | rect | |||
| ) | [virtual] |
This method is a no-op in this abstract class.
Implements QicsCellDisplay.
| virtual void QicsNoWidgetCellDisplay::endEdit | ( | QicsScreenGrid * | grid, | |
| int | row, | |||
| int | col | |||
| ) | [virtual] |
This method is a no-op in this abstract class.
Reimplemented from QicsCellDisplay.
| virtual bool QicsNoWidgetCellDisplay::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 void QicsCellDisplay::displayCell | ( | QicsGrid * | grid, | |
| int | row, | |||
| int | col, | |||
| const QicsDataItem * | itm, | |||
| QRect & | rect, | |||
| QPainter * | painter | |||
| ) | [pure virtual, inherited] |
Displays the cell (row, col ) in grid widget grid. The cell will be displayed in region rect, using painter.
| 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 |
Implemented in QicsCheckCellDisplay, QicsComboCellDisplay, QicsDateTimeCellDisplay, QicsPushButtonCellDisplay, QicsTextCellDisplay, and QicsWidgetCellDisplay.
| 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).
| void QicsCellDisplay::setSpanned | ( | bool | span | ) | [inline, inherited] |
| 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.
| 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.
| 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 QSize QicsCellDisplay::sizeHint | ( | QicsGrid * | grid, | |
| int | row, | |||
| int | col, | |||
| const QicsDataItem * | itm | |||
| ) | [pure virtual, inherited] |
Returns the size that cell (row, col ) needs to be if it is to completely display itm.
| 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. |
Implemented in QicsCheckCellDisplay, QicsComboCellDisplay, QicsDateTimeCellDisplay, QicsPushButtonCellDisplay, QicsTextCellDisplay, and QicsWidgetCellDisplay.
| 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 bool QicsCellDisplay::isEmpty | ( | QicsGridInfo * | info, | |
| int | row, | |||
| int | col, | |||
| const QicsDataItem * | itm | |||
| ) | const [pure virtual, inherited] |
Returns true if the contents of cell (row, col ) (given data item itm ) are empty, false otherwise.
| 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 |
Implemented in QicsCheckCellDisplay, QicsComboCellDisplay, QicsDateTimeCellDisplay, QicsPushButtonCellDisplay, QicsTextCellDisplay, and QicsWidgetCellDisplay.
| 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.
| 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 QWidget* QicsCellDisplay::widget | ( | ) | [inline, virtual, inherited] |
Returns widget that cell displayer uses or '0' otherwise.
Reimplemented in QicsCheckCellDisplay, QicsComboCellDisplay, QicsDateTimeCellDisplay, QicsPushButtonCellDisplay, QicsTextCellDisplay, and QicsWidgetCellDisplay.
| 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.
| 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.
| 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.
| static bool QicsCellDisplay::defaultActiveLook | ( | ) | [inline, static, inherited] |
Returns the default active look state. If true, cells will not be drawn differently even if disabled.
| 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.
| 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.
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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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) |