Collapse all Symbian^3 Product Developer Library

CLbtGeoCell Class Reference

class CLbtGeoCell : public CLbtGeoAreaBase

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.

lbt.lib

Since: S60 5.1

Inherits from

CLbtGeoCell
- CLbtGeoAreaBase
  - CBase

Public Member Functions
	~CLbtGeoCell()
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)
TGeoAreaType	Type()
void	ValidateCellInformationL()
void	ValidateCreateCellInformationL()

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

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()

Inherited Enumerations
	CLbtGeoAreaBase:TGeoAreaType

Private Attributes
TUint	iCellId
TUint	iCountryCode
TUint	iLocationAreaCode
TUint	iNetworkId
RMobilePhone::TMobilePhoneNetworkMode	iNetworkType

Constructor & Destructor Documentation

CLbtGeoCell()

CLbtGeoCell

(

)

[protected]

default constructor

CLbtGeoCell(const CLbtGeoCell &)

CLbtGeoCell

(

const CLbtGeoCell &

)

[protected]

By default, prohibit copy constructor

Parameters

const CLbtGeoCell &

~CLbtGeoCell()

IMPORT_C

~CLbtGeoCell

(

)

[virtual]

Destructor

Member Functions Documentation

CGISpecifiedDuringCreation()

TBool

CGISpecifiedDuringCreation

(

)

const [virtual]

This method is for furture use and is currently not supported.

CellId()

IMPORT_C TUint

CellId

(

)

const

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

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.

Parameters

RMobilePhone::TMobilePhoneNetworkMode aNetworkType
TNetworkCountryCode aCountryCode
TNetworkIdentity aNetworkId
TUint aLocationAreaCode
TUint aCellId

DoExternalizeL(RWriteStream &)

void

DoExternalizeL

(

RWriteStream &

aStream

)

const [protected, virtual]

Externalize method that subclass must implement.

Parameters

RWriteStream & aStream

Stream to which the object should be externalized.

DoInternalizeL(RReadStream &)

void

DoInternalizeL

(

RReadStream &

aStream

)

[protected, virtual]

Internalize method that subclass must implement.

Parameters

RReadStream & 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.

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.

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.

NetworkType()

IMPORT_C RMobilePhone::TMobilePhoneNetworkMode

NetworkType

(

)

const

Returns the type of network

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

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

Parameters

RMobilePhone::TMobilePhoneNetworkMode aNetworkType	The network type
TNetworkCountryCode aCountryCode	The network country code
TNetworkIdentity aNetworkId	The network identity code
TUint aLocationAreaCode	The location area code
TUint aCellId	The cell id

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

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

Parameters

RMobilePhone::TMobilePhoneNetworkMode aNetworkType	The network type
TNetworkCountryCode aCountryCode	The network country code
TNetworkIdentity aNetworkId	The network identity code
TUint aLocationAreaCode	The location area code
TUint aCellId	The cell id

SetCellId(TUint)

IMPORT_C void

SetCellId

(

TUint

aCellId

)

Sets the cell id.

Parameters

TUint aCellId

The cell id.

SetLocationAreaCode(TUint)

IMPORT_C void

SetLocationAreaCode

(

TUint

aLocationAreaCode

)

Sets the location area code.

Parameters

TUint 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.

Parameters

TNetworkCountryCode 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.

Parameters

TNetworkIdentity aNetworkId

The network identity code.

SetNetworkType(RMobilePhone::TMobilePhoneNetworkMode)

IMPORT_C void

SetNetworkType

(

RMobilePhone::TMobilePhoneNetworkMode

aNetworkType

)

Sets the network type.

Parameters

RMobilePhone::TMobilePhoneNetworkMode aNetworkType

The type of network

Type()

TGeoAreaType

Type

(

)

const [virtual]

Returns the type of geographical area, 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

Parameters

const CLbtGeoCell &

Member Data Documentation

TUint iCellId

TUint

iCellId

[private]

Cell id

TUint iCountryCode

TUint

iCountryCode

[private]

Network country code

TUint iLocationAreaCode

TUint

iLocationAreaCode

[private]

Location area code

TUint iNetworkId

TUint

iNetworkId

[private]

Network identity code

RMobilePhone::TMobilePhoneNetworkMode iNetworkType

RMobilePhone::TMobilePhoneNetworkMode

iNetworkType

[private]

Network type