Symbian
Symbian OS Library

SYMBIAN OS V9.3

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



Location: BACELL.H
Link against: bafl.lib

Class TRangeRef

class TRangeRef;

Description

Identifies a range of cells by start and end cell references. The range is inclusive of both the start and end cells.

Members

Defined in TRangeRef:
Contains(), ExternalizeL(), InternalizeL(), NoCells(), NoCols(), NoRows(), SetRange(), SetRange(), TIter, TRangeRef(), TRangeRef(), TRangeRef(), iFrom, iTo, operator!=(), operator==()

See also:


Construction and destruction


TRangeRef()

inline TRangeRef();

Description

Default constructor.

The object's start cell and end cell are undefined.


TRangeRef()

inline TRangeRef(const TCellRef &aFrom, const TCellRef &aTo);

Description

Constructor taking a start and end cell.

Parameters

const TCellRef &aFrom

The start cell.

const TCellRef &aTo

The end cell.


TRangeRef()

inline TRangeRef(TInt aFromRow, TInt aFromCol, TInt aToRow, TInt aToCol);

Description

Constructor taking a start row and start column number, and an end row and end column number.

Parameters

TInt aFromRow

The start row number.

TInt aFromCol

The start column number.

TInt aToRow

The end row number.

TInt aToCol

The end column number.

[Top]


Member functions


operator==()

IMPORT_C TBool operator==(const TRangeRef &aRange) const;

Description

Compares this cell range with the specified cell range for equality.

Parameters

const TRangeRef &aRange

The cell range to be compared.

Return value

TBool

ETrue, if the start cells and the end cells are the same.


operator!=()

inline TBool operator!=(const TRangeRef &aRange) const;

Description

Compares this cell range with the specified cell range for inequality.

Parameters

const TRangeRef &aRange

The cell to be compared.

Return value

TBool

ETrue, if the start cells are different or the end cells are different.


SetRange()

inline void SetRange(const TCellRef &aFrom, const TCellRef &aTo);

Description

Sets the cell range to the specified cells.

Parameters

const TCellRef &aFrom

The start cell for the range.

const TCellRef &aTo

The end cell for the range.


SetRange()

inline void SetRange(TInt aFromRow, TInt aFromCol, TInt aToRow, TInt aToCol);

Description

Sets the cell range to the specified start row and column, and end row and column.

Parameters

TInt aFromRow

The start row number.

TInt aFromCol

The start column number.

TInt aToRow

The end row number.

TInt aToCol

The end column number.


NoRows()

inline TInt NoRows() const;

Description

Gets the number of rows represented by the range.

Return value

TInt

The number of rows.


NoCols()

inline TInt NoCols() const;

Description

Gets the number of columns represented by the range.

Return value

TInt

The number of columns.


NoCells()

IMPORT_C TInt NoCells() const;

Description

Gets the number of cells represented by the range.

Return value

TInt

The number of cells.


Contains()

IMPORT_C TBool Contains(const TCellRef &aCell) const;

Description

Tests whether the specified cell is contained within the range.

A range includes its outer perimeter.

Parameters

const TCellRef &aCell

The cell to be tested.

Return value

TBool

ETrue, if the specified cell is contained within the range; EFalse, otherwise.


InternalizeL()

IMPORT_C void InternalizeL(RReadStream &aStream);

Description

Internalises an object of this class from a read stream.

The presence of this function means that the standard templated operator>>() can be used to internalise objects of this class.

Note that the function has assignment semantics. It replaces the old value of the object with a new value read from the read stream.

Parameters

RReadStream &aStream

Stream from which the object is to be internalised.


ExternalizeL()

IMPORT_C void ExternalizeL(RWriteStream &aStream) const;

Description

Externalises an object of this class to a write stream.

The presence of this function means that the standard templated operator<<() can be used to externalise objects of this class.

Parameters

RWriteStream &aStream

Stream to which the object should be externalised.

[Top]


Member classes


Class TIter

class TIter;

Description

Members

Defined in TRangeRef::TIter:
InRange(), TIter(), iCurrent, operator++()

Construction and destruction


TIter()

IMPORT_C TIter(const TRangeRef &aRangeRef);

Description

Parameters

const TRangeRef &aRangeRef

Member functions


operator++()

IMPORT_C TBool operator++();

Description

Return value

TBool


InRange()

inline TBool InRange() const;

Description

Return value

TBool

Member data


iCurrent

TCellRef iCurrent;

Description

[Top]


Member data


iFrom

TCellRef iFrom;

Description

The start cell.


iTo

TCellRef iTo;

Description

The end cell.