TDialLocation Class Reference

#include <dial.h>

Link against: dial.lib

class TDialLocation

Detailed Description

Contains information about the current location such as international prefix code, area code etc.

There are functions to get and set this information.

DeprecatedThis class has been deprecated from 9.1 and should no longer be used.

Constructor & Destructor Documentation

TDialLocation ( )

IMPORT_CTDialLocation()

Creates an empty Deprecated9.1 TDialLocation.

TDialLocation ( const TIntlPrefCode &, const TNatPrefCode &, const TNatCode &, const TAreaCode &, const TDialOutLocalCode &, const TDialOutLongDistanceCode &, const TDisableCallWaitingCode &, TUint, TUint )

IMPORT_CTDialLocation(const TIntlPrefCode &aIntlPrefCode,
const TNatPrefCode &aNatPrefCode,
const TNatCode &aNatCode,
const TAreaCode &aAreaCode,
const TDialOutLocalCode &aDialOutLocalCode,
const TDialOutLongDistanceCode &aDialOutLongDistanceCode,
const TDisableCallWaitingCode &aDisableCallWaitingCode,
TUintaFlags,
TUintaPauseAfterDialout
)

Creates a TDialLocation containing the parameters.

Deprecated9.1

Parameters
aIntlPrefCodeInternational Prefix Code. E.g. for the UK this is 00
aNatPrefCodeNational Prefix Code. E.g. for the UK this is 44
aNatCodeNational Code. E.g. within the UK this is 0
aAreaCodeArea Code. E.g. for London this is 20
aDialOutLocalCodeLocal Dial Out Code. Sometimes, the dial out codes differ depending upon whether dialling a local call or a long distance call. Typically 8 or 9 is used.
aDialOutLongDistanceCodeLong Distance Dial-Out Code.
aDisableCallWaitingCodeThis is the code to disable Call Waiting
aFlagsFlags to set various options. It should contain the following flags: KPhoneNumberMobile, KPhoneNumberUsePulseDial, KPhoneNumberPbxUsePulseDial, KPhoneNumberWaitForDialingTone, KPhoneNumberWaitForProceedTone, KReturnPhoneNumberWithPlusFormat
aPauseAfterDialoutSpecified the delay after dial out. In the dial string the delay is represented as a comma character. This parameter indicates the length of the comma character.

Member Function Documentation

AreaCode ( )

IMPORT_C TPtrCAreaCode()const

Returns the Area Code. E.g. for London this is 20 Deprecated9.1

ClearDialLocationFlags ( TUint )

voidClearDialLocationFlags(TUint)[inline]

Deprecated9.1

DialOutLocalCode ( )

IMPORT_C TPtrCDialOutLocalCode()const

Returns the Local Dial-Out Code. Sometimes, the dial out codes differ depending upon whether dialling a local call or a long distance call. Typically 8 or 9 is used. Deprecated9.1

DialOutLongDistanceCode ( )

IMPORT_C TPtrCDialOutLongDistanceCode()const

Returns the Long Distance Dial-Out Code. Deprecated9.1

DisableCallWaitingCode ( )

IMPORT_C TPtrCDisableCallWaitingCode()const

Returns the code to disable Call Waiting Deprecated9.1

IntlPrefCode ( )

IMPORT_C TPtrCIntlPrefCode()const

Returns the International Prefix Code. E.g. for the UK this is 00 Deprecated9.1

IsDialOutRequired ( )

IMPORT_C TBoolIsDialOutRequired()const

True if a code is needed to dial out either local or long distance calls. Deprecated9.1

IsDisableCallWaitingCode ( )

IMPORT_C TBoolIsDisableCallWaitingCode()const

True if call waiting is disabled. If no code was supplied to disable call waiting then false is returned. Deprecated9.1

IsMobile ( )

IMPORT_C TBoolIsMobile()const

True if the KPhoneNumberMobile flag is set Deprecated9.1

IsPbxUsePulseDial ( )

IMPORT_C TBoolIsPbxUsePulseDial()const

True if the KPhoneNumberPbxUsePulseDial flag is set Deprecated9.1

IsReturnPhoneNumberWithPlusFormat ( )

TBool IsReturnPhoneNumberWithPlusFormat()const [inline]

True if the KReturnPhoneNumberWithPlusFormat flag is set

Deprecated9.1

IsUsePulseDial ( )

IMPORT_C TBoolIsUsePulseDial()const

True if the KPhoneNumberUsePulseDial flag is set Deprecated9.1

IsWaitForDialingTone ( )

IMPORT_C TBoolIsWaitForDialingTone()const

True if the KPhoneNumberWaitForDialingTone flag is set Deprecated9.1

IsWaitForProceedTone ( )

IMPORT_C TBoolIsWaitForProceedTone()const

True if the KPhoneNumberWaitForProceedTone flag is set Deprecated9.1

NatCode ( )

IMPORT_C TPtrCNatCode()const

Returns the National Code. E.g. within the UK this is 0 Deprecated9.1

NatPrefCode ( )

IMPORT_C TPtrCNatPrefCode()const

Returns the National Prefix Code. E.g. for the UK this is 44 Deprecated9.1

PauseAfterDialout ( )

IMPORT_C TIntPauseAfterDialout()const

Returns the delay after dial out. In the dial string the delay is represented as a comma character. This parameter indicates the length of the comma character. Deprecated9.1

SetAreaCode ( const TDesC & )

IMPORT_C voidSetAreaCode(const TDesC &)

Set the Area Code. E.g. for London this is 20 Deprecated9.1

SetDialLocationFlags ( TUint )

IMPORT_C voidSetDialLocationFlags(TUint)

Set the location flags. Any of the following flags can be set:

KPhoneNumberMobile

KPhoneNumberUsePulseDial

KPhoneNumberPbxUsePulseDial

KPhoneNumberWaitForDialingTone

KPhoneNumberWaitForProceedTone

KReturnPhoneNumberWithPlusFormat

Deprecated9.1

SetDialOutLocalCode ( const TDesC & )

IMPORT_C voidSetDialOutLocalCode(const TDesC &)

Set the Local Dial Out Code. Sometimes, the dial out codes differ depending upon whether dialling a local call or a long distance call. Typically 8 or 9 is used. Deprecated9.1

SetDialOutLongDistanceCode ( const TDesC & )

IMPORT_C voidSetDialOutLongDistanceCode(const TDesC &)

Set the Long Distance Code. Deprecated9.1

SetDisableCallWaitingCode ( const TDesC & )

IMPORT_C voidSetDisableCallWaitingCode(const TDesC &)

Set the code to disable Call Waiting Deprecated9.1

SetIntlPrefCode ( const TDesC & )

IMPORT_C voidSetIntlPrefCode(const TDesC &)

Set the International Prefix Code. E.g. for the UK this is 00 Deprecated9.1

SetNatCode ( const TDesC & )

IMPORT_C voidSetNatCode(const TDesC &)

Set the National Code. E.g. within the UK this is 0 Deprecated9.1

SetNatPrefCode ( const TDesC & )

IMPORT_C voidSetNatPrefCode(const TDesC &)

Set the National Prefix Code. E.g. for the UK this is 44 Deprecated9.1

SetPauseAfterDialout ( TUint )

IMPORT_C voidSetPauseAfterDialout(TUint)

Set the delay after dial out. In the dial string the delay is represented as a comma character. This parameter indicates the length of the comma character. Deprecated9.1