sl@0: /* sl@0: * Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies). sl@0: * All rights reserved. sl@0: * This component and the accompanying materials are made available sl@0: * under the terms of "Eclipse Public License v1.0" sl@0: * which accompanies this distribution, and is available sl@0: * at the URL "http://www.eclipse.org/legal/epl-v10.html". sl@0: * sl@0: * Initial Contributors: sl@0: * Nokia Corporation - initial contribution. sl@0: * sl@0: * Contributors: sl@0: * sl@0: * Description: sl@0: * sl@0: */ sl@0: sl@0: sl@0: #ifndef __FRMTVIEW_H__ sl@0: #define __FRMTVIEW_H__ sl@0: sl@0: #include sl@0: #include sl@0: #include sl@0: #include sl@0: #include sl@0: sl@0: /** sl@0: Internal class - not part of interface sl@0: @internalComponent sl@0: */ sl@0: class RScreenDisplay sl@0: sl@0: { sl@0: public: sl@0: enum TClippingRects sl@0: { sl@0: EFClipTextArea = 0x0001, sl@0: EFClipLineCursor = 0x0002, sl@0: EFClipExtendedTextArea = 0x0004, sl@0: EFClipViewRect = 0x0008, sl@0: EFClipExtendedViewRect = 0x0010, sl@0: EFClipInvalid = 0x0200, sl@0: EFClipAllFlags = 0xFFFF sl@0: }; sl@0: public: sl@0: RScreenDisplay(TDrawTextLayoutContext* const aDrawTextLayoutContext); sl@0: void Close(); sl@0: void Destroy(); sl@0: void SetWindowsServer(RWsSession *aSession) { iSession = aSession; } sl@0: void SetWindowGroup(RWindowGroup *aWin) { iGroupWin = aWin; } sl@0: sl@0: void SetWindow(RWindow *aWin); sl@0: RWindow* Window() const { return iWin; } sl@0: void SetBitmapContext(CBitmapContext* aGc) { iGc = aGc; } sl@0: CBitmapContext* BitmapContext() const { return iGc; } sl@0: RWsSession* WindowServerSession() { return iSession; } sl@0: void SetGraphicsDeviceL(CBitmapDevice *aGd); sl@0: CBitmapDevice* BitmapDevice() const {return iGd; } sl@0: void CreateContextL(CBitmapDevice *aGd); sl@0: void CreateContextL(); sl@0: void SetInvalidRect(const TRect& aRect); sl@0: void SetInvalidRect(TInt aHeight); sl@0: void SetInvalidRectHorizontal(TInt aWidth); sl@0: void SetRects(TUint aRects); sl@0: TRect LineCursorMargin() const; sl@0: TPoint TopLeftTextArea() const; sl@0: TBool IsLineCursor() const; sl@0: sl@0: void AddRects(TUint aRects); sl@0: void SubRects(TUint aRects); sl@0: TRect ClippingRect(); sl@0: void ResetClippingRect(); sl@0: void Scroll(TRect aRect,const TPoint& aBy,TBool aScrollBackground); sl@0: void Flush(); sl@0: void ClearRect(const TRect& aRect); sl@0: void InvertRect(TRect aRect,const TRgb aInvertColor); sl@0: void SetTextCursor(TPoint aPos, const TTextCursor &aCursor); sl@0: void RemoveTextCursor(); sl@0: void BlastBitmap(const TPoint& aPoint,const CFbsBitmap* aBitmap,const TRect& aRect); sl@0: void DrawPictureFrame(TFrameOverlay* aPictureFrame,const TRect& aLineRect); sl@0: void Invalidate(TRect aRect); sl@0: void ActivateContext(); sl@0: void ActivateContext(CGraphicsContext *aGc); sl@0: void DeactivateContext(); sl@0: void DeactivateContext(CGraphicsContext *aGc); sl@0: void SetLayout(CTextLayout* aLayout); sl@0: CTextLayout* Layout(); sl@0: TBool UseWindowGc() const; sl@0: sl@0: private: sl@0: void DestroyContexts(); sl@0: private: sl@0: RWsSession *iSession; sl@0: RWindowGroup *iGroupWin; sl@0: RWindow *iWin; sl@0: CBitmapContext *iGc; sl@0: CBitmapDevice *iGd; sl@0: TDrawTextLayoutContext* const iDrawTextLayoutContext; sl@0: TUint iRects; sl@0: TRect iInvalidRect; sl@0: TLogicalRgb iBackground; sl@0: CTextLayout* iTextLayout; sl@0: }; sl@0: sl@0: /** Visibility of line and text cursor. sl@0: sl@0: The TVisibility enumeration defined in this class is used in calls to CTextView::SetCursorVisibilityL(). sl@0: The remainder of this class does not form part of the API. sl@0: @internalComponent sl@0: */ sl@0: class TCursor sl@0: { sl@0: public: sl@0: enum TCursors sl@0: { sl@0: EFNeitherCursor = 0, sl@0: EFTextCursor = 1, sl@0: EFLineCursor = 2, sl@0: EFBothCursors = EFTextCursor | EFLineCursor sl@0: }; sl@0: sl@0: /** Cursor visibility */ sl@0: enum TVisibility sl@0: { sl@0: /** Indicates that the cursor should be invisible. */ sl@0: EFCursorInvisible = 0, sl@0: /** Indicates that the cursor should be visible. */ sl@0: EFCursorVisible, sl@0: /** Indicates a flashing text cursor. When specified for the line sl@0: cursor, is equivalent to EFCursorVisible, as the line cursor cannot sl@0: flash. Note that a non-flashing text cursor should only be used when sl@0: there is to be no editing, reformatting, scrolling or cursor movement. sl@0: */ sl@0: EFCursorFlashing sl@0: }; sl@0: sl@0: TCursor(TCursorPosition& aCursorPos,RScreenDisplay& aDisplay); sl@0: void SetLineCursorBitmap(const CFbsBitmap* aLineCursorBitmap); sl@0: inline TUint LineCursorVisibility(); sl@0: inline TUint TextCursorVisibility(); sl@0: void Draw(TUint aCursors); sl@0: sl@0: void SetVisibility(TVisibility aLineCursor,TVisibility aTextCursor); sl@0: void SetType(TTextCursor::EType aType); sl@0: void SetPlacement(TTmCursorPlacement aPlacement); sl@0: void SetAscentAndDescent(TInt aAscent,TInt aDescent); sl@0: void SetWeight(TInt aWeight); sl@0: void SetFlash(TBool aEnabled); sl@0: void SetXorColor(TRgb aColor); sl@0: void MatchCursorHeightToAdjacentChar(); sl@0: void SetExtensions(TInt aFirstExtension, TInt aSecondExtension); sl@0: private: sl@0: enum sl@0: { sl@0: ELineCursorToLabelGap = 2, sl@0: ETextCursorWeight = 3, sl@0: ETextCursorInvertColor = 0xFFFFFF sl@0: }; sl@0: sl@0: void DrawLineCursor(TInt aHeight); sl@0: void RemoveLineCursor(); sl@0: void DrawTextCursor(TPoint aOrigin,TInt aWidth,TInt aAscent,TInt aDescent); sl@0: void RemoveTextCursor(); sl@0: sl@0: RScreenDisplay& iDisplay; // a reference to the object controlling drawing sl@0: TCursorPosition& iCursorPos; // a reference to the object holding the cursor's document position sl@0: TBool iVisible; // TRUE if the text cursor is currently visible in the displayed text sl@0: TBool iFlash; // TRUE if the text cursor should flash sl@0: TVisibility iLineCursor; // line cursor state sl@0: TVisibility iTextCursor; // text cursor state sl@0: const CFbsBitmap* iLineCursorBitmap; // if non-null, points to a non-owned bitmap representing the line cursor sl@0: TInt iAscent; // if non-negative, ascent used for vertical cursors sl@0: TInt iDescent; // if non-negative, descent used for vertical cursors sl@0: TInt iWeight; // width of vertical cursors, height of horizontal ones sl@0: TTextCursor::EType iType; // filled or hollow rectangle, etc. sl@0: TRgb iXorColor; // colour XORed with the background when the cursor is drawn sl@0: TTmCursorPlacement iPlacement; // vertical, underline, etc. sl@0: TInt iFirstExtension; // customise the cursor, extends vertical cursors upwards, horizontal cursors leftwards sl@0: TInt iSecondExtension; // customise the cursor, extends vertical cursors downwards, horizontal cursors rightwards sl@0: TInt iReserved[2]; sl@0: }; sl@0: sl@0: /** sl@0: Lays out formatted text for display. sl@0: sl@0: The class provides functions to: sl@0: sl@0: convert between document positions and x,y coordinates sl@0: sl@0: set the dimensions of the rectangle in which text can be viewed (the view sl@0: rectangle) sl@0: sl@0: set margin widths sl@0: sl@0: do horizontal and vertical scrolling sl@0: sl@0: do text selection sl@0: sl@0: set the cursor position and appearance sl@0: sl@0: After a change has been made to the text layout, a reformat and redraw should sl@0: normally take place. CTextView provides functions which are optimised to reformat sl@0: the minimum amount necessary. For example, when a global formatting parameter sl@0: is changed (e.g. the wrap width), the whole document's layout needs to be sl@0: recalculated, so HandleGlobalChangeL() should be called. If the change involves sl@0: the insertion or deletion of a single character, only a single line may be sl@0: affected; for this, HandleCharEditL() is appropriate. Most CTextView reformatting sl@0: functions do scrolling (using block transfer), if necessary, and a redraw. sl@0: sl@0: For maximum responsiveness, CTextView uses an active object to carry out sl@0: reformatting as a background task, so that the application can continue to sl@0: receive user input. Many CTextView functions force background formatting to sl@0: complete before they take effect. sl@0: sl@0: When scrolling vertically, positive numbers of pixels, lines, paragraphs, sl@0: pages, etc., mean that the text moves down, and vice versa. When scrolling sl@0: horizontally, positive numbers of pixels mean that the text moves left and sl@0: vice versa. sl@0: sl@0: A text view can display up to two cursors and up to three margins. The cursors sl@0: are the text cursor and the line cursor. The purpose of the line cursor is sl@0: to make it easier to see which line the text cursor (or the selection extension sl@0: point) is on. The three margins are the label margin (for paragraph labels), sl@0: the line cursor margin (for the line cursor) and the left text margin (the sl@0: gap between the edge of the page and the text). All are optional, but if present, sl@0: they appear in that order, starting at the left edge of the view rectangle. sl@0: sl@0: An object of class CTextLayout is used by the text view to calculate changes sl@0: to the layout. This object must be specified when constructing the text view. sl@0: It is also used to set layout attributes, including the wrap width, the height sl@0: of the visible portion of the document (the "band"), whether formatting is sl@0: set to the band or to the whole document and the text object which is the sl@0: source of the text and formatting information. sl@0: sl@0: The x-y pixel coordinates used by CTextView are called window coordinates. sl@0: Window coordinates have their origin at the top left corner of the view window sl@0: (unlike class CTextLayout whose coordinates have their origin at the top left sl@0: corner of the area within the view rectangle in which text can appear). As sl@0: in most bitmap graphics systems, x coordinates increase rightwards and y coordinates sl@0: increase downwards. sl@0: @publishedAll sl@0: @released sl@0: */ sl@0: class CTextView : public CBase sl@0: sl@0: { sl@0: friend class CTestTextView; sl@0: public: sl@0: enum TPriorities sl@0: { sl@0: EFBackgroundFormattingPriority = (CActive::EPriorityIdle + CActive::EPriorityLow) / 2 sl@0: }; sl@0: sl@0: /** deprecated 8.0 */ sl@0: enum sl@0: { sl@0: EFFirstCharOnLine = -1000000, sl@0: EFLastCharOnLine = 1000000 sl@0: }; sl@0: sl@0: /** Cursor height matching. sl@0: sl@0: Passed as an argument to MatchCursorHeightToAdjacentChar(). */ sl@0: enum TBeforeAfter sl@0: { sl@0: /** Text cursor height is matched to preceding character. */ sl@0: EFCharacterBefore = ETrue, sl@0: /** Text cursor height is matched to following character. */ sl@0: EFCharacterAfter = EFalse sl@0: }; sl@0: sl@0: sl@0: sl@0: /** Whether to reformat and redraw. Argument to SetViewL(). */ sl@0: enum TDiscard sl@0: { sl@0: /** Discard all formatting; redraw. */ sl@0: EFViewDiscardAllFormat, sl@0: /** Do not discard all formatting; redraw. */ sl@0: EFViewDontDiscardFormat, sl@0: /** Discard all formatting; no redraw. */ sl@0: EFViewDiscardAllNoRedraw, sl@0: /** Do not discard all formatting; redraw. */ sl@0: EFViewDontDiscardFullRedraw sl@0: }; sl@0: sl@0: /** sl@0: Provides notification to the owner of the text view object of changes to the sl@0: formatting. sl@0: sl@0: Its OnReformatL() function is called after reformatting but before redisplay, sl@0: so that edit windows etc. can be resized. sl@0: @publishedAll sl@0: @released sl@0: */ sl@0: class MObserver sl@0: sl@0: { sl@0: public: sl@0: sl@0: /** Called after reformatting but before redisplay, so that the height of edit windows, etc., sl@0: can be adjusted. There is no need to adjust the width of displaying components as formatting sl@0: is always done to fit the specified width. sl@0: Implementers are not allowed to call any formatting functions while handling reformatting sl@0: notifications as it may cause recursive loops leading to unexpected consequences. sl@0: @param aTextView A pointer to the current text view object. */ sl@0: virtual void OnReformatL(const CTextView* aTextView) = 0; sl@0: }; sl@0: sl@0: // argument to SetViewL sl@0: enum TDoHorizontalScroll sl@0: { sl@0: EFNoHorizontalScroll = EFalse, sl@0: EFCheckForHorizontalScroll = ETrue sl@0: }; sl@0: sl@0: sl@0: /** sl@0: A standard inquiry interface for the text formatting engine, built on sl@0: top of a CTextView object. sl@0: sl@0: To use it, construct a TTagmaForwarder object, then call InitL(), which sl@0: finishes background formatting, then call the MTmTextLayoutForwarder sl@0: functions. sl@0: sl@0: The class should only be used internally by FORM component. sl@0: @publishedAll sl@0: @released sl@0: */ sl@0: class TTagmaForwarder: public MTmTextLayoutForwarder sl@0: sl@0: { sl@0: public: sl@0: inline TTagmaForwarder(); sl@0: inline void InitL(CTextView* aView); sl@0: sl@0: private: sl@0: // from MTmTextLayoutForwarder sl@0: inline const CTmTextLayout& TextLayout() const; sl@0: inline void GetOrigin(TPoint& aPoint) const; sl@0: sl@0: CTextView* iView; sl@0: }; sl@0: sl@0: private: sl@0: enum TDrawParameters sl@0: { sl@0: EFDrawAllWindow = CLayoutData::EFLargeNumber // must be larger than the pixel height of any window. sl@0: }; sl@0: sl@0: // bit values used in iFlags sl@0: enum sl@0: { sl@0: EFSelectionVisible = 1, sl@0: EFPictureFrameEnabled = 2, sl@0: EFEverythingVisible = 3, sl@0: EFFlickerFreeRedraw = 4, sl@0: EFTextVisible = 8 sl@0: }; sl@0: sl@0: // horizontal scroll jump in pixels sl@0: enum THorizontalScrollJump sl@0: { sl@0: EFDefaultHorizontalScrollJump = 20 sl@0: #ifdef _DEBUG sl@0: ,EFUnreasonablyLargeHorizontalScrollJump = 10000 sl@0: #endif sl@0: }; sl@0: sl@0: // picture frame blob widths in pixels sl@0: enum TPictureFrameBlobWidths sl@0: { sl@0: EFFrameVisibleBlobWidth = 10, sl@0: EFFrameActiveBlobWidth = 20 sl@0: }; sl@0: sl@0: enum THorizontalScroll sl@0: { sl@0: EFNoPreviousHorizontalScroll = 0, sl@0: EFPreviousHorizontalScroll sl@0: }; sl@0: sl@0: enum TMemoryStatus sl@0: { sl@0: EFMemoryOK, sl@0: EFOutOfMemory, sl@0: EFRecovering sl@0: }; sl@0: sl@0: enum TExtendedHighlightRedraw sl@0: { sl@0: EFTopEdge = 0x0001, sl@0: EFBottomEdge = 0x0002 sl@0: }; sl@0: sl@0: sl@0: public: sl@0: IMPORT_C static CTextView *NewL(CTextLayout* aLayout,const TRect &aDisplay,CBitmapDevice* aGd, sl@0: MGraphicsDeviceMap* aDeviceMap,RWindow* aWin,RWindowGroup* aGroupWin, sl@0: RWsSession* aSession); sl@0: IMPORT_C ~CTextView(); sl@0: IMPORT_C void SetDisplayContextL(CBitmapDevice* aGd,RWindow* aWin,RWindowGroup* aGroupWin,RWsSession* aSession); sl@0: IMPORT_C void SetLayout(CTextLayout* aLayout); sl@0: inline const CTextLayout* Layout() const; sl@0: IMPORT_C void SetViewRect(const TRect& aDisplay); sl@0: IMPORT_C void AlterViewRect(const TRect &aViewRect); sl@0: IMPORT_C void SetMarginWidths(TInt aLabels,TInt aLineCursor); sl@0: IMPORT_C void SetHorizontalScrollJump(TInt aScrollJump); sl@0: IMPORT_C void SetLineCursorBitmap(const CFbsBitmap* aLineCursorBitmap); sl@0: IMPORT_C void SetHighlightExtensions(TInt aLeftExtension, TInt aRightExtension, TInt aTopExtension, TInt aBottomExtension); sl@0: IMPORT_C void SetExcessHeightRequired(TInt aExcessHeightRequired); sl@0: IMPORT_C void SetBackgroundColor(TRgb aColor); sl@0: IMPORT_C void SetTextColorOverride(const TRgb* aOverrideColor = NULL); sl@0: IMPORT_C void SetCursorVisibilityL(TUint aLineCursor,TUint aTextCursor); sl@0: IMPORT_C void SetSelectionVisibilityL(TBool aSelectionVisible); sl@0: IMPORT_C TBool SelectionVisible() const; sl@0: IMPORT_C void EnablePictureFrameL(TBool aEnabled); sl@0: IMPORT_C const TRect& ViewRect() const; sl@0: IMPORT_C const TRect& AlteredViewRect() const; sl@0: IMPORT_C void MarginWidths(TInt& aLabels,TInt& aLineCursor) const; sl@0: IMPORT_C TInt HorizontalScrollJump() const; sl@0: IMPORT_C TInt LeftTextMargin() const; sl@0: IMPORT_C void SetLatentXPosition(TInt aLatentX); sl@0: // deprecated 7.0 sl@0: IMPORT_C void SetParagraphFillTextOnly(TBool aFillTextOnly); sl@0: IMPORT_C void SetCursorWidthTypeL(TTextCursor::EType aType,TInt aWidth = 0); sl@0: IMPORT_C void SetCursorPlacement(TTmCursorPlacement aPlacement); sl@0: IMPORT_C void SetCursorWeight(TInt aWeight); sl@0: IMPORT_C void SetCursorFlash(TBool aEnabled); sl@0: IMPORT_C void SetCursorXorColor(TRgb aColor); sl@0: IMPORT_C void SetCursorExtensions(TInt aFirstExtension, TInt aSecondExtension); sl@0: IMPORT_C TCursorSelection Selection() const; sl@0: IMPORT_C TBool IsPictureFrameSelected(TRect& aPictureFrameRect,TInt& aDocPos) const; sl@0: IMPORT_C TBool GetPictureRectangleL(TInt aDocPos,TRect& aPictureRect,TBool* aCanScaleOrCrop = NULL) const; sl@0: IMPORT_C TBool GetPictureRectangleL(TPoint aXyPos,TRect& aPictureRect,TBool* aCanScaleOrCrop = NULL); sl@0: IMPORT_C TBool FindXyPosL(const TPoint& aXyPos,TTmPosInfo2& aPosInfo,TTmLineInfo* aLineInfo = NULL); sl@0: IMPORT_C TInt XyPosToDocPosL(TPoint& aPoint); sl@0: IMPORT_C TBool FindDocPosL(const TTmDocPosSpec& aDocPos,TTmPosInfo2& aPosInfo,TTmLineInfo* aLineInfo = NULL); sl@0: IMPORT_C TBool DocPosToXyPosL(TInt aDocPos,TPoint& aPoint); sl@0: IMPORT_C TRect ParagraphRectL(TInt aDocPos) const; sl@0: IMPORT_C void CalculateHorizontalExtremesL(TInt& aLeftX,TInt& aRightX,TBool aOnlyVisibleLines); sl@0: IMPORT_C void MatchCursorHeightL(const TFontSpec& aFontSpec); sl@0: IMPORT_C void MatchCursorHeightToAdjacentChar(TBeforeAfter aBasedOn = EFCharacterBefore); sl@0: IMPORT_C TPoint SetSelectionL(const TCursorSelection& aSelection); sl@0: IMPORT_C void CancelSelectionL(); sl@0: IMPORT_C void ClearSelectionL(); sl@0: IMPORT_C TPoint SetDocPosL(const TTmDocPosSpec& aDocPos,TBool aDragSelectOn = EFalse); sl@0: IMPORT_C TPoint SetDocPosL(TInt aDocPos,TBool aDragSelectOn = EFalse); sl@0: IMPORT_C TPoint SetXyPosL(TPoint aPos,TBool aDragSelectOn,TRect*& aPictureRect,TInt& aPictureFrameEdges); sl@0: IMPORT_C TPoint MoveCursorL(TCursorPosition::TMovementType& aMovement,TBool aDragSelectOn); sl@0: IMPORT_C TInt ScrollDisplayL(TCursorPosition::TMovementType aMovement, sl@0: CTextLayout::TAllowDisallow aScrollBlankSpace=CTextLayout::EFDisallowScrollingBlankSpace); sl@0: IMPORT_C TPoint SetViewLineAtTopL(TInt aLineNo); sl@0: IMPORT_C void ScrollDisplayPixelsL(TInt& aDeltaY); sl@0: IMPORT_C void ScrollDisplayPixelsNoLimitBorderL(TInt aDeltaY); sl@0: IMPORT_C TInt ScrollDisplayLinesL(TInt& aDeltaLines, sl@0: CTextLayout::TAllowDisallow aScrollBlankSpace = CTextLayout::EFDisallowScrollingBlankSpace); sl@0: IMPORT_C TInt ScrollDisplayParagraphsL(TInt& aDeltaParas, sl@0: CTextLayout::TAllowDisallow aScrollBlankSpace = CTextLayout::EFDisallowScrollingBlankSpace); sl@0: IMPORT_C TPoint SetViewL(TInt aDocPos,TInt& aYPos,TViewYPosQualifier aYPosQualifier = TViewYPosQualifier(), sl@0: TDiscard aDiscardFormat = EFViewDontDiscardFormat, sl@0: TDoHorizontalScroll aDoHorizontalScroll = EFCheckForHorizontalScroll); sl@0: IMPORT_C void SetLeftTextMargin(TInt aLeftMargin); sl@0: IMPORT_C void DrawL(TRect aRect); sl@0: IMPORT_C void DrawL(TRect aRect,CBitmapContext& aGc); sl@0: inline void SetObserver(MObserver* aObserver); sl@0: IMPORT_C void SetPendingSelection(const TCursorSelection& aSelection); sl@0: inline void EnableFlickerFreeRedraw(); sl@0: inline void DisableFlickerFreeRedraw(); sl@0: inline TBool FlickerFreeRedraw() const; sl@0: inline void GetOrigin(TPoint& aPoint) const; sl@0: IMPORT_C TCursorSelection GetForwardDeletePositionL(); sl@0: IMPORT_C TCursorSelection GetBackwardDeletePositionL(); sl@0: sl@0: // reformatting after changes to the content sl@0: IMPORT_C void FormatTextL(); sl@0: IMPORT_C TInt HandleCharEditL(TUint aType = CTextLayout::EFCharacterInsert,TBool aFormatChanged = EFalse); sl@0: IMPORT_C TPoint HandleRangeFormatChangeL(TCursorSelection aSelection,TBool aFormatChanged = EFalse); sl@0: IMPORT_C TPoint HandleInsertDeleteL(TCursorSelection aSelection,TInt aDeletedChars,TBool aFormatChanged = EFalse); sl@0: IMPORT_C void HandleGlobalChangeL(TViewYPosQualifier aYPosQualifier = TViewYPosQualifier()); sl@0: IMPORT_C void HandleGlobalChangeNoRedrawL(TViewYPosQualifier aYPosQualifier = TViewYPosQualifier()); sl@0: IMPORT_C void HandleAdditionalCharactersAtEndL(); sl@0: IMPORT_C void FinishBackgroundFormattingL(); sl@0: sl@0: IMPORT_C CBitmapContext* BitmapContext(); sl@0: IMPORT_C const TTmDocPos& VisualEndOfRunL( sl@0: const TTmDocPos& aStart, const TTmDocPos& aEnd, sl@0: TCursorPosition::TVisualEnd aDirection); sl@0: IMPORT_C void GetCursorPos(TTmDocPos& aPos) const; sl@0: sl@0: IMPORT_C TPoint SetDocPosL(const TTmDocPos& aDocPos,TBool aDragSelectOn = EFalse); sl@0: sl@0: IMPORT_C void SetCursorPositioningHintL(TCursorPosition::TPosHint aHint); sl@0: sl@0: IMPORT_C void SetOpaque(TBool aDrawOpaque); sl@0: IMPORT_C void MakeVisible(TBool aVisible); sl@0: sl@0: private: sl@0: IMPORT_C static TInt IdleL(TAny *aSelf); sl@0: IMPORT_C CTextView(); sl@0: IMPORT_C void ConstructL(CTextLayout* aLayout,const TRect &aDisplay,CBitmapDevice* aGd,MGraphicsDeviceMap* aDeviceMap, sl@0: RWindow* aWin,RWindowGroup* aGroupWin,RWsSession* aSession); sl@0: inline TInt TopViewRect() const; sl@0: inline TBool IsFormatting() const; sl@0: TBool NoMemoryCheckL(); sl@0: void StartIdleObject(); sl@0: inline void DrawWithPreviousHighlight(); sl@0: inline void DrawWithCurrentHighlight(); sl@0: TInt CalculateBaseLinePos(TTmDocPos& aDocPos); sl@0: TInt DrawAfterCursorMoveL(TInt aVerticalScrollBy); sl@0: TBool NextLineL(); sl@0: void ClearRectAtBottom(TInt aHeight); sl@0: void DrawTextL(TInt aFromHeight = 0,TInt aToHeight = EFDrawAllWindow); sl@0: void DisplayNewLinesL(TInt aFrom,TInt aTo); sl@0: void DrawCursor(TUint aCursors = TCursor::EFBothCursors); sl@0: TPoint DoMoveCursorL(TBool aDragSelectOn,TCursorPosition::TMovementType& aMovement,TBool aAllowPictureFrame); sl@0: void ScrollTextL(TInt aScrollY,TInt aFrom,TInt aScrollX,TBool aScrollBackground); sl@0: void ScrollRect(TRect& aRect,TInt aScrollY,TInt aFrom,TInt aScrollX,TBool aScrollBackground); sl@0: void ScrollRect(TInt aScrollY,TInt& aFrom,TInt& aTo); sl@0: TPoint HandleBlockChangeL(TCursorSelection aSelection,TInt aOldCharsChanged,TBool aFormatChanged); sl@0: void CheckScrollUpL(); sl@0: TInt CheckHorizontalScroll(const TTmDocPos& aDocPos); sl@0: TInt DoHorizontalScrollDisplayL(TCursorPosition::TMovementType aMovement, sl@0: CTextLayout::TAllowDisallow aScrollBlankSpace); sl@0: TInt DoScrollDisplayL(TCursorPosition::TMovementType aMovement,CTextLayout::TAllowDisallow aScrollBlankSpace); sl@0: void ScrollDisplayL(); sl@0: TPoint ViewTopOfLineL(const TTmDocPos& aDocPos,TInt& aYPos, sl@0: CTextView::TDiscard aDiscardFormat = EFViewDontDiscardFormat, sl@0: TDoHorizontalScroll aHorizontalScroll = EFCheckForHorizontalScroll); sl@0: TPoint ViewL(const TTmDocPos& aDocPos,TInt& aYPos,TViewYPosQualifier aYPosQualifier = TViewYPosQualifier(), sl@0: CTextView::TDiscard aDiscardFormat = EFViewDontDiscardFormat, sl@0: TDoHorizontalScroll aHorizontalScroll = EFCheckForHorizontalScroll); sl@0: TPoint DoHandleGlobalChangeL(TViewYPosQualifier aYPosQualifier,CTextView::TDiscard aDiscard); sl@0: void UpdateHighlightL(); sl@0: void HighlightUsingExtensions(CTextLayout::TRangeChange aOptimizedRange, CTextLayout::TRangeChange aOriginalRange); sl@0: void UpdatePictureFrameL(); sl@0: void RedrawPictureFrameRectL(TInt aPos); sl@0: void DrawPictureFrameL(TRect& aClipRect); sl@0: void DestroyWindowServerObjects(); sl@0: void NoMemoryL(TInt aErr); sl@0: void RecoverNoMemoryL(); sl@0: void RecreateWindowServerObjectsL(); sl@0: void DrawTextSupportL(const TRect& aRect,const TCursorSelection* aHighlight); sl@0: void DoDrawTextSupportL(const TRect& aRect,const TCursorSelection* aHighlight); sl@0: void DoDrawTextSupportOpaqueL(const TRect& aRect,const TCursorSelection* aHighlight); sl@0: void DisplayLineRangeL(TInt aFrom,TInt aTo); sl@0: inline void NotifyReformatL(); sl@0: void CalculateHorizontalExtremes(TInt& aLeftX,TInt& aRightX,TBool aOnlyVisibleLines); sl@0: TBool ExtendedHighlightExists() const; sl@0: void DoClearSelectionL(const TCursorSelection& aSelection, TBool aIsPictureFrame); sl@0: void AdjustRectForScrolling(TRect &aRect, TInt aScrollY, TInt aScrollX) const; sl@0: static void ResetOffScreenBitmapContext(TAny* aTextView); sl@0: static void ResetExternalDraw(TAny* aTextView); sl@0: sl@0: private: sl@0: CIdle* iWrap; sl@0: RScreenDisplay iDisplay; sl@0: CTextLayout* iLayout; // must not be moved sl@0: TDrawTextLayoutContext iDrawTextLayoutContext; // must not be moved sl@0: TCursor iCursor; sl@0: TCursorPosition iCursorPos; // must not be moved sl@0: TFrameOverlay* iPictureFrame; sl@0: TMemoryStatus iNoMemory; sl@0: TUint iFlags; // must not be moved sl@0: TUint iHorizontalScroll; sl@0: TInt iGood; sl@0: TInt iFormattedUpTo; sl@0: TInt iHorizontalScrollJump; sl@0: TInt iHeightNotDrawn; sl@0: MObserver* iObserver; // must not be moved sl@0: CBitmapContext* iOffScreenContext; //Explicit off-screen bitmap to draw to. sl@0: TRect iReducedDrawingAreaRect; sl@0: TUint iDummy;// was iRedrawExtendedHighlight; sl@0: TBool iContextIsNavigation; sl@0: TBool iDrawOpaque; sl@0: }; sl@0: sl@0: inline TUint TCursor::LineCursorVisibility() sl@0: { sl@0: return iLineCursor; sl@0: } sl@0: sl@0: inline TUint TCursor::TextCursorVisibility() sl@0: { sl@0: return iTextCursor; sl@0: } sl@0: sl@0: /** Returns a pointer to the text layout object used by the text view. sl@0: @return A pointer to the text layout object used by the text view. */ sl@0: inline const CTextLayout* CTextView::Layout() const sl@0: { sl@0: return iLayout; sl@0: } sl@0: sl@0: /** Sets a text view observer. This provides notification to the owner of the sl@0: text view object of changes to the formatting. Its OnReformatL() function is sl@0: called after reformatting but before redisplay, so that edit windows etc. can sl@0: be resized. sl@0: sl@0: @param aObserver Pointer to text view observer object. */ sl@0: inline void CTextView::SetObserver(MObserver* aObserver) sl@0: { sl@0: iObserver = aObserver; sl@0: } sl@0: sl@0: inline void CTextView::EnableFlickerFreeRedraw() sl@0: { sl@0: iFlags |= EFFlickerFreeRedraw; sl@0: } sl@0: sl@0: inline void CTextView::DisableFlickerFreeRedraw() sl@0: { sl@0: iFlags &= ~EFFlickerFreeRedraw; sl@0: } sl@0: sl@0: inline TBool CTextView::FlickerFreeRedraw() const sl@0: { sl@0: return iFlags & EFFlickerFreeRedraw; sl@0: } sl@0: sl@0: inline void CTextView::NotifyReformatL() sl@0: { sl@0: if (iObserver) sl@0: iObserver->OnReformatL(this); sl@0: } sl@0: sl@0: inline TBool CTextView::IsFormatting() const sl@0: { sl@0: return iLayout->IsBackgroundFormatting(); sl@0: } sl@0: sl@0: inline TInt CTextView::TopViewRect() const sl@0: { sl@0: return iDrawTextLayoutContext.iViewRect.iTl.iY; sl@0: } sl@0: sl@0: inline void CTextView::DrawWithPreviousHighlight() sl@0: { sl@0: iCursorPos.SetToPreviousHighlight(); sl@0: } sl@0: sl@0: inline void CTextView::DrawWithCurrentHighlight() sl@0: { sl@0: iCursorPos.SetToCurrentHighlight(); sl@0: } sl@0: sl@0: /** Gets the origin of the cursor. sl@0: @param aPoint On return, the cursor origin. */ sl@0: inline void CTextView::GetOrigin(TPoint& aPoint) const sl@0: { sl@0: iLayout->GetOrigin(aPoint); sl@0: aPoint += iDrawTextLayoutContext.TopLeftText(); sl@0: } sl@0: sl@0: /** This constructor deliberately does not take a pointer or reference to sl@0: CTextView, to prevent the class from being used unless InitL() is called. */ sl@0: inline CTextView::TTagmaForwarder::TTagmaForwarder(): sl@0: iView(NULL) sl@0: { sl@0: } sl@0: sl@0: /** Called after construction, to complete background reformatting. sl@0: @param aView A pointer to the text view object. */ sl@0: inline void CTextView::TTagmaForwarder::InitL(CTextView* aView) sl@0: { sl@0: iView = aView; sl@0: iView->FinishBackgroundFormattingL(); sl@0: } sl@0: sl@0: inline const CTmTextLayout& CTextView::TTagmaForwarder::TextLayout() const sl@0: { sl@0: return iView->Layout()->TagmaTextLayout(); sl@0: } sl@0: sl@0: inline void CTextView::TTagmaForwarder::GetOrigin(TPoint& aPoint) const sl@0: { sl@0: iView->GetOrigin(aPoint); sl@0: } sl@0: sl@0: #endif