ICS

QicsTable Documentation Set

QicsComboCellDisplay Class Reference

A cell displayer for combo boxes. More...

#include <QicsComboCellDisplay.h>

Inherits QComboBox, and QicsMovableEntryWidgetCellDisplay.

List of all members.

Public Types

enum  QicsSortMode { QicsStableSort = 0, QicsQuickSort }
enum  QicsCellOverflowBehavior { Clip = 0, Overflow, ToolTip }
enum  QicsCurrentCellStyle { Spreadsheet = 0, NormalSelected }
enum  QicsGridCellClipping { AllowPartial = 0, NoDisplayOnPartial, UseClippedSymbol }
enum  QicsGridType { TableGrid = 0, RowHeaderGrid, ColumnHeaderGrid }
enum  QicsHeaderType { RowHeader = 0, ColumnHeader }
enum  QicsIndexType { RowIndex, ColumnIndex }
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, ScrollDown, ScrollLeft,
  ScrollRight, ScrollToRow, ScrollToColumn
}
enum  QicsSelectionPolicy {
  SelectNone = 0, SelectSingle, SelectMultiple, SelectSingleRow,
  SelectMultipleRow
}
enum  QicsSelectionType {
  SelectionNone = 0, SelectionBegin, SelectionDrag, SelectionEnd,
  SelectionExtend, SelectionAdd
}
enum  QicsSortOrder { Ascending = 0, Descending }
enum  QicsTableDisplayOption { DisplayNever = 0, DisplayAlways, DisplayFirstPage }
enum  QicsTraversalKeyEditBehavior { TraverseWithinCell = 0, TraverseBetweenCells }

Public Member Functions

 QicsComboCellDisplay (QWidget *=0)
void setCurrentIndex (int index)
void setCurrentText (const QString &)
void setEditable (bool)
virtual void displayCell (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 bool isEmpty (QicsGridInfo *, int, int, const QicsDataItem *) const
virtual QSize sizeHint (QicsGrid *grid, int row, int col, const QicsDataItem *itm)
virtual bool handleMouseEvent (QicsScreenGrid *grid, int row, int col, QMouseEvent *me)
virtual bool handleKeyEvent (QicsScreenGrid *, int, int, QKeyEvent *ke)
virtual void focusOutEvent (QFocusEvent *)
void endEdit (QicsScreenGrid *grid, int, int)
bool addValueToList (void) const
void setAddValueToList (bool set)
virtual void hideEdit (QicsScreenGrid *)
virtual bool editWhenCurrent (void) const
virtual bool needsVisibilityNotification (void) const
virtual QString tooltipText (QicsGridInfo *info, int row, int col, const QicsDataItem *itm, const QRect &rect) const

Protected Types

typedef QList< QicsEntryWidgetInfo * > QicsEntryWidgetInfoPL

Protected Slots

virtual void itemSelected (const QString &val)

Protected Member Functions

virtual QWidget * newEntryWidget (QicsScreenGrid *grid)
virtual QPalette cellPalette (QicsGridInfo *info, int row, int col, bool for_printer=false)
virtual void keyPressEvent (QKeyEvent *ke)
virtual bool eventFilter (QObject *obj, QEvent *event)
virtual QString textToDisplay (QicsGridInfo *ginfo, int row, int col, int model_row, int model_col, const QicsDataItem *itm) const
virtual void valueChanged (QicsGridInfo *info, int row, int col, int model_row, int model_col, const QString &val)
QicsEntryWidgetInfo * getInfoFromGrid (QicsScreenGrid *grid)
QicsEntryWidgetInfo * getInfoFromEntry (const QWidget *widget)
virtual QRect entryWidgetRect (QicsGridInfo *ginfo, int row, int col, QRect cell_rect)
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 QRect displayableCellArea (QicsGridInfo *ginfo, int row, int col, const QRect &cr_full, bool consider_margin=true, bool consider_border=true) const

Protected Attributes

bool myAddValueToList
QicsEntryWidgetInfoPL myEntryList
QPointer< QicsCellmyCell
QPointer< QicsRowmyRow
QPointer< QicsColumnmyColumn
QPointer< QicsMainGridmyGrid

Private Attributes

QWidget * myComboHolder
QComboBox * myFakeCombo
bool myRedirectEvent


Detailed Description

A cell displayer for combo boxes.

This class is incomplete. It needs methods, signals, etc to deal with notification, validation, and other such things.


Member Enumeration Documentation

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::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::QicsSortMode [inherited]
 

Denotes the sort algorithm which is used

  • QicsStableSort Used non distructive, stable sort algorithm
  • QicsQuickSort Default quick sort algorithm.

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.


Constructor & Destructor Documentation

QicsComboCellDisplay::QicsComboCellDisplay QWidget *  = 0  ) 
 

Constructor for use by programmers.


Member Function Documentation

bool QicsComboCellDisplay::addValueToList void   )  const
 

Returnss whether data values that are not in the combo box's list should be added to the list. If true, any value that this object attempts to display will be added to the combo box's list of choices, if it does not already appear in the list. If false, no values will be added to the list.

virtual QPalette QicsComboCellDisplay::cellPalette QicsGridInfo info,
int  row,
int  col,
bool  for_printer = false
[protected, virtual]
 

Returns the colorgroup to be used when drawing in cell (row, col ), using grid information from info. If for_printer is true, the colorgroup 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 color group be used to print?

Reimplemented from QicsCellDisplay.

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 void QicsComboCellDisplay::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 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 QicsMovableEntryWidgetCellDisplay::editWhenCurrent void   )  const [inline, virtual, inherited]
 

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.

Reimplemented in QicsTextCellDisplay.

void QicsComboCellDisplay::endEdit QicsScreenGrid grid,
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 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.

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

Returns the entry widget information for the specified entry widget.

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

Returns the entry widget information for the specified grid widget.

virtual bool QicsComboCellDisplay::handleKeyEvent QicsScreenGrid ,
int  ,
int  ,
QKeyEvent *  ke
[virtual]
 

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

virtual bool QicsComboCellDisplay::handleMouseEvent QicsScreenGrid grid,
int  row,
int  col,
QMouseEvent *  me
[virtual]
 

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

virtual void QicsMovableEntryWidgetCellDisplay::hideEdit QicsScreenGrid  )  [virtual, inherited]
 

This method is called by the grid widget when the cell currently being edited is no longer visible on the screen. (This would most commonly occur when the user scrolls the table.)

Parameters:
grid the controlling grid

Implements QicsCellDisplay.

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 bool QicsComboCellDisplay::isEmpty QicsGridInfo ,
int  ,
int  ,
const QicsDataItem
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 QicsComboCellDisplay::itemSelected const QString &  val  )  [protected, virtual, slot]
 

Called when an item is selected in the combo box

virtual void QicsComboCellDisplay::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 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 QWidget* QicsComboCellDisplay::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.

void QicsComboCellDisplay::setAddValueToList bool  set  ) 
 

Controls whether data values that are not in the combo box's list should be added to the list. If true, any value that this object attempts to display will be added to the combo box's list of choices, if it does not already appear in the list. If false, no values will be added to the list.

void QicsComboCellDisplay::setCurrentIndex int  index  ) 
 

Set the index of the current item in the combobox

void QicsComboCellDisplay::setCurrentText const QString &   ) 
 

Set the text of the current item in the combobox

void QicsComboCellDisplay::setEditable bool   ) 
 

holds whether the combobox can be edited by the user

virtual QSize QicsComboCellDisplay::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 void QicsComboCellDisplay::startEdit QicsScreenGrid ,
int  row,
int  col,
const QicsDataItem itm
[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.

Implements QicsCellDisplay.

virtual QString QicsComboCellDisplay::textToDisplay QicsGridInfo ginfo,
int  row,
int  col,
int  model_row,
int  model_col,
const QicsDataItem itm
const [protected, virtual]
 

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

This default method returns the string representation of the value in the QicsDataModel for this cell.

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

Parameters:
ginfo grid info object
row the visual row index of the cell
col the visual column index of the cell
model_row the model row index of the cell
model_col the model column index of the cell
itm the data item for this cell (this value may be 0)

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 void QicsComboCellDisplay::valueChanged QicsGridInfo info,
int  row,
int  col,
int  model_row,
int  model_col,
const QString &  val
[protected, virtual]
 

This method is called when the value in the combobox for cell (row, col ) is changed. The new combobox value is val.

This method is intended to be reimplemented by subclasses of QicsComboCellDisplay. The programmer should implement this method so that it performs the appropriate action(s). Possible actions could include setting a new value in the QicsDataModel or performing some other action based on the state of the combobox.

If you use this method to set a new value in the data model, it is generally preferrable to use QicsGridInfo::setCurrentCellValue() or QicsGridInfo::setCellValue(), as these methods will ensure that the valueChanged signal of QicsTable is emitted.

Parameters:
info grid info object
row the visual row index of the cell whose value changed
col the visual column index of the cell whose value changed
model_row the model row index of the cell whose value changed
model_col the model column index of the cell whose value changed
val the new state of the checkbox


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-2006 Integrated Computer Solutions, Inc.