CLbtGeoCell Class Reference

#include <mw/lbtgeocell.h>

Link against: lbt.lib

class CLbtGeoCell : public CLbtGeoAreaBase

Inherits from

CLbtGeoCell
- CLbtGeoAreaBase

Public Member Functions
virtual	~CLbtGeoCell()
virtual TBool	CGISpecifiedDuringCreation()
IMPORT_C TUint	CellId()
IMPORT_C TUint	LocationAreaCode()
IMPORT_C TNetworkCountryCode	NetworkCountryCode()
IMPORT_C TNetworkIdentity	NetworkIdentityCode()
IMPORT_C RMobilePhone::TMobilePhoneNetworkMode	NetworkType()
IMPORT_C CLbtGeoCell *	NewL()
IMPORT_C CLbtGeoCell *	NewL(RMobilePhone::TMobilePhoneNetworkMode, TNetworkCountryCode, TNetworkIdentity, TUint, TUint)
IMPORT_C CLbtGeoCell *	NewLC()
IMPORT_C CLbtGeoCell *	NewLC(RMobilePhone::TMobilePhoneNetworkMode, TNetworkCountryCode, TNetworkIdentity, TUint, TUint)
IMPORT_C void	SetCellId(TUint)
IMPORT_C void	SetLocationAreaCode(TUint)
IMPORT_C void	SetNetworkCountryCode(TNetworkCountryCode)
IMPORT_C void	SetNetworkIdentityCode(TNetworkIdentity)
IMPORT_C void	SetNetworkType(RMobilePhone::TMobilePhoneNetworkMode)
virtual TGeoAreaType	Type()
void	ValidateCellInformationL()
void	ValidateCreateCellInformationL()

Protected Member Functions
	CLbtGeoCell()
	CLbtGeoCell(const CLbtGeoCell &)
void	ConstructL()
void	ConstructL(RMobilePhone::TMobilePhoneNetworkMode, TNetworkCountryCode, TNetworkIdentity, TUint, TUint)
virtual void	DoExternalizeL(RWriteStream &)
virtual void	DoInternalizeL(RReadStream &)
CLbtGeoCell &	operator=(const CLbtGeoCell &)

Inherited Enumerations
	CLbtGeoAreaBase:TGeoAreaType

Inherited Functions
	CBase::CBase()
	CBase::Delete(CBase *)
	CBase::Extension_(TUint,TAny &,TAny )
	CBase::operator new(TUint)
	CBase::operator new(TUint,TAny *)
	CBase::operator new(TUint,TLeave)
	CBase::operator new(TUint,TLeave,TUint)
	CBase::operator new(TUint,TUint)
	CBase::~CBase()
	CLbtGeoAreaBase::CLbtGeoAreaBase()
	CLbtGeoAreaBase::ExternalizeL(RWriteStream &)const
	CLbtGeoAreaBase::InternalizeL(RReadStream &)
	CLbtGeoAreaBase::~CLbtGeoAreaBase()

Detailed Description

Geographical cellular area.

Geographical cellular area is defined by the area covered by a network cell. Client applications must specify complete CGI information of the serving cell while defining a geographical cellular area. This includes the Mobile Country Code (MCC), Mobile Network Code (MNC), Location Area Code (LAI) and the Cell Identity (CI). In addition client applications must also mention the the Network Type.

Since: S60 5.1

Gets the cell id. If the cell code has not been set before, the returned value is zero.

Returns: The cell id.

ConstructL ( )

void

ConstructL

(

)

[protected]

Symbian 2nd phase constructor.

ConstructL ( RMobilePhone::TMobilePhoneNetworkMode, TNetworkCountryCode, TNetworkIdentity, TUint, TUint )

void	ConstructL	(	RMobilePhone::TMobilePhoneNetworkMode	aNetworkType,
			TNetworkCountryCode	aCountryCode,
			TNetworkIdentity	aNetworkId,
			TUint	aLocationAreaCode,
			TUint	aCellId
		)	[protected]

Symbian 2nd phase constructor.

DoExternalizeL ( RWriteStream & )

void

DoExternalizeL

(

RWriteStream &

aStream

)

const [protected, virtual]

Reimplemented from CLbtGeoAreaBase::DoExternalizeL(RWriteStream &)const

Externalize method that subclass must implement.

Parameter	Description
aStream	Stream to which the object should be externalized.

DoInternalizeL ( RReadStream & )

void

DoInternalizeL

(

RReadStream &

aStream

)

[protected, virtual]

Reimplemented from CLbtGeoAreaBase::DoInternalizeL(RReadStream &)

Internalize method that subclass must implement.

Parameter	Description
aStream	Stream from which the object should be internalized.

LocationAreaCode ( )

IMPORT_C TUint

LocationAreaCode

(

)

const

Gets the location area code. If the location area code has not been set before, the returned value is zero.

Returns: The location area code.

NetworkCountryCode ( )

IMPORT_C TNetworkCountryCode

NetworkCountryCode

(

)

const

Gets the network country code. If the country code has not been set before, the returned value is zero.

Returns: The network country code.

NetworkIdentityCode ( )

IMPORT_C TNetworkIdentity

NetworkIdentityCode

(

)

const

Gets the network identity code. If the network identity code has not been set before, the returned value is zero.

Returns: The network identity code.

NetworkType ( )

IMPORT_C RMobilePhone::TMobilePhoneNetworkMode

NetworkType

(

)

const

Returns the type of network

Returns: The type of network. If the Network Type is not set earlier, this method would return RMobilePhone::ENetworkModeUnknown.

NewL ( )

IMPORT_C CLbtGeoCell *

NewL

(

)

[static]

Allocates and constructs a new geographical cellular area object. In the returned object,the country code,network code,location area code and cell id are set to zero.

leave: Other standard Symbian error code, such as KErrNoMemory

Returns: Pointer to the new geographical cellular area object.

NewL ( RMobilePhone::TMobilePhoneNetworkMode, TNetworkCountryCode, TNetworkIdentity, TUint, TUint )

IMPORT_C CLbtGeoCell *	NewL	(	RMobilePhone::TMobilePhoneNetworkMode	aNetworkType,
			TNetworkCountryCode	aCountryCode,
			TNetworkIdentity	aNetworkId,
			TUint	aLocationAreaCode,
			TUint	aCellId
		)	[static]

Allocates and constructs a new geographical cellular area object.

panic: ELbtErrArgument If inputs are negative or zero.

leave: Other standard Symbian error code, such as KErrNoMemory

Parameter	Description
aNetworkType	The network type
aCountryCode	The network country code
aNetworkId	The network identity code
aLocationAreaCode	The location area code
aCellId	The cell id

Returns: Pointer to the new geographical cellular area object.

NewLC ( )

IMPORT_C CLbtGeoCell *

NewLC

(

)

[static]

Allocates and constructs a new geographical cellular area object and pushes it onto cleanup stack. In the returned object,the country code,network code,location area code and cell id are set to zero.

leave: Other standard Symbian error code, such as KErrNoMemory

Returns: Pointer to the new geographical cellular area object.

NewLC ( RMobilePhone::TMobilePhoneNetworkMode, TNetworkCountryCode, TNetworkIdentity, TUint, TUint )

IMPORT_C CLbtGeoCell *	NewLC	(	RMobilePhone::TMobilePhoneNetworkMode	aNetworkType,
			TNetworkCountryCode	aCountryCode,
			TNetworkIdentity	aNetworkId,
			TUint	aLocationAreaCode,
			TUint	aCellId
		)	[static]

Allocates and constructs a new geographical cellular area object and pushes it onto cleanup stack.

panic: ELbtErrArgument If inputs are negative or zero.

leave: Other standard Symbian error code, such as KErrNoMemory

Parameter	Description
aNetworkType	The network type
aCountryCode	The network country code
aNetworkId	The network identity code
aLocationAreaCode	The location area code
aCellId	The cell id

Returns: Pointer to the new geographical cellular area object.

SetCellId ( TUint )

IMPORT_C void

SetCellId

(

TUint

aCellId

)

Sets the cell id.

Parameter	Description
aCellId	The cell id.

SetLocationAreaCode ( TUint )

IMPORT_C void

SetLocationAreaCode

(

TUint

aLocationAreaCode

)

Sets the location area code.

Parameter	Description
aLocationAreaCode	The location area code.

SetNetworkCountryCode ( TNetworkCountryCode )

IMPORT_C void

SetNetworkCountryCode

(

TNetworkCountryCode

aCountryCode

)

Sets the network country code.

panic: ELbtErrArgument If the input location area code is negative or zero.

Parameter	Description
aCountryCode	The network country code.

SetNetworkIdentityCode ( TNetworkIdentity )

IMPORT_C void

SetNetworkIdentityCode

(

TNetworkIdentity

aNetworkId

)

Sets the network identity code.

panic: ELbtErrArgument If the input location area code is negative or zero.

Parameter	Description
aNetworkId	The network identity code.

SetNetworkType ( RMobilePhone::TMobilePhoneNetworkMode )

IMPORT_C void

SetNetworkType

(

RMobilePhone::TMobilePhoneNetworkMode

aNetworkType

)

Sets the network type.

Parameter	Description
aNetworkType	The type of network

Type ( )

TGeoAreaType

Type

(

)

const [virtual]

Reimplemented from CLbtGeoAreaBase::Type()const

Returns the type of geographical area, CLbtGeoAreaBase::ECellular

Returns: CLbtGeoAreaBase::ECellular.

ValidateCellInformationL ( )

void

ValidateCellInformationL

(

)

Validates cell information.

leave: KErrArgument if any of the mandatory parameters have not been specified.

ValidateCreateCellInformationL ( )

void

ValidateCreateCellInformationL

(

)

Validates create cell information.

leave: KErrArgument if any of the mandatory parameters have not been specified.

operator= ( const CLbtGeoCell & )

CLbtGeoCell &

operator=

(

const CLbtGeoCell &

)

[protected]

Prohibit assigment operator