// Copyright (c) 2008-2009 Nokia Corporation and/or its subsidiary(-ies).

// All rights reserved.

// This component and the accompanying materials are made available

// under the terms of "Eclipse Public License v1.0"

// which accompanies this distribution, and is available

// at the URL "http://www.eclipse.org/legal/epl-v10.html".

//

// Initial Contributors:

// Nokia Corporation - initial contribution.

//

// Contributors:

//

// Description:

//

#ifndef DISPCTRL_CLIENT_H_

#define DISPCTRL_CLIENT_H_

#include <graphics/displaycontrolbase.h>

/**

 * Window Server client interface for display control.

 * 

 * All functions in MDisplayControlBase will automatically flush the client-server

 * session buffer as part of their behavior.

 * 

 * Setting the display configuration successfully shall cause the screen mode

 * index to change to one of the last two entries (dependent on rotation) and that

 * mode's size information shall be updated as necessary.

 * 

 * @publishedPartner

 * @prototype

 */

class MDisplayControl : public MDisplayControlBase

	{

public:

	enum	

		{

		KUidDisplayControl =  0x10286499, 	  //To    0x1028649A

		ETypeId=	 KUidDisplayControl 

		};

public:

	/** 

	 * Returns whether changes in the display will trigger an EEventDisplayChanged 

	 * event to be issued.

	 *

	 * Events will be triggered configuration changes that have taken place on 

	 * the display, when a display has been connected / disconnected (if it can be 

	 * detected), and when the available resolutions change.

	 *

	 * This function always causes a flush of the window server buffer.

	 *	

	 * @return ETrue if display change events are enabled, EFalse otherwise

	 */

	virtual TBool DisplayChangeEventsEnabled() const =0;

	/** 

	 * Determines whether changes in the display will trigger an EEventDisplayChanged 

	 * event to be issued.

	 * 

	 * @see DisplayChangeEventsEnabled

	 * 

	 * @param aEnable ETrue to enable display change events, EFalse to disable them

	 */	

	virtual void EnableDisplayChangeEvents(TBool aEnable) =0;

	};

#endif /*DISPCTRL_CLIENT_H_*/