CClkDateTimeView Class Reference

API published in: S60 1st Ed
API deprecated in: S60 3rd Ed FP 1

Link against: clkdatetimeview.lib

Capability Information

Required Capabilities

None

#include <clkdatetimeview.h>

Inherits CAknView, MEikListBoxObserver, and MClkModelObserver.

Detailed Description

common "Date & Time" settings view class This is a dynamic link library which provides APIs for using the common Date and Time Settings view.

The Clock and General Settings applications make use of this.


Public Member Functions
IMPORT_C	~CClkDateTimeView ()
	Destructor.
TUid	Id () const
	From CAknView Returns this view Id.
void	HandleCommandL (TInt aCommandId)
	From MEikCommandObserver Handles commands.
void	HandleUpdateL (TInt aNotification)
	From MClkModelObserver Called when the model is changed.
IMPORT_C void	InitCurrentItem ()
	Moves the current item to the top of the list items.
void	HandleSettingsChangeL (const TInt aChange)
	Handle options changed by system.
void	IncCurrentItem ()
	Increments the current list item to handle the task swapping event.
void	DecCurrentItem ()
	Decrements the current list item to handle the task swapping event.
TBool	IsClockInUse () const
	Gets a flag meaning that Clock application is using.
TVwsViewId	PrevViewId () const
	Gets a previous view id.
void	HandleChangeCmdL (const TInt aItemId)
	Handles a softkey event "Change".
void	DynInitMenuPaneL (TInt aResourceId, CEikMenuPane *aMenuPane)
	From MEikMenuObserver Intialize the menu dynamically.
void	UpdateDTViewL (TUint32 aId, const TDesC16 &aNewValue)
	When an alarm tone / snooze time is changed through general settings, it gets updated in the clock settings.
Static Public Member Functions
static IMPORT_C CClkDateTimeView *	NewLC (TUid aViewId, TBool aClockUse=EFalse)
	Two-phased constructor returned value is also kept on the CleanupStack.
Protected Member Functions
void	DoActivateL (const TVwsViewId &aPrevViewId, TUid aCustomMessageId, const TDesC8 &aCustomMessage)
	From CAknView Activates this view.
void	DoDeactivate ()
	From CAknView Deactivates this view.
void	HandleListBoxEventL (CEikListBox *aListBox, TListBoxEvent aEventType)
	From MEikListBoxObserver Handles an event happend in aListBox.
void	ConstructL (TUid aViewId, TBool aClockUse)
	Second-phase constructor.

Constructor & Destructor Documentation

IMPORT_C CClkDateTimeView::~CClkDateTimeView

(

)

Destructor.

Member Function Documentation

void CClkDateTimeView::ConstructL	(	TUid	aViewId,
		TBool	aClockUse
	)	`[protected]`

Second-phase constructor.

Parameters:

	aViewId	Id of a view which is changed to, when Back softkey is pressed. It is ignored when aClockUse is ETrue.
	aClockUse	ETrue means Clock application uses. EFalse means any application except Clock uses.

void CClkDateTimeView::DecCurrentItem

(

)

Decrements the current list item to handle the task swapping event.

void CClkDateTimeView::DoActivateL	(	const TVwsViewId &	aPrevViewId,
		TUid	aCustomMessageId,
		const TDesC8 &	aCustomMessage
	)	`[protected, virtual]`

From CAknView Activates this view.

Parameters:

	aPrevViewId	The view id for the view from where the date time view setting called
	aCustomMessageId	Not used for the implementation
	aCustomMessage	Not used for the implementation

Implements CAknView.

void CClkDateTimeView::DoDeactivate ( ) [protected, virtual]

From CAknView Deactivates this view.

Implements CAknView.

void CClkDateTimeView::DynInitMenuPaneL	(	TInt	aResourceId,
		CEikMenuPane *	aMenuPane
	)

From MEikMenuObserver Intialize the menu dynamically.

Parameters:

	aResourceId	The resource id for the option popup menu
	aMenuPane	The dynamic menupane to delete the help cmd from the menu

void CClkDateTimeView::HandleChangeCmdL

Handles a softkey event "Change".

Parameters:

aItemId

The current item id of the settings list box.

void CClkDateTimeView::HandleCommandL ( TInt aCommandId ) [virtual]

From MEikCommandObserver Handles commands.

Parameters:

aCommandId

It is the value of the command to be handled in the setting.

Reimplemented from CAknView.

void CClkDateTimeView::HandleListBoxEventL	(	CEikListBox *	aListBox,
		TListBoxEvent	aEventType
	)	`[protected]`

From MEikListBoxObserver Handles an event happend in aListBox.

Parameters:

	aListBox	The pointer to the ListBox in date time setting view
	aEventType	The type of the event on the ListBox

void CClkDateTimeView::HandleSettingsChangeL

Handle options changed by system.

Parameters:

aChange

It indicates a cause of the change.

void CClkDateTimeView::HandleUpdateL ( TInt aNotification ) [virtual]

From MClkModelObserver Called when the model is changed.

Parameters:

aNotification

The cause of the notification.

Implements MClkModelObserver.

TUid CClkDateTimeView::Id ( ) const [virtual]

From CAknView Returns this view Id.

Returns:: TUid The view id

Implements CAknView.

void CClkDateTimeView::IncCurrentItem

(

)

Increments the current list item to handle the task swapping event.

IMPORT_C void CClkDateTimeView::InitCurrentItem

(

)

Moves the current item to the top of the list items.

TBool CClkDateTimeView::IsClockInUse

(

)

const

Gets a flag meaning that Clock application is using.

Returns:: ETrue means the ClockApp uses this object. EFalse means the ClockApp doesn't use this object.

static IMPORT_C CClkDateTimeView* CClkDateTimeView::NewLC	(	TUid	aViewId,
		TBool	aClockUse = `EFalse`
	)	`[static]`

Two-phased constructor returned value is also kept on the CleanupStack.

Parameters:

	aViewId	Id of a view which is changed to, when Back softkey is pressed. It is ignored when aClockUse is ETrue.
	aClockUse	ETrue means Clock application uses this. EFalse means any application except Clock uses this.