Symbian
Symbian OS Library

SYMBIAN OS V9.3

[Index] [Spacer] [Previous] [Next]



Location: GRDSTD.H
Link against: grid.lib

Class CGridLay

class CGridLay : public CBase;

Description

Handles the layout of a grid, and controls how columns, rows and selections appear.

Derivation

Members

Defined in CGridLay:
CGridLay(), CellToPoint(), CellToPoint(), CellToRect(), ClearAllHardPageBreaksL(), ClearHardColumnPageBreakL(), ClearHardRowPageBreakL(), ClearPagination(), ColumnExtent(), ColumnToXVal(), ColumnToXVal(), ColumnWidthInTwips(), ColumnWidthOfSelectedInTwips(), ConstructL(), ConstructL(), ConstructL(), DefaultColumnWidthInTwips(), DefaultRowHeightInTwips(), EAdjustGridRange, EDownThenRight, EFixGridRange, ERightThenDown, ExposeCell(), ExposeCellToTopLeft(), ExternalizeL(), GridColors(), GridRange(), HasChanged(), InsertDeleteColumns(), InsertDeleteRows(), InternalizeL(), IsAutoClearGridCells(), IsAutoPagination(), IsColumnBursting(), IsColumnSelectionDisabled(), IsCursorVisible(), IsEncroachingCellBorders(), IsGridLabelSeparators(), IsHardColumnPageBreak(), IsHardRowPageBreak(), IsHighlightVisible(), IsHorizontalGridLines(), IsHorizontalTitleLine(), IsIndefiniteRowBoundaries(), IsPageBreakLinesHidden(), IsPaginated(), IsPrintedGridLines(), IsPrintedLabels(), IsRowPermanentlySelected(), IsRowSelectionDisabled(), IsSideLabelDragDisabled(), IsSideLabels(), IsTitleLines(), IsTopLabelDragDisabled(), IsTopLabels(), IsUniformColumnWidth(), IsUniformRowHeight(), IsVerticalGridLines(), IsVerticalTitleLine(), MinColumnWidthInPixels(), MinRowHeightInPixels(), MinVisibleFromColumn(), MinVisibleFromRow(), NoOfPages(), NotifyPaginationOutOfDateL(), PageScroll(), PageSizeInTwips(), PageToRange(), PaginateL(), PointToCell(), PointToCell(), RecalcPixelSparseMaps(), ResetVisibleToCell(), ResetVisibleToColumn(), ResetVisibleToRow(), RestoreL(), RowExtent(), RowHeightInTwips(), RowHeightOfSelectedInTwips(), RowToYVal(), RowToYVal(), SetAutoClearGridCells(), SetAutoPagination(), SetColumnBursting(), SetColumnSelectionDisabled(), SetColumnWidthInTwipsL(), SetColumnWidthInTwipsL(), SetColumnWidthOfSelectedInTwipsL(), SetColumnWidthsToDefault(), SetCursorVisible(), SetDefaultColumnWidthInTwips(), SetDefaultRowHeightInTwips(), SetEncroachingCellBorders(), SetGraphicsDeviceMap(), SetGridColors(), SetGridEdgeColor(), SetGridImgL(), SetGridLabelSeparators(), SetGridTable(), SetGridToDefault(), SetHardColumnPageBreakL(), SetHardRowPageBreakL(), SetHasChanged(), SetHighlightVisible(), SetHorizontalGridLines(), SetMinColumnWidthInPixels(), SetMinRowHeightInPixels(), SetPageBreakLinesHidden(), SetPageSizeInTwipsL(), SetPrintRange(), SetPrintedGridLines(), SetPrintedLabels(), SetRowHeightInTwipsL(), SetRowHeightInTwipsL(), SetRowHeightOfSelectedInTwipsL(), SetRowHeightsToDefault(), SetRowPermanentlySelectedL(), SetRowSelectionDisabled(), SetSideLabelDragDisabled(), SetSideLabels(), SetTitleLinesL(), SetTitleLinesL(), SetTopLabelDragDisabled(), SetTopLabels(), SetUniformColumnWidth(), SetUniformRowHeight(), SetVerticalGridLines(), SetVisibleRange(), StoreL(), TFixGridRange, TPageOrder, TitleCellToPoint(), TitleColumnToXVal(), TitleRange(), TitleRowToYVal(), ToggleTitleLinesL(), TopLeftTitleRangeSize(), VisibleColumnToXVal(), VisibleRange(), VisibleRowToYVal(), XValToColumn(), XValToColumn(), XValToNearestColumn(), XValToTitleColumn(), YValToNearestRow(), YValToRow(), YValToRow(), YValToTitleRow(), ~CGridLay()

Inherited from CBase:
Delete(), Extension_(), operator new()


Construction and destruction


CGridLay()

IMPORT_C CGridLay(MGraphicsDeviceMap *aGraphicsDeviceMap);

Description

Constructor taking an object that implements mapping between twips and device-specific units.

Parameters

MGraphicsDeviceMap *aGraphicsDeviceMap

An object that implements the interface for mapping between twips and device-specific units. Typically, this is a TZoomFactor object.


ConstructL()

IMPORT_C void ConstructL(CGridLay *aGridLay, CGridImg *aGridImg);

Description

A second-phase constructor, taking an existing grid layout object, that constructs a partial layout object for printing.

The function assumes that the zoom factor has already been set.

Parameters

CGridLay *aGridLay

Pointer to an existing grid layout object.

CGridImg *aGridImg

Pointer to an existing grid image object.


ConstructL()

IMPORT_C void ConstructL(const MGridTable *aGridTable, CGridImg *aGridImg, TInt aNoOfRows, TInt aNoOfCols);

Description

A second-phase constructor for constructing the object with definite row boundaries.

Parameters

const MGridTable *aGridTable

A pointer to the grid table.

CGridImg *aGridImg

Pointer to a grid image object.

TInt aNoOfRows

The number of rows in the grid.

TInt aNoOfCols

The number of columns in the grid.


ConstructL()

IMPORT_C void ConstructL(const MGridTable *aGridTable, CGridImg *aGridImg, TInt aNoOfCols);

Description

A second-phase constructor for constructing the object with indefinite row boundaries.

Parameters

const MGridTable *aGridTable

A pointer to the grid table.

CGridImg *aGridImg

Pointer to a grid image object.

TInt aNoOfCols

The number of columns in the grid.


~CGridLay()

virtual IMPORT_C ~CGridLay();

Description

Destructor.

Frees resources prior to destruction of the object.

[Top]


Member functions


PageScroll()

IMPORT_C TPoint PageScroll(TMoveDirectionAndAmount aPageScroll);

Description

Scrolls the grid by one page.

Parameters

TMoveDirectionAndAmount aPageScroll

The direction and amount by which to scroll.

Return value

TPoint

The number of pixels scrolled, in the x and y directions. This represents the amount of scrolling required to move from the start of the old visible range to the start of the new visible range.


ExposeCell()

IMPORT_C TPoint ExposeCell(const TCellRef &aCell);

Description

Scrolls the grid by the minimum necessary to allow the specified cell to become visible.

Parameters

const TCellRef &aCell

The cell to be made visible.

Return value

TPoint

The number of pixels scrolled, in the x and y directions.


ExposeCellToTopLeft()

IMPORT_C TPoint ExposeCellToTopLeft(const TCellRef &aCell);

Description

Scrolls the grid by the minimum necessary so that the specified cell is in the top left corner of the visible grid.

Parameters

const TCellRef &aCell

The cell to be made visible in the top left corner of the visible grid.

Return value

TPoint

The number of pixels scrolled, in the x and y directions.


SetGridImgL()

IMPORT_C void SetGridImgL(CGridImg *aGridImg);

Description

Sets the specified grid image object.

Parameters

CGridImg *aGridImg

The grid image object that draws the contents of the grid.


SetGridTable()

inline void SetGridTable(const MGridTable *aGridTable);

Description

Sets the specified grid table object.

Parameters

const MGridTable *aGridTable

The grid table object.


VisibleRange()

inline TRangeRef VisibleRange() const;

Description

Gets the range of cells that are currently visible.

Return value

TRangeRef

The visible cell range. Note that the TRangeRef::iFrom member is the cell that is visible at the top of the window, and the TRangeRef::iTo member is the cell that is partially visible at the bottom right of the window.


SetVisibleRange()

IMPORT_C void SetVisibleRange(const TCellRef &aTopLeftCell);

Description

Scrolls the grid so that the specified cell is visible in the top left corner of the grid.

Parameters

const TCellRef &aTopLeftCell

The cell to be made visible in the top left corner of the visible grid.


TitleRange()

inline TRangeRef TitleRange() const;

Description

Gets the range of cells that form the grid titles.

Return value

TRangeRef

The range of cells that form the grid titles.


GridRange()

inline TRangeRef GridRange() const;

Description

Gets the range of cells that defines the grid boundary.

Return value

TRangeRef

The range of cells that defines the grid boundary.


SetGraphicsDeviceMap()

IMPORT_C void SetGraphicsDeviceMap(MGraphicsDeviceMap *aGraphicsDeviceMap);

Description

Sets the graphics device map to be used.

Parameters

MGraphicsDeviceMap *aGraphicsDeviceMap

The graphics device map: an interface for mapping between twips and device-specific units.


SetGridToDefault()

IMPORT_C void SetGridToDefault();

Description

Resets the grid to its default layout.


ColumnWidthInTwips()

IMPORT_C TInt ColumnWidthInTwips(TInt aCol) const;

Description

Gets the width of the specified column.

Parameters

TInt aCol

The column number.

Return value

TInt

The width of the column, in twips.


SetColumnWidthInTwipsL()

IMPORT_C void SetColumnWidthInTwipsL(TInt aCol, TInt aWidthInTwips);

Description

Sets the width of the specified column.

Note that the width cannot be set smaller than the minimum defined column width.

Parameters

TInt aCol

The number of the column whose width is to be set.

TInt aWidthInTwips

The width of the column, in twips.

Panic codes

GRIDIMG

9 In debug mode, if no MGraphicsDeviceMap object has been set.

See also:


SetColumnWidthInTwipsL()

IMPORT_C TInt SetColumnWidthInTwipsL(TInt aStartCol, TInt aEndCol, TInt aWidthInTwips);

Description

Sets the widths of all specified columns to the specified value.

Parameters

TInt aStartCol

The first column whose width is to be set.

TInt aEndCol

The last column whose width is to be set.

TInt aWidthInTwips

The width of the columns, in twips. Note that if the specified columns span the whole grid, then the function sets this value as the default width of all columns through a call to SetDefaultColumnWidthInTwips().

Return value

TInt

KErrNone if successful; KErrTooBig if the difference between the two column numbers is greater than EMaxArrayChanges.


DefaultColumnWidthInTwips()

IMPORT_C TInt DefaultColumnWidthInTwips() const;

Description

Gets the default width of columns.

Return value

TInt

The default width of columns, in twips.


SetDefaultColumnWidthInTwips()

IMPORT_C void SetDefaultColumnWidthInTwips(TInt aWidthInTwips);

Description

Sets the column width default value.

Note that the width cannot be set smaller than the minimum defined column width.

Parameters

TInt aWidthInTwips

The width of columns, in twips.

See also:


SetColumnWidthsToDefault()

IMPORT_C void SetColumnWidthsToDefault();

Description

Sets the widths of all columns to the default value.

See also:


MinColumnWidthInPixels()

IMPORT_C TInt MinColumnWidthInPixels() const;

Description

Gets the minimum width of columns.

Return value

TInt

The minimum width of columns, in pixels.


SetMinColumnWidthInPixels()

IMPORT_C void SetMinColumnWidthInPixels(TInt aWidthInPixels);

Description

Sets the minimum width of columns.

Parameters

TInt aWidthInPixels

The minimum width of columns, in pixels.


ColumnWidthOfSelectedInTwips()

IMPORT_C TInt ColumnWidthOfSelectedInTwips() const;

Description

Gets the width of columns in the selected region.

Return value

TInt

The column width, in twips, if all columns in the selected region have the same width; -1, otherwise.

Panic codes

GRIDIMG

3 If this grid layout object has no grid image object.


SetColumnWidthOfSelectedInTwipsL()

IMPORT_C void SetColumnWidthOfSelectedInTwipsL(TInt aWidthInTwips);

Description

Sets the widths of all columns in the selected region to the specified value.

Parameters

TInt aWidthInTwips

The column width, in twips.

Panic codes

GRIDIMG

3 If this grid layout object has no grid image object.


RowHeightInTwips()

IMPORT_C TInt RowHeightInTwips(TInt aRow) const;

Description

Gets the height of the specified row.

Parameters

TInt aRow

The row number.

Return value

TInt

The height of the row, in twips.


SetRowHeightInTwipsL()

IMPORT_C void SetRowHeightInTwipsL(TInt aRow, TInt aHeightInTwips);

Description

Sets the height of the specified row.

Note that the height cannot be set smaller than the minimum defined row height.

Parameters

TInt aRow

The number of row whose height is to be set.

TInt aHeightInTwips

The height of the row, in twips.

See also:


SetRowHeightInTwipsL()

IMPORT_C TInt SetRowHeightInTwipsL(TInt aStartRow, TInt aEndRow, TInt aHeightInTwips);

Description

Sets the heights of all specified rows to the specified value.

Parameters

TInt aStartRow

The first row whose height is to be set.

TInt aEndRow

The last row whose height is to be set.

TInt aHeightInTwips

The height of the rows, in twips. Note that if the specified rows span the whole grid, then the function sets this value as the default height of all rows through a call to SetDefaultRowHeightInTwips().

Return value

TInt

KErrNone if successful; KErrTooBig if the difference between the two row numbers is greater than EMaxArrayChanges.


DefaultRowHeightInTwips()

IMPORT_C TInt DefaultRowHeightInTwips() const;

Description

Gets the default height of rows.

Return value

TInt

The default height of rows, in twips,


SetDefaultRowHeightInTwips()

IMPORT_C void SetDefaultRowHeightInTwips(TInt aHeightInTwips);

Description

Sets the default height of rows.

Note that the height cannot be set smaller than the minimum defined row height.

Parameters

TInt aHeightInTwips

The height of rows, in twips.

See also:


SetRowHeightsToDefault()

IMPORT_C void SetRowHeightsToDefault();

Description

Sets the heights of all rows to the default value.

See also:


MinRowHeightInPixels()

IMPORT_C TInt MinRowHeightInPixels() const;

Description

Gets the minimum height of rows.

Return value

TInt

The minimum height of rows, in pixels.


SetMinRowHeightInPixels()

IMPORT_C void SetMinRowHeightInPixels(TInt aHeightInPixels);

Description

Sets the minimum height of rows.

Parameters

TInt aHeightInPixels

The minimum height of rows, in pixels.


RowHeightOfSelectedInTwips()

IMPORT_C TInt RowHeightOfSelectedInTwips() const;

Description

Gets the height of rows in the selected region.

Return value

TInt

The row height, in twips, if all rows in the selected region have the same width; -1, otherwise.

Panic codes

GRIDIMG

3 If this grid layout object has no grid image object.


SetRowHeightOfSelectedInTwipsL()

IMPORT_C void SetRowHeightOfSelectedInTwipsL(TInt aHeightInTwips);

Description

Sets the heights of all rows in the selected region to the specified value.

Parameters

TInt aHeightInTwips

The row height, in twips.

Panic codes

GRIDIMG

3 If this grid layout object has no grid image object.


RecalcPixelSparseMaps()

IMPORT_C void RecalcPixelSparseMaps();

Description

Recalculates the internal maps that map row and column numbers to heights and widths respectively.

Heights and widths are held as both pixel and twip values.


InsertDeleteColumns()

IMPORT_C void InsertDeleteColumns(TInt aStartCol, TInt aNoOfCols, TFixGridRange aFixGridRange=EFixGridRange);

Description

Inserts or deletes columns.

Insertion causes columns to be inserted in front of the specified start column. Deletion causes columns in front of the specified columns to be deleted.

Parameters

TInt aStartCol

The start column.

TInt aNoOfCols

The number of columns to be inserted or deleted. A positive number means that columns are to be inserted; a negative number means that columns are to be deleted.

TFixGridRange aFixGridRange

Indicates whether the grid boundary is to be adjusted by the number of columns (increased or decreased).


InsertDeleteRows()

IMPORT_C void InsertDeleteRows(TInt aStartRow, TInt aNoOfRows, TFixGridRange aFixGridRange=EFixGridRange);

Description

Inserts or deletes rows.

Insertion causes rows to be inserted below the specified start row. Deletion causes rows below the specified row to be deleted.

Parameters

TInt aStartRow

The start row.

TInt aNoOfRows

The number of rows to be inserted or deleted. A positive number means that rows are to be inserted; a negative number means that rows are to be deleted.

TFixGridRange aFixGridRange

Indicates whether the grid boundary is to be adjusted by the number of rows (increased or decreased).


IsSideLabels()

inline TBool IsSideLabels() const;

Description

Tests whether side grid labels are printed.

Return value

TBool

True, if the side labels are printed; false, otherwise.


SetSideLabels()

IMPORT_C void SetSideLabels(TBool aState);

Description

Sets whether side labels are printed.

Parameters

TBool aState

ETrue, if side labels are printed; EFalse, otherwise.


IsTopLabels()

inline TBool IsTopLabels() const;

Description

Tests whether top labels are printed.

Return value

TBool

True, if the top labels are printed; false, otherwise.


SetTopLabels()

IMPORT_C void SetTopLabels(TBool aState);

Description

Sets whether top labels are printed.

Parameters

TBool aState

ETrue, if top labels are printed; EFalse, otherwise.


IsVerticalGridLines()

inline TBool IsVerticalGridLines() const;

Description

Tests whether vertical grid lines are to be drawn.

Return value

TBool

True, if vertical grid lines are to be drawn; false, otherwise.


SetVerticalGridLines()

IMPORT_C void SetVerticalGridLines(TBool aState);

Description

Sets whether vertical grid lines are to be drawn.

Parameters

TBool aState

ETrue, if vertical grid lines are to be drawn; EFalse, otherwise.


IsHorizontalGridLines()

inline TBool IsHorizontalGridLines() const;

Description

Tests whether horizontal grid lines are to be drawn.

Return value

TBool

True, if horizontal grid lines are to be drawn; false, otherwise.


SetHorizontalGridLines()

IMPORT_C void SetHorizontalGridLines(TBool aState);

Description

Sets whether horizontal grid lines are to be drawn.

Parameters

TBool aState

ETrue, if horizontal grid lines are to be drawn; EFalse, otherwise.


IsGridLabelSeparators()

inline TBool IsGridLabelSeparators() const;

Description

Tests whether label separators are to be drawn.

Return value

TBool

True, if label separators are to be drawn; false, otherwise.


SetGridLabelSeparators()

IMPORT_C void SetGridLabelSeparators(TBool aState);

Description

Sets whether label separators are to be drawn.

Parameters

TBool aState

ETrue, if label separators are to be drawn; EFalse, otherwise.


IsColumnBursting()

inline TBool IsColumnBursting() const;

Description

Tests whether column bursting is permitted.

Column bursting occurs when the contents of a cell are too wide; adjacent cells are then overwritten, provided they are empty.

Return value

TBool

True, if column bursting is permitted; false, otherwise.


SetColumnBursting()

IMPORT_C void SetColumnBursting(TBool aState);

Description

Sets whether column bursting is to be permitted.

Column bursting occurs when the contents of a cell are too wide; adjacent cells are then overwritten, provided they are empty.

Parameters

TBool aState

ETrue, if column bursting is to be permitted; EFalse, otherwise.


IsCursorVisible()

inline TBool IsCursorVisible() const;

Description

Tests whether the cursor is visible.

Return value

TBool

True, if the cursor is visible; false, otherwise.


SetCursorVisible()

IMPORT_C void SetCursorVisible(TBool aVisible);

Description

Sets whether the cursor is to be visible.

Parameters

TBool aVisible

ETrue, if the cursor is to be visible; EFalse, otherwise.


IsHighlightVisible()

inline TBool IsHighlightVisible() const;

Description

Tests whether selected cells are highlighted.

Return value

TBool

True, if selected cells are highlighted; false, otherwise.


SetHighlightVisible()

IMPORT_C void SetHighlightVisible(TBool aVisible);

Description

Sets whether selected cells are to be highlighted.

Parameters

TBool aVisible

ETrue, if selected cells are to be highlighted; EFalse, otherwise.


IsRowPermanentlySelected()

inline TBool IsRowPermanentlySelected() const;

Description

Tests whether rows are permanently selected.

Return value

TBool

True, if rows are permanently selected; false, otherwise.


SetRowPermanentlySelectedL()

IMPORT_C void SetRowPermanentlySelectedL(TBool aState);

Description

Sets whether rows are to be permanently selected.

! Bit naughty

Parameters

TBool aState

ETrue, if rows are to be permanently selected; EFalse, otherwise.


IsTitleLines()

inline TBool IsTitleLines() const;

Description

Tests whether the grid has both horizontal and vertical title lines.

Return value

TBool

True, if the grid has both a horizontal and vertical title line; false, otherwise.


IsHorizontalTitleLine()

inline TBool IsHorizontalTitleLine() const;

Description

Tests whether the grid has a horizontal title line.

Return value

TBool

True, if the grid is to have a horizontal title line; false otherwise.


IsVerticalTitleLine()

inline TBool IsVerticalTitleLine() const;

Description

Tests whether the grid has a vertical title line.

Return value

TBool

True, if the grid is to have a vertical title line; false otherwise.


SetTitleLinesL()

IMPORT_C void SetTitleLinesL(TBool aState);

Description

Sets whether the grid is to have both horizontal and vertical title lines.

Parameters

TBool aState

ETrue, if the grid is to have both a horizontal and vertical title line; EFalse, otherwise.


SetTitleLinesL()

IMPORT_C void SetTitleLinesL(const TCellRef &aCellRef);

Description

Sets horizontal and vertical title lines at the specified cell.

Parameters

const TCellRef &aCellRef

The cell reference at which title lines are set.

Panic codes

GRIDIMG

3 If this grid layout object has no grid image object.


ToggleTitleLinesL()

IMPORT_C void ToggleTitleLinesL();

Description

Sets title lines on, if they are off; sets title lines off, if they are on.


IsIndefiniteRowBoundaries()

inline TBool IsIndefiniteRowBoundaries() const;

Description

Tests whether the grid has indefinite row boundaries.

Return value

TBool

True, if the grid has indefinite row boundaries; false, otherwise.


IsUniformRowHeight()

inline TBool IsUniformRowHeight() const;

Description

Tests whether all the rows have the same height.

Return value

TBool

True, if all rows have the same height; false, otherwise.


SetUniformRowHeight()

IMPORT_C void SetUniformRowHeight(TBool aState);

Description

Sets whether all rows are to have the same height.

Parameters

TBool aState

ETrue, if all rows are to have the same height; EFalse, otherwise.


IsUniformColumnWidth()

inline TBool IsUniformColumnWidth() const;

Description

Tests whether all columns have the same width.

Return value

TBool

True, if all columns have the same width; false, otherwise.


SetUniformColumnWidth()

IMPORT_C void SetUniformColumnWidth(TBool aState);

Description

Sets whether all columns are to have the same width.

Parameters

TBool aState

ETrue, if all columns are to have the same width; EFalse, otherwise.


IsTopLabelDragDisabled()

inline TBool IsTopLabelDragDisabled() const;

Description

Tests whether a drag operation on the boundary between two columns is permitted.

Return value

TBool

True, if a drag operation on a column boundary is permitted; false otherwise.


SetTopLabelDragDisabled()

IMPORT_C void SetTopLabelDragDisabled(TBool aState);

Description

Sets whether a drag operation on the boundary between two columns is to be permitted.

Parameters

TBool aState

ETrue, if the drag operation is to be permitted; EFalse, otherwise.


IsSideLabelDragDisabled()

inline TBool IsSideLabelDragDisabled() const;

Description

Tests whether a drag operation on the boundary between two rows is permitted.

Return value

TBool

True, if a drag operation on a row boundary is permitted; false otherwise.


SetSideLabelDragDisabled()

IMPORT_C void SetSideLabelDragDisabled(TBool aState);

Description

Sets whether a drag operation on the boundary between two rows is to be permitted.

Parameters

TBool aState

ETrue, if the drag operation is to be permitted; EFalse, otherwise.


IsPrintedLabels()

inline TBool IsPrintedLabels() const;

Description

Tests whether labels are printed.

Return value

TBool

True, if labels are printed; false, otherwise.


SetPrintedLabels()

IMPORT_C void SetPrintedLabels(TBool aState);

Description

Sets whether labels are printed.

Parameters

TBool aState

ETrue if labels are printed; EFalse, otherwise.


IsPrintedGridLines()

inline TBool IsPrintedGridLines() const;

Description

Tests whether grid lines are printed.

Return value

TBool

True, if grid lines are printed; false, otherwise.


SetPrintedGridLines()

IMPORT_C void SetPrintedGridLines(TBool aState);

Description

Sets whether grid lines are printed.

Parameters

TBool aState

ETrue if grid lines are printed; EFalse, otherwise.


IsEncroachingCellBorders()

inline TBool IsEncroachingCellBorders() const;

Description

Tests whether encroaching cell borders are permitted.

Encroaching cell borders are where cell borders wider than one pixel are drawn inside the cell, as opposed to outside.

Return value

TBool

True, if encroaching cells borders are permitted; false, otherwise.


SetEncroachingCellBorders()

IMPORT_C void SetEncroachingCellBorders(TBool aState);

Description

Sets whether encroaching cell borders are permitted.

Encroaching cell borders are where cell borders wider than one pixel are drawn inside the cell, as opposed to outside.

Parameters

TBool aState

ETrue, if encroaching cells borders are to be permitted; EFalse, otherwise.


IsRowSelectionDisabled()

inline TBool IsRowSelectionDisabled() const;

Description

Tests whether row selection is disabled.

Return value

TBool

True, if row selection is disabled; false, otherwise.


SetRowSelectionDisabled()

IMPORT_C void SetRowSelectionDisabled(TBool aState);

Description

Sets whether row selection is disabled.

Parameters

TBool aState

ETrue, if row selection is disabled; EFalse, otherwise.


IsColumnSelectionDisabled()

inline TBool IsColumnSelectionDisabled() const;

Description

Tests whether column selection is disabled.

Return value

TBool

True, if column selection is disabled; false, otherwise.


SetColumnSelectionDisabled()

IMPORT_C void SetColumnSelectionDisabled(TBool aState);

Description

Sets whether column selection is disabled.

Parameters

TBool aState

ETrue, if column selection is disabled; EFalse, otherwise.


IsAutoClearGridCells()

inline TBool IsAutoClearGridCells() const;

Description

Tests whether automatic clearing of grid cells is done.

Automatic clearing of grid cells is where all cells are cleared on redraw, in case drawing the contents doesn't guarantee to write to every pixel (the usual way of doing flicker-free redraws).

Return value

TBool

True, if automatic clearing of grid cells is done; false, otherwise.


SetAutoClearGridCells()

IMPORT_C void SetAutoClearGridCells(TBool aState);

Description

Sets whether automatic clearing of grid cells is to be done.

Parameters

TBool aState

ETrue, if automatic clearing of grid cells is to be done; EFalse, otherwise.


IsPageBreakLinesHidden()

inline TBool IsPageBreakLinesHidden() const;

Description

Tests whether lines marking page breaks are hidden.

Return value

TBool

True, if lines marking page breaks are hidden; false, otherwise.


SetPageBreakLinesHidden()

IMPORT_C void SetPageBreakLinesHidden(TBool aState);

Description

Sets whether lines marking page breaks are hidden.

Parameters

TBool aState

ETrue, if lines marking page breaks are hidden; EFalse, otherwise.


HasChanged()

inline TBool HasChanged() const;

Description

Tests whether any change has occurred to the grid layout.

Such changes include alterations to the height of a row or the width of a column, additions or deletions of rows or columns, and changes to the visibility of grid lines. Note that this list is not exhaustive.

Return value

TBool

True, if the grid layout has changed; false, otherwise.


SetHasChanged()

inline void SetHasChanged(TBool aHasChanged);

Description

Sets whether any change has occurred to the grid layout.

Parameters

TBool aHasChanged

ETrue, if any change has occurred to the grid layout; EFalse, otherwise.


SetGridEdgeColor()

inline void SetGridEdgeColor(TRgb aColor);

Description

Defines the colour that the edges of the grid beyond the grid range are to have.

If not changed by this function, the default colour is white.

Parameters

TRgb aColor

The colour value.


MinVisibleFromRow()

IMPORT_C TInt MinVisibleFromRow() const;

Description

Gets the number of the topmost row visible in the grid.

Return value

TInt

The row number.


MinVisibleFromColumn()

IMPORT_C TInt MinVisibleFromColumn() const;

Description

Gets the number of the leftmost column visible in the grid.

Return value

TInt

The column number.


ResetVisibleToRow()

IMPORT_C void ResetVisibleToRow();

Description

Resets the row number of the row that should be visible at the bottom of the visible area of the grid.


ResetVisibleToColumn()

IMPORT_C void ResetVisibleToColumn();

Description

Resets the column number of the column visible at the right of the visible area of the grid.


ResetVisibleToCell()

IMPORT_C void ResetVisibleToCell();

Description

Resets the row and column numbers visible at the bottom, and to the right, of the visible area of the grid.


RowExtent()

IMPORT_C TInt RowExtent() const;

Description

Gets the number of rows in the range.

Return value

TInt

The number of rows.


ColumnExtent()

IMPORT_C TInt ColumnExtent() const;

Description

Gets the number of columns in the range.