diff -r 666f914201fb -r 2fe1408b6811 epoc32/include/medobsrv.h --- a/epoc32/include/medobsrv.h Tue Nov 24 13:55:44 2009 +0000 +++ b/epoc32/include/medobsrv.h Tue Mar 16 16:12:26 2010 +0000 @@ -1,1 +1,59 @@ -medobsrv.h +// Copyright (c) 1999-2009 Nokia Corporation and/or its subsidiary(-ies). +// All rights reserved. +// This component and the accompanying materials are made available +// under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members +// which accompanies this distribution, and is available +// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html". +// +// Initial Contributors: +// Nokia Corporation - initial contribution. +// +// Contributors: +// +// Description: +// + +#ifndef __MEDOBSRV_H__ +#define __MEDOBSRV_H__ + +#include + + + +class MEditObserver +/** +Specifies the mixin protocol for a rich text edit observer. + +This class is implemented by controls which use a rich text (CRichText) object, +when it is possible for the text object to be changed from outside of the +control without the control's knowledge. + +An edit observer is a callback to the control from the CRichText object which +it has been set up to observe. The edit observer is set up using CRichText::SetEditObserver(). +@publishedAll +@released +*/ + { +public: + // Observer function called by CRichText to signal changes to the text + // buffer within it. A pointer to this function must be passed in to + // a CRichText instance by .SetEditObserver(). + // aStart is the start position of the edit and aExtent is the number + // of characters added or, if negative, deleted after this position. + + + /** Observer function called by the CRichText object when the object is edited + to give notification of changes to its text buffer. In this way, the control + knows how the text object has changed and can reformat and redraw the text + object appropriately. + + A pointer to the observer object must have been passed in to a CRichText instance + using CRichText::SetEditObserver(). + + @param aStart The start position of the edit. + @param aExtent The number of characters added or, if negative, deleted after + this position. */ + virtual void EditObserver(TInt aStart, TInt aExtent) = 0; + }; + +#endif