--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/telephonyutils/dial/inc/DIAL.H Tue Feb 02 01:41:59 2010 +0200
@@ -0,0 +1,315 @@
+// Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).
+// All rights reserved.
+// This component and the accompanying materials are made available
+// under the terms of "Eclipse Public License v1.0"
+// which accompanies this distribution, and is available
+// at the URL "http://www.eclipse.org/legal/epl-v10.html".
+//
+// Initial Contributors:
+// Nokia Corporation - initial contribution.
+//
+// Contributors:
+//
+// Description:
+//
+
+
+
+/**
+ @file
+ @publishedAll
+ @deprecated 9.1
+*/
+
+#ifndef __DIAL_H__
+/**
+@publishedAll
+@deprecated 9.1
+*/
+#define __DIAL_H__
+
+#include <e32base.h>
+#include <dial_consts.h>
+
+/**
+@publishedAll
+@deprecated 9.1
+*/
+const TInt KChargeCardRuleSize=32;
+/**
+@publishedAll
+@deprecated 9.1
+*/
+const TInt KChargeCardAccountNumberSize=32;
+/**
+@publishedAll
+@deprecated 9.1
+*/
+const TInt KChargeCardPinSize=8;
+
+/**
+Represents a dialling rule.
+@deprecated 9.1
+*/
+typedef TBuf<KChargeCardRuleSize> TChargeCardRule ;
+/**
+Represents the charge card account number.
+@deprecated 9.1
+*/
+typedef TBuf<KChargeCardAccountNumberSize> TChargeCardAccount ;
+/**
+Represents the charge card PIN number.
+@deprecated 9.1
+*/
+typedef TBuf<KChargeCardPinSize> TChargeCardPin;
+
+/**
+Contains information about a charge card.
+There are functions to get and set this information.
+
+@deprecated This class has been deprecated from 9.1 and should no longer be used.
+*/
+class TChargeCard
+ {
+public:
+ IMPORT_C TChargeCard () ;
+ IMPORT_C TChargeCard(
+ const TChargeCardAccount& aNumber,
+ const TChargeCardPin& aPin ,
+ const TChargeCardRule& aLocalRule,
+ const TChargeCardRule& aNatRule,
+ const TChargeCardRule& aIntlRule) ;
+
+ IMPORT_C void SetNumber(const TDesC&);
+ IMPORT_C void SetPin(const TDesC&);
+ IMPORT_C void SetLocalRule (const TDesC&);
+ IMPORT_C void SetNatRule(const TDesC&);
+ IMPORT_C void SetIntlRule(const TDesC&);
+
+ IMPORT_C TBool ValidateChargeCardInfo() const;
+ IMPORT_C TPtrC Number() const;
+ IMPORT_C TPtrC Pin() const;
+ IMPORT_C TPtrC LocalRule () const;
+ IMPORT_C TPtrC NatRule() const;
+ IMPORT_C TPtrC IntlRule() const;
+private:
+
+ TChargeCardAccount iNumber;
+ TChargeCardPin iPin;
+ TChargeCardRule iLocalRule;
+ TChargeCardRule iNatRule;
+ TChargeCardRule iIntlRule;
+ };
+
+/**
+This can be passed to TelephoneNumber::Parse() to define whether a
+telephone number is for dialling or for display.
+
+@deprecated 9.1
+*/
+enum TParseMode
+ {
+ EForDialing,
+ EForDisplay
+ } ;
+
+/**
+Defines the size of TDialOutLocalCode
+@deprecated 9.1
+*/
+const TInt KDialOutLocalCodeSize=4;
+/**
+Defines the size of TDialOutLongDistanceCode
+@deprecated 9.1
+*/
+const TInt KDialOutLongDistanceCodeSize=4;
+/**
+Defines the size of TDisableCallWaitingCode
+@deprecated 9.1
+*/
+const TInt KDisableCallWaitingCodeSize=8;
+/**
+Defines the size of TPhoneNumber
+@deprecated 9.1
+*/
+const TInt KPhoneNumberSize=100;
+
+/**
+Descriptor for the Local Dial-Out Code.
+@deprecated 9.1
+*/
+typedef TBuf<KDialOutLocalCodeSize> TDialOutLocalCode ;
+/**
+Descriptor for the Long Distance Dial-Out Code.
+@deprecated 9.1
+*/
+typedef TBuf<KDialOutLongDistanceCodeSize> TDialOutLongDistanceCode ;
+/**
+Descriptor for code to disable call waiting
+@deprecated 9.1
+*/
+typedef TBuf<KDisableCallWaitingCodeSize> TDisableCallWaitingCode ;
+/**
+Descriptor for the phone number.
+@deprecated 9.1
+*/
+typedef TBuf<KPhoneNumberSize> TPhoneNumber ;
+
+/**
+These flags are part of the location information stored by TDialLocation.
+@deprecated 9.1
+*/
+enum {
+ KPhoneNumberMobile =0x00000001,
+ KPhoneNumberUsePulseDial =0x00000002,
+ KPhoneNumberPbxUsePulseDial =0x00000004,
+ KPhoneNumberWaitForDialingTone =0x00000008,
+ KPhoneNumberWaitForProceedTone =0x00000010,
+ KReturnPhoneNumberWithPlusFormat=0x00000020
+ };
+
+/**
+@publishedAll
+@deprecated 9.1
+*/
+const TInt KPhoneNumberDefaultFlags=KPhoneNumberUsePulseDial;
+
+/**
+Contains information about the current location
+such as international prefix code, area code etc.
+
+There are functions to get and set this information.
+
+@deprecated This class has been deprecated from 9.1 and should no longer be used.
+*/
+class TDialLocation
+ {
+public:
+ IMPORT_C TDialLocation() ;
+ IMPORT_C TDialLocation(
+ const TIntlPrefCode & aIntlPrefCode,
+ const TNatPrefCode& aNatPrefCode,
+ const TNatCode& aNatCode,
+ const TAreaCode& aAreaCode,
+ const TDialOutLocalCode& aDialOutLocalCode,
+ const TDialOutLongDistanceCode& aDialOutLongDistanceCode,
+ const TDisableCallWaitingCode& aDisableCallWaitingCode,
+ TUint aFlags,
+ TUint aPauseAfterDialout ) ;
+
+ IMPORT_C void SetIntlPrefCode(const TDesC&) ;
+ IMPORT_C void SetNatPrefCode(const TDesC&);
+ IMPORT_C void SetNatCode(const TDesC&);
+ IMPORT_C void SetAreaCode(const TDesC&);
+ IMPORT_C void SetDialOutLocalCode(const TDesC&);
+ IMPORT_C void SetDialOutLongDistanceCode(const TDesC&);
+ IMPORT_C void SetDisableCallWaitingCode(const TDesC&);
+ IMPORT_C void SetDialLocationFlags (TUint);
+ inline void ClearDialLocationFlags (TUint);
+ IMPORT_C void SetPauseAfterDialout ( TUint);
+ IMPORT_C TPtrC IntlPrefCode() const ;
+ IMPORT_C TPtrC NatPrefCode() const;
+ IMPORT_C TPtrC NatCode() const;
+ IMPORT_C TPtrC AreaCode() const;
+ IMPORT_C TPtrC DialOutLocalCode() const;
+ IMPORT_C TPtrC DialOutLongDistanceCode() const;
+ IMPORT_C TPtrC DisableCallWaitingCode() const;
+ IMPORT_C TInt PauseAfterDialout () const;
+ IMPORT_C TBool IsMobile () const ;
+ inline TBool IsReturnPhoneNumberWithPlusFormat() const;
+ IMPORT_C TBool IsUsePulseDial () const;
+ IMPORT_C TBool IsPbxUsePulseDial () const ;
+ IMPORT_C TBool IsWaitForDialingTone () const ;
+ IMPORT_C TBool IsWaitForProceedTone () const;
+ IMPORT_C TBool IsDialOutRequired () const;
+ IMPORT_C TBool IsDisableCallWaitingCode() const;
+
+private:
+ TIntlPrefCode iIntlPrefCode;
+ TNatPrefCode iNatPrefCode;
+ TNatCode iNatCode;
+ TAreaCode iAreaCode;
+ TDialOutLocalCode iDialOutLocalCode;
+ TDialOutLongDistanceCode iDialOutLongDistanceCode;
+ TDisableCallWaitingCode iDisableCallWaitingCode;
+ TUint iFlags;
+ TUint iPauseAfterDialout;
+};
+
+/**
+This can be passed to TelephoneNumber::Parse() to define whether the
+dial string is in full or in the ‘+’ char format.
+
+@deprecated 9.1
+*/
+enum TPlusFormatDialOptions
+ {
+ EPlusFormatDialNotAllow ,
+ EPlusFormatDialAllow
+ };
+
+/**
+This option applies when the phone number being dialled is in the
+same location as the dialler: It controls whether the area code
+is included in the final dial string.
+
+@deprecated 9.1
+*/
+enum TCityDialOptions
+ {
+ EDialCityStripDuplicateAreaCode,
+ EDialCityAllowDuplicateAreaCode
+ };
+
+/**
+This can be passed to TelephoneNumber::Parse() to define the
+area code of the dialling and diallers locations.
+
+@deprecated This class has been deprecated from 9.1 and should no longer be used.
+*/
+class TCityDialCodes
+ {
+ public:
+ TAreaCode iAreaCode;
+ TNatCode iNatCode;
+ TNatPrefCode iNatPref;
+ TIntlPrefCode iIntlPref;
+ };
+
+
+/**
+A static class that provides functions to resolve telephone numbers.
+
+@deprecated This class has been deprecated from 9.1 and should no longer be used.
+*/
+class TelephoneNumber
+{
+public:
+IMPORT_C static TInt Parse(
+ TDialString& aDialString ,
+ const TDialLocation& aDialLocation ,
+ const TChargeCard& aChargeCard,
+ const TDesC& aPhoneNumber,
+ TParseMode aParseMode ) ;
+
+IMPORT_C static TInt Parse ( TDialString& aDialString ,
+ const TDialLocation& aDialLocation,
+ const TDesC& aPhoneNumber );
+
+IMPORT_C static TInt CalculateDialCityPrefix(
+ TDialString& aDialString ,
+ const TCityDialCodes& aFrom,
+ const TCityDialCodes& aTo,
+ TCityDialOptions aOption,
+ TChar aCodeSeparator ,
+ TPlusFormatDialOptions aPlusOption ) ;
+//
+IMPORT_C static TInt Parse ( TDialString& aDialString ,
+ const TDialLocation& aDialLocation,
+ const TDesC& aPhoneNumber,
+ TCityDialOptions aOption) ;
+};
+
+#include <dial.inl>
+
+#endif