Collapse all Symbian^3 Application Developer Library

CErrorUI Class Reference

class CErrorUI : public CBase

Utility class to display error notes by applications. This is the default error display class to be used by applications. The features of the class are:

maps given error to error text to be displayed
displays error note using timed, global note
does not display error if it is already "on"
offers a reference to internal TextResolver instance

Usage (typically as instance variable) iErrorUI = CErrorUI::NewL() ; // iCoeEnv can be given as argument, no need to that though ... some code causing an error ... if ( err != KErrNone ) iErrorUI->ShowGlobalErrorNoteL(err);

Inherits from

CErrorUI
- CBase

Public Member Functions
	~CErrorUI ()
IMPORT_C CErrorUI *	NewL ()
IMPORT_C CErrorUI *	NewL ( CCoeEnv &)
IMPORT_C CErrorUI *	NewLC ()
IMPORT_C CErrorUI *	NewLC ( CCoeEnv &)
IMPORT_C TBool	ShowGlobalErrorNoteL ( TInt , CTextResolver::TErrorContext )
IMPORT_C TBool	ShowGlobalErrorQueryL ( TInt , CTextResolver::TErrorContext )
CTextResolver &	TextResolver ()

Private Member Functions
void	ConstructL ()
CErrorUI *	ConstructLC ()

Inherited Functions
	CBase::CBase()
	CBase::Delete(CBase *)
	CBase::Extension_(TUint,TAny &,TAny )
	CBase::operator new(TUint)
	CBase::operator new(TUint,TAny *)
	CBase::operator new(TUint,TLeave)
	CBase::operator new(TUint,TLeave,TUint)
	CBase::operator new(TUint,TUint)
	CBase::~CBase()

Private Attributes
CTextResolver *	iTextResolver

Constructor & Destructor Documentation

~CErrorUI()

IMPORT_C

~CErrorUI

(

)

Destructor

Member Functions Documentation

ConstructL()

void

ConstructL

(

)

[private]

ConstructLC()

CErrorUI *

ConstructLC

(

)

[private, static]

NewL()

IMPORT_C CErrorUI *

NewL

(

)

[static]

This constructor method should be used by servers, does not put the created object into CleanupStack

NewL(CCoeEnv &)

IMPORT_C CErrorUI *

NewL

(

CCoeEnv &

aEnv

)

[static]

This constructor method should be used by applications, does not put the created object into CleanupStack

Parameters

CCoeEnv & aEnv

Reference to caller's control environment

NewLC()

IMPORT_C CErrorUI *

NewLC

(

)

[static]

This constructor method should be used by servers, puts the created object into CleanupStack

NewLC(CCoeEnv &)

IMPORT_C CErrorUI *

NewLC

(

CCoeEnv &

aEnv

)

[static]

This constructor method should be used by applications, puts the created object into CleanupStack

Parameters

CCoeEnv & aEnv

Reference to caller's control environment

ShowGlobalErrorNoteL(TInt, CTextResolver::TErrorContext)

IMPORT_C TBool	ShowGlobalErrorNoteL	(	TInt	aError,
			CTextResolver::TErrorContext	aContext = CTextResolver::ECtxAutomatic
		)

Shows a global error note which is created by resolving to a display text from the given error code. The is the default method to be called by applications to display error messages.

Parameters

TInt aError	Any error code, for example ETel error or Email error.
CTextResolver::TErrorContext aContext = CTextResolver::ECtxAutomatic	The context of the error, needed in special cases such as WAP errors, usually (and by default) ECtxAutomatic

ShowGlobalErrorQueryL(TInt, CTextResolver::TErrorContext)

IMPORT_C TBool	ShowGlobalErrorQueryL	(	TInt	aError,
			CTextResolver::TErrorContext	aContext = CTextResolver::ECtxAutomatic
		)

Shows a global error query with OK key, which is created by resolving to a display text from the given error code. The is the default method to be called by applications to display error queries.

Parameters

TInt aError	Any error code, for example ETel error or Email error.
CTextResolver::TErrorContext aContext = CTextResolver::ECtxAutomatic	The context of the error, needed in special cases such as WAP errors, usually (and by default) ECtxAutomatic

TextResolver()

CTextResolver &

TextResolver

(

)

[inline]

Offers a reference to internal TextResolver instance

Member Data Documentation

CTextResolver * iTextResolver

CTextResolver *

iTextResolver

[private]