CCommsDbConnectionPrefTableView Class Reference

class CCommsDbConnectionPrefTableView : public CBase

Implements actions on records of the Connection Preferences table, to allow clients to set the preferred order in which connections are attempted.

The class is similiar to CCommsDbTableView, but only allows access to connection preferences as a set and not to individual fields in the table. This prevents inappropriate updates of the records. Like CCommsDbTableView, the class has a group of functions for navigating through the records in the view, and another group for setting fields in the current record.

Clients do not create this type of object, but get an instance through CCommsDatabase::OpenConnectionPrefTableLC(), CCommsDatabase::OpenConnectionPrefTableInRankOrderLC(), or CCommsDatabase::OpenConnectionPrefTableViewOnRankLC().

In addition to the leave codes documented, all leaving functions can leave with any error returned by DBMS during database manipulation.

CCommDbOverrideSettings::GetConnectionPreferenceOverride()

CCommDbOverrideSettings::SetConnectionPreferenceOverride()

Inherits from

  • CCommsDbConnectionPrefTableView
Public Member Functions
~CCommsDbConnectionPrefTableView()
IMPORT_C voidChangeConnectionPreferenceRankL(TUint32)
IMPORT_C voidDeleteConnectionPreferenceL()
IMPORT_C TIntGotoFirstRecord()
IMPORT_C TIntGotoNextRecord()
IMPORT_C TIntGotoPreviousRecord()
IMPORT_C voidInsertConnectionPreferenceL(const TCommDbIapConnectionPref &, TBool)
IMPORT_C voidInsertConnectionPreferenceL(const TCommDbIspConnectionPref &, TBool)
CCommsDbConnectionPrefTableView *NewL(CCommsDatabase &, TCommDbConnectionDirection, TUint32)
CCommsDbConnectionPrefTableView *NewLC(CCommsDatabase &, const TDbQuery &)
CCommsDbConnectionPrefTableView *NewLC(CCommsDatabase &, TCommDbConnectionDirection, TBool)
IMPORT_C voidReadConnectionPreferenceL(TCommDbIapConnectionPref &)
IMPORT_C voidReadConnectionPreferenceL(TCommDbIspConnectionPref &)
IMPORT_C voidSwapConnectionPreferencesL(TCommDbConnectionDirection, TUint32, TUint32)
IMPORT_C voidUpdateBearerL(const TCommDbIapBearer &, TBool)
IMPORT_C voidUpdateBearerL(const TCommDbIspBearer &, TBool)
IMPORT_C voidUpdateDialogPrefL(const TCommDbDialogPref &)
Protected Member Functions
CCommsDbConnectionPrefTableView(CCommsDatabase &)
voidClose()
TDbColNo ColNum(const TDesC &)
voidConstructL(const TDbQuery &)
voidConstructL(TCommDbConnectionDirection, TBool)
voidConstructL(TCommDbConnectionDirection, TUint32)
RDbRowSet::TAccess GetL()
voidGetUint32L(const TDesC &, TUint32 &)
voidOpenL(const TDbQuery &)
Private Member Functions
voidDoSwapConnectionPreferencesL(TCommDbConnectionDirection, TUint32, TUint32)
voidSetRankL(TUint32)
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()
Protected Attributes
CCommsDatabase &iDb
CCommDbTableExtension *iTableExt
RDbView iTableView

Constructor & Destructor Documentation

CCommsDbConnectionPrefTableView(CCommsDatabase &)

CCommsDbConnectionPrefTableView(CCommsDatabase &aDb)[protected]

Parameters

CCommsDatabase & aDb

~CCommsDbConnectionPrefTableView()

IMPORT_C~CCommsDbConnectionPrefTableView()[virtual]

Member Functions Documentation

ChangeConnectionPreferenceRankL(TUint32)

IMPORT_C voidChangeConnectionPreferenceRankL(TUint32aNewRank)

Parameters

TUint32 aNewRank

Close()

voidClose()[protected]

ColNum(const TDesC &)

TDbColNo ColNum(const TDesC &aColumn)const [protected, inline]

Returns the column number of the Column aColumn in the table

Coloumn concept doesn't exist in CommsDat depNot supported from v9.1

The ordinal number of the column else KDbNullColNo if no such column exists.

Parameters

const TDesC & aColumnA reference to a descriptor containing the name of a column in the current record.

ConstructL(const TDbQuery &)

voidConstructL(const TDbQuery &aQuery)[protected]

Parameters

const TDbQuery & aQuery

ConstructL(TCommDbConnectionDirection, TBool)

voidConstructL(TCommDbConnectionDirectionaDirection,
TBoolaSortRanking
)[protected]

Parameters

TCommDbConnectionDirection aDirection
TBool aSortRanking

ConstructL(TCommDbConnectionDirection, TUint32)

voidConstructL(TCommDbConnectionDirectionaDirection,
TUint32aRank
)[protected]

Parameters

TCommDbConnectionDirection aDirection
TUint32 aRank

DeleteConnectionPreferenceL()

IMPORT_C voidDeleteConnectionPreferenceL()

DoSwapConnectionPreferencesL(TCommDbConnectionDirection, TUint32, TUint32)

voidDoSwapConnectionPreferencesL(TCommDbConnectionDirectionaDirection,
TUint32aFirstRank,
TUint32aSecondRank
)[private]

Parameters

TCommDbConnectionDirection aDirection
TUint32 aFirstRank
TUint32 aSecondRank

GetL()

RDbRowSet::TAccess GetL()[protected]

GetUint32L(const TDesC &, TUint32 &)

voidGetUint32L(const TDesC &aColumnName,
TUint32 &aValue
)[protected]

Parameters

const TDesC & aColumnName
TUint32 & aValue

GotoFirstRecord()

IMPORT_C TIntGotoFirstRecord()

GotoNextRecord()

IMPORT_C TIntGotoNextRecord()

GotoPreviousRecord()

IMPORT_C TIntGotoPreviousRecord()

InsertConnectionPreferenceL(const TCommDbIapConnectionPref &, TBool)

IMPORT_C voidInsertConnectionPreferenceL(const TCommDbIapConnectionPref &aPref,
TBoolaReadOnly = EFalse
)

Parameters

const TCommDbIapConnectionPref & aPref
TBool aReadOnly = EFalse

InsertConnectionPreferenceL(const TCommDbIspConnectionPref &, TBool)

IMPORT_C voidInsertConnectionPreferenceL(const TCommDbIspConnectionPref &aPref,
TBoolaReadOnly = EFalse
)

Parameters

const TCommDbIspConnectionPref & aPref
TBool aReadOnly = EFalse

NewL(CCommsDatabase &, TCommDbConnectionDirection, TUint32)

CCommsDbConnectionPrefTableView *NewL(CCommsDatabase &aDb,
TCommDbConnectionDirectionaDirection,
TUint32aRank
)[static]

Parameters

CCommsDatabase & aDb
TCommDbConnectionDirection aDirection
TUint32 aRank

NewLC(CCommsDatabase &, const TDbQuery &)

CCommsDbConnectionPrefTableView *NewLC(CCommsDatabase &aDb,
const TDbQuery &aQuery
)[static]

Parameters

CCommsDatabase & aDb
const TDbQuery & aQuery

NewLC(CCommsDatabase &, TCommDbConnectionDirection, TBool)

CCommsDbConnectionPrefTableView *NewLC(CCommsDatabase &aDb,
TCommDbConnectionDirectionaDirection,
TBoolaSortRanking = EFalse
)[static]

Parameters

CCommsDatabase & aDb
TCommDbConnectionDirection aDirection
TBool aSortRanking = EFalse

OpenL(const TDbQuery &)

voidOpenL(const TDbQuery &aQuery)[protected]

Parameters

const TDbQuery & aQuery

ReadConnectionPreferenceL(TCommDbIapConnectionPref &)

IMPORT_C voidReadConnectionPreferenceL(TCommDbIapConnectionPref &aPref)

Parameters

TCommDbIapConnectionPref & aPref

ReadConnectionPreferenceL(TCommDbIspConnectionPref &)

IMPORT_C voidReadConnectionPreferenceL(TCommDbIspConnectionPref &aPref)

Parameters

TCommDbIspConnectionPref & aPref

SetRankL(TUint32)

voidSetRankL(TUint32aNewRank)[private]

Parameters

TUint32 aNewRank

SwapConnectionPreferencesL(TCommDbConnectionDirection, TUint32, TUint32)

IMPORT_C voidSwapConnectionPreferencesL(TCommDbConnectionDirectionaDirection,
TUint32aFirstRank,
TUint32aSecondRank
)

Parameters

TCommDbConnectionDirection aDirection
TUint32 aFirstRank
TUint32 aSecondRank

UpdateBearerL(const TCommDbIapBearer &, TBool)

IMPORT_C voidUpdateBearerL(const TCommDbIapBearer &aUpdate,
TBoolaReadOnly = EFalse
)

Parameters

const TCommDbIapBearer & aUpdate
TBool aReadOnly = EFalse

UpdateBearerL(const TCommDbIspBearer &, TBool)

IMPORT_C voidUpdateBearerL(const TCommDbIspBearer &aUpdate,
TBoolaReadOnly = EFalse
)

Parameters

const TCommDbIspBearer & aUpdate
TBool aReadOnly = EFalse

UpdateDialogPrefL(const TCommDbDialogPref &)

IMPORT_C voidUpdateDialogPrefL(const TCommDbDialogPref &aUpdate)

Parameters

const TCommDbDialogPref & aUpdate

Member Data Documentation

CCommsDatabase & iDb

CCommsDatabase &iDb[protected]

Comms data base that is being viewed.

CCommDbTableExtension * iTableExt

CCommDbTableExtension *iTableExt[protected]

RDbView iTableView

RDbView iTableView[protected]

DBMS view. Variable not used in shim. Not removed because of BC break