Location:
SMUTSET.H
Link against: smcm.lib
class CSmsMessageSettings : public CBase;
The SMS settings that are relevant on a per message basis.
Each SMS message has its own settings. Initially they have a default set of values derived from the SMS service settings. They can be changed on an individual message basis. For instance, a messaging application may allow a user to specify/not specify status reports individually for each message.
These settings are only relevant to mobile originated messages - those of SMS-SUBMIT type.
CBase
- Base class for all classes to be instantiated on the heap
CSmsMessageSettings
- The SMS settings that are relevant on a per message basis
Defined in CSmsMessageSettings
:
CanConcatenate()
, CanConcatenate()
, CharacterSet()
, CharacterSet()
, CopyL()
, CopyL()
, DeliveryReport()
, DeliveryReport()
, ExternalizeL()
, ExternalizeL()
, InternalizeL()
, InternalizeL()
, LastSegmentDeliveryReport()
, LastSegmentDeliveryReport()
, MessageConversion()
, MessageConversion()
, RejectDuplicate()
, RejectDuplicate()
, ReplyPath()
, ReplyPath()
, SetCanConcatenate()
, SetCanConcatenate()
, SetCharacterSet()
, SetCharacterSet()
, SetDeliveryReport()
, SetDeliveryReport()
, SetLastSegmentDeliveryReport()
, SetLastSegmentDeliveryReport()
, SetMessageConversion()
, SetMessageConversion()
, SetRejectDuplicate()
, SetRejectDuplicate()
, SetReplyPath()
, SetReplyPath()
, SetUseServiceCenterTimeStampForDate()
, SetUseServiceCenterTimeStampForDate()
, SetValidityPeriod()
, SetValidityPeriod()
, SetValidityPeriodFormat()
, SetValidityPeriodFormat()
, UseServiceCenterTimeStampForDate()
, UseServiceCenterTimeStampForDate()
, ValidityPeriod()
, ValidityPeriod()
, ValidityPeriodFormat()
, ValidityPeriodFormat()
Inherited from CBase
:
Delete()
,
Extension_()
,
operator new()
virtual IMPORT_C void InternalizeL(RReadStream &aReadStream);
Internalises the settings from a read stream.
|
virtual IMPORT_C void ExternalizeL(RWriteStream &aWriteStream) const;
Externalises the settings to a write stream.
|
inline const TTimeIntervalMinutes &ValidityPeriod() const;
Gets the validity period for messages sent by the SMS MTM.
If the service centre is unable to deliver the SMS message before this time expires, a failure report may be generated by the service centre, and no further attempts will be made to deliver the message to ther recipient.
Validity period is only used for SMS-SUBMIT, mobile originated messages.
|
inline void SetValidityPeriod(TTimeIntervalMinutes);
Sets the validity period for messages sent by the SMS MTM.
|
|
inline void SetValidityPeriodFormat(TSmsFirstOctet::TSmsValidityPeriodFormat aValidityPeriodFormat);
Sets the format in which the validity period should be sent in a SMS-DELIVER type message.
This is field TP-VPF from GSM spec 03.40.
|
inline const TSmsFirstOctet::TSmsValidityPeriodFormat ValidityPeriodFormat() const;
Gets the format in which the validity period should be sent in a SMS-DELIVER type message.
|
inline TBool RejectDuplicate() const;
Gets the value of the reject-duplicate setting.
If this is true, the service instructs the SC to reject an Sms-Submit for an SMS still held in the SC that has the same message reference number and same destination address as an previously submitted SMS from the same originating address.
|
inline void SetRejectDuplicate(TBool);
Sets the value of the reject-duplicate setting.
|
inline TBool DeliveryReport() const;
Tests if a status report (TP-SRR in GSM spec 03.40) will be requested from the Service Centre.
A value of ETrue indicates that a status report will be requested.
|
inline void SetDeliveryReport(TBool);
Sets if a status report (TP-SRR in GSM spec 03.40) will be requested from the Service Centre.
A value of ETrue indicates that a status report will be requested.
|
inline TBool ReplyPath() const;
Gets the boolean flag that indicates whether a the reply path (Service Centre address) should be included in the SMS-SUBMIT message (TP-RP in GSM spec 03.40).
A value of ETrue indicates that the Service Centre address should be included. This flag is only relavent for SMS-SUBMIT messages.
|
inline void SetReplyPath(TBool);
Sets the boolean flag that indicates whether a the reply path (Service Centre address) should be included in the SMS-SUBMIT message (TP-RP in GSM spec 03.40).
A value of ETrue indicates that the Service Centre address should be included. This flag is only relavent for SMS-SUBMIT messages.
|
inline TSmsPIDConversion MessageConversion() const;
Gets the form in which the message should be delivered to the recipient by the service centre.
Note that the form may or may not actually be supported by the service centre, and that the format of the recipient address(es)
may need to be different to a normal telephone number if MessageConversion()
is set to any other value than ESmsConvPIDNone, ESmsConvFax, ESmsConvPaging or ESmsConvErmes.
|
inline void SetMessageConversion(TSmsPIDConversion);
Sets the form in which the message should be delivered to the recipient by the Service Centre.
Note that the form may or may not actually be supported by the service centre, and that the format of the recipient address(es)
may need to be different to a normal telephone number if MessageConversion()
is set to any other value than ESmsConvPIDNone, ESmsConvFax, ESmsConvPaging or ESmsConvErmes.
|
virtual IMPORT_C void InternalizeL(RReadStream &aReadStream);
|
virtual IMPORT_C void ExternalizeL(RWriteStream &aWriteStream) const;
|
inline TBool CanConcatenate() const;
Gets the values of the UI concatenated-SMS-allowed flag.
If true, the UI should pass a long message in one piece to the MTM. If false, it should split the message manually into 140 byte parts. The value of this flag does not affect the behaviour of the SMS MTM.
|
inline void SetCanConcatenate(TBool);
Sets the values of the UI concatenated-SMS-allowed flag.
If true, the UI should pass a long message in one piece to the MTM. If false, it should split the message manually into 140 byte parts. The value of this flag does not affect the behaviour of the SMS MTM.
|
inline const TTimeIntervalMinutes &ValidityPeriod() const;
|
inline enum TSmsDataCodingScheme::TSmsAlphabet CharacterSet() const;
Gets the default character set used in the SMS message.
Text is stored in Unicode on the Symbian OS phone and is converted into the appropriate character set when the message is sent.
|
inline void SetCharacterSet(TSmsDataCodingScheme::TSmsAlphabet);
Sets the default character set used in the SMS message.
Text is stored in Unicode on the Symbian OS phone and is converted into the appropriate character set when the message is sent.
|
inline void SetValidityPeriodFormat(TSmsFirstOctet::TSmsValidityPeriodFormat aValidityPeriodFormat);
|
inline const TSmsFirstOctet::TSmsValidityPeriodFormat ValidityPeriodFormat() const;
|
virtual IMPORT_C void CopyL(const CSmsMessageSettings &aSettings);
Copies the settings stored in the specified object into this object.
|
inline TBool LastSegmentDeliveryReport() const;
Tests if a status report (TP-SRR in GSM spec 03.40) for the last segment will be requested from the Service Centre.
A value of ETrue indicates that a status report will be requested for the last segment.
|
inline void SetLastSegmentDeliveryReport(TBool);
Sets if a status report (TP-SRR in GSM spec 03.40) for the last segment will be requested from the Service Centre.
A value of ETrue indicates that a status report will be requested for the last segment.
|
inline void SetUseServiceCenterTimeStampForDate(TBool aUseServiceCenterTimestamp);
Sets the flag which indicates whether the service center timestamp should be used for the date field in the TMsvEntry
in message store. If the flag is not set, then the timestamp from the associated CSmsMessage
is used.
|
inline TBool UseServiceCenterTimeStampForDate() const;
Gets the flag which indicates whether the service center timestamp should be used for the date field in the TMsvEntry
in message store. If the flag is not set, then the timestamp from the associated CSmsMessage
is used.
|
inline enum TSmsDataCodingScheme::TSmsAlphabet CharacterSet() const;
|
inline void SetCharacterSet(TSmsDataCodingScheme::TSmsAlphabet);
|
virtual IMPORT_C void CopyL(const CSmsMessageSettings &aSettings);
|
inline void SetLastSegmentDeliveryReport(TBool aDeliveryReport);
|
inline void SetUseServiceCenterTimeStampForDate(TBool aUseServiceCenterTimestamp);
|