/*
 * ============================================================================
 *  Name     : ExampleClientAppView.h
 *  Part of  : HTTP Example
 *  Created  : 11/14/2003 by Forum Nokia
 *  Implementation notes:
 *
 *     
 *  Version  : 1.0
 *  Copyright: Nokia Corporation
 * ============================================================================
 */

#ifndef __EXAMPLECLIENT_APPVIEW_H__
#define __EXAMPLECLIENT_APPVIEW_H__

#include <coecntrl.h>
#include <eikrted.h>
#include "ExampleClientEngine.h"

/*
*
* Applications' view. Contains two CEikRichTextEditors for displaying received
* data and status events.
*
*/
class CExampleClientAppView :	public CCoeControl,
								public MCoeControlObserver,
								public MClientObserver
    {
public:
	/*
	* NewL()
	*  
	* Create a CClientEngine object.
	*
	* Params: 
	*		aRect: Extents of the view.
	* 
	* Returns:
	* 		A pointer to the created instance of CExampleClientAppView
	*
	*/
	static CExampleClientAppView* NewL(const TRect& aRect);

	/*
	* NewLC()
	*  
	* Create a CClientEngine object.
	*
	* Params: 
	*		aRect: Extents of the view.
	* 
	* Returns:
	* 		A pointer to the created instance of CExampleClientAppView
	*
	*/
	static CExampleClientAppView* NewLC(const TRect& aRect);

	/*
	* ~CExampleClientAppView()
	* 
	* Destructor of CExampleClientAppView.
	* 
	* Params: 
	*		-
	* 
	* Returns:
	*		-
	*
	*/
	~CExampleClientAppView();

	/*
	* Reset()
	*
	* Resets contents of the view; clears CEikRichTextEditors.
	*
	* Params: 
	*		-
	* 
	* Returns:
	*		-
	*
	*/
	void Reset();

/*
* From CCoeControl
*/
public:  
	/*
	* Draw()
	*  
	* Draws the view.
	*
	* Params: 
	*		aRect:
	* 
	* Returns:
	* 		-
	*
	*/
    void Draw(const TRect& aRect) const;

/*
* From MCoeControlObserver
*/
private:
	/*
	* CountComponentControls()
	*  
	* Gets the number of controls contained in this compound control. 
	*
	* Params: 
	*		-
	* 
	* Returns:
	* 		Number of controls.
	*
	*/
	TInt CountComponentControls() const;

	/*
	* ComponentControl()
	*  
	* Gets the specified component of a compound control. 
	*
	* Params: 
	*		aIndex: 
	* 
	* Returns:
	* 		Pointer to control with index aIndex.
	*
	*/
	CCoeControl* ComponentControl(TInt aIndex) const;

	/*
	* OfferKeyEventL()
	*  
	* Handles key events passed to this control (view).
	*
	* Params:
	*		aKeyEvent: The key event.
	*		aType:	The type of key event: EEventKey, EEventKeyUp or 
	*				EEventKeyDown.
	* 
	* Returns:
	* 		-
	*
	*/
	TKeyResponse OfferKeyEventL(const TKeyEvent& aKeyEvent, TEventCode aType);

	/*
	* HandleControlEventL()
	*  
	* Handles control events.
	*
	* Params: 
	*		aControl: Control
	*		aEventType: Event type
	* 
	* Returns:
	* 		-
	*
	*/
	void HandleControlEventL(	CCoeControl* /* aControl */, 
		TCoeEvent /* aEventType */ );

/*
* From MClientObserver (see ExampleClientEngine.h)
*/
public:
	void ClientEvent(const TDesC& aEventDescription);
	void ClientBodyReceived(const TDesC8& aBodyData);

private:
	/*
	* ConstructL()
	*  
	* Perform the second phase construction of a CExampleClientAppView object.
	*
	* Params: 
	*		aRect: Extents of the view.
	* 
	* Returns:
	* 		-
	*
	*/
    void ConstructL(const TRect& aRect);

	/*
	* CExampleClientAppView()
	*  
	* Perform the first phase of two phase construction.
	*
	* Params: 
	*		-
	* 
	* Returns:
	* 		-
	*
	*/
    CExampleClientAppView();

	/*
	* AddToOutputWindowL()
	*  
	* Adds given text to output window (CEikRichTextEditor, iOutputWindow)
	* Does not format the added text.
	*
	* Params: 
	*		aText: Text to be added.
	* 
	* Returns:
	* 		-
	*
	*/
	void AddToOutputWindowL(const TDesC8& aText);

	/*
	* AddToStatusWindowL()
	*  
	* Adds given text to status window (CEikRichTextEditor, iStatusWindow)
	*
	* Params: 
	*		aText: A single line of text to be added.
	* 
	* Returns:
	* 		-
	*
	*/
	void AddToStatusWindowL(const TDesC& aText);

private:
	CEikRichTextEditor*	iOutputWindow;
	CEikRichTextEditor* iStatusWindow;
};


#endif // __EXAMPLECLIENT_APPVIEW_H__