Class MDialogProvider

class MDialogProvider;

Description

Dependencies : none Comments : This class provides an API to be called by low level components, like data collectors, and implemented by the UI.

It is mainly used for dialog creation and information passing.

Members

Defined in MDialogProvider:

• AlertL(const TDesC &)Intended Usage : Creates an alert dialog to inform the user. A message is displa...
• CancelConnectingDialog()Intended Usage : Cancels the current connecting dialog.
• CloseCancelDialog()Intended Usage : This method closes the cancel dialog created from the DisplayCa...
• ConfirmationL(const TDesC &,const TDesC &,const TDesC &)Intended Usage : Creates a simple confirmation dialog with Ok and Cancel (or sim...
• DisplayCancelDialogL(const TDesC &,MWtaiCancelOperationObserver *)Intended Usage : Displays a non-blocking cancel dialog that allows the user to c...
• DisplayConnectingDialogL()Intended Usage : This creates a dialog which indicates that a connection is bein...
• GotMoreUnknownData(MHTTPDataSupplier *)Intended Usage : This method will be called when more unknown data from an exist...
• GotUnknownData(const TDesC &,MHTTPDataSupplier *)Intended Usage : This method is called when unknown data is first recieved and s...
• MDialogProvider_Reserved1()Intended Usage : Function placeholder for BC proofing.
• NoMoreUnknownData(MHTTPDataSupplier *,TInt)Intended Usage : The method is called when an existing unknown data fetch has co...
• PasswordL(TPassword &)Intended Usage : Creates a password dialog for user to enter some hidden text.
• PromptL(const TDesC &,const TDesC &)Intended Usage : This creates an input dialog for the user to enter a text strin...

virtual HBufC* PromptL(const TDesC &aMessage, const TDesC &aDefaultInput)=0;

Description

Intended Usage : This creates an input dialog for the user to enter a text string into a single text field.

Parameters

Return value

virtual void PasswordL(TPassword &aPasswd)=0;

Description

Intended Usage : Creates a password dialog for user to enter some hidden text.

Parameters

virtual TBool ConfirmationL(const TDesC &aMessage, const TDesC &aOkButtonLabel, const TDesC &aCancelButtonLabel)=0;

Description

Intended Usage : Creates a simple confirmation dialog with Ok and Cancel (or similar) buttons. Allows the user to confirm an action or message. Some text is displayed indicating the nature of the action.

Parameters

Return value

virtual TBool CertificateConfirmationL(const RCertificate::TInfo &aCertificateInfo)=0;

Description

Intended Usage : Created a certificate confirmation dialog. Requests that the user accept or reject the displayed certificate.

Parameters

Return value

virtual void AlertL(const TDesC &aMessage)=0;

Description

Intended Usage : Creates an alert dialog to inform the user. A message is displayed and there is an Ok (or similar) button to close the dialog.

Parameters

virtual void DisplayConnectingDialogL()=0;

Pre-Condition

A connecting dialog is not already been created.

Description

Intended Usage : This creates a dialog which indicates that a connection is being done.

Post-Condition

Unspecified

virtual void CancelConnectingDialog()=0;

Description

Intended Usage : Cancels the current connecting dialog.

virtual void DisplayCancelDialogL(const TDesC &aMessage, MWtaiCancelOperationObserver *aCancelOperation)=0;

Pre-Condition

None

Description

Intended Usage : Displays a non-blocking cancel dialog that allows the user to cancel an an operation. When the user cancels the operation, the dialog must close and call the CancelOperation() method provided by the MWtaiPublicCancelOperation object passed in by the object that requires the use of the cancel dialog.

Post-Condition

A non-blocking cancel dialog appears with the paramater text passed into it

Parameters

virtual void CloseCancelDialog()=0;

Pre-Condition

The MDialogProvider::DisplayCancelDialogL(const TDesC &,MWtaiCancelOperationObserver *) method must have been called and the dialog is on display

Description

Intended Usage : This method closes the cancel dialog created from the DisplayCancelDialogL above.

Post-Condition

The cancel dialog closes

virtual TBool GotUnknownData(const TDesC &aMimeType, MHTTPDataSupplier *aDataSupplier)=0;

Pre-Condition

Unknown data content will have begun downloading

Description

Intended Usage : This method is called when unknown data is first recieved and should be handled. Data is recieved in chunks and this method is called when the first chunk has arrived.

Post-Condition

The data will continue downloading if ETrue is returned

Parameters

Return value

virtual void GotMoreUnknownData(MHTTPDataSupplier *aDataSupplier)=0;

Pre-Condition

The first chunk of data has already arrived and MDialogProvider::GotUnknownData(const TDesC &,MHTTPDataSupplier *) method has been called

Description

Intended Usage : This method will be called when more unknown data from an existing fetch has arrived. As the data arrives in chunks, this methos will be called when data arrives after the MDialogProvider::GotUnknownData(const TDesC &,MHTTPDataSupplier *) method has been called.

Parameters

virtual void NoMoreUnknownData(MHTTPDataSupplier *aDataSupplier, TInt aErrorCode)=0;

Pre-Condition

An unknown data fetch has been completed and all data handled

Description

Intended Usage : The method is called when an existing unknown data fetch has completed and no more unknown data is to be expected.

Parameters

virtual void MDialogProvider_Reserved1()=0;

Description

Intended Usage : Function placeholder for BC proofing.