diff -r e1b950c65cb4 -r 837f303aceeb epoc32/include/mw/tzupdate.h --- a/epoc32/include/mw/tzupdate.h Wed Mar 31 12:27:01 2010 +0100 +++ b/epoc32/include/mw/tzupdate.h Wed Mar 31 12:33:34 2010 +0100 @@ -1,9 +1,9 @@ // Copyright (c) 2004-2009 Nokia Corporation and/or its subsidiary(-ies). // All rights reserved. // This component and the accompanying materials are made available -// under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members +// under the terms of "Eclipse Public License v1.0" // which accompanies this distribution, and is available -// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html". +// at the URL "http://www.eclipse.org/legal/epl-v10.html". // // Initial Contributors: // Nokia Corporation - initial contribution. @@ -17,6 +17,7 @@ #define __TZUPDATE_H__ #include // TUid. +#include /** UTC Offset update notification constants. When the UTC offset is automatically adjusted for Daylight Saving then it is possible to receive @@ -25,22 +26,35 @@ as this is the only component that can modify the UTC Offset. @see RProperty in e32property.h -@publishedAll -@released -@since 9.1 */ namespace NTzUpdate { + /** Time zone services publish and subscribe property category. + @publishedAll + @released + */ const TUid KPropertyCategory = { 0x1020383E }; + /** Time zone services publish and subscribe property keys. + @publishedAll + @released + */ enum TPropertyKeys { EUtcOffsetChangeNotification, ECurrentTimeZoneId, EHomeTimeZoneId, - ENextDSTChange + ENextDSTChange, + ETzRulesChange, + ETzNamesChange, }; + /** Structure used to return the value for ECurrentTimeZoneId or + EHomeTimeZoneId property. + @see RTz::NotifyHomeTimeZoneChangedL + @publishedAll + @released + */ struct TTimeZoneChange { TInt iNewTimeZoneId; @@ -48,10 +62,11 @@ }; /** This struct is used to publish DST Change info in an RProperty. - Subscribers to the property will define a copy of this struct + Subscribers to the ENextDSTChange property will define a copy of this struct so that they are not dependant on the tz component. If this struct changes then the copies must also be changed. - @internalTechnology + @publishedAll + @released */ struct TDSTChangeInfo { @@ -69,10 +84,32 @@ /** The offset from UTC (in minutes) before the previous DST change took place. This member is only valid if the version is 2 or above.*/ TInt iPreviousUTCOffset; - - /** Reserved for future use. */ + private: + /** Reserved for future use. + */ TInt iReserved[12]; }; - } + /** Structure used to return the value for ETzRulesChange property. + This property covers changes to the system TZ database, the current/system + TZ rules or user-defined TZ rules. + @publishedAll + @released + */ + struct TTzRulesChange + { + TTime iUTCTimeOfRulesChange; + }; + + /** Structure used to return the value for ETzNamesChange property. + This property covers changes to either the localized system TZ names + or non-localized user-defined TZ names. + @publishedAll + @released + */ + struct TTzNamesChange + { + TTime iUTCTimeOfNamesChange; + }; + } #endif // __TZUPDATE_H__