/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */ /* * This file is part of the LibreOffice project. * * This Source Code Form is subject to the terms of the Mozilla Public * License, v. 2.0. If a copy of the MPL was not distributed with this * file, You can obtain one at http://mozilla.org/MPL/2.0/. * * This file incorporates work covered by the following license notice: * * Licensed to the Apache Software Foundation (ASF) under one or more * contributor license agreements. See the NOTICE file distributed * with this work for additional information regarding copyright * ownership. The ASF licenses this file to you under the Apache * License, Version 2.0 (the "License"); you may not use this file * except in compliance with the License. You may obtain a copy of * the License at http://www.apache.org/licenses/LICENSE-2.0 . */ #ifndef INCLUDED_SW_INC_VIEWSH_HXX #define INCLUDED_SW_INC_VIEWSH_HXX #include #include #include #include "swdllapi.h" #include #include #include #include #include #include #include #include #define LOK_USE_UNSTABLE_API #include namespace com { namespace sun { namespace star { namespace accessibility { class XAccessible; } } } } class SwDoc; class IDocumentSettingAccess; class IDocumentDeviceAccess; class IDocumentMarkAccess; class IDocumentDrawModelAccess; class IDocumentRedlineAccess; class IDocumentLayoutAccess; class IDocumentFieldsAccess; class IDocumentContentOperations; class IDocumentStylePoolAccess; class IDocumentStatistics; class IDocumentUndoRedo; class IDocumentListItems; class IDocumentOutlineNodes; class SfxPrinter; class SfxProgress; class SwRootFrm; class SwNodes; class SdrView; class SfxItemPool; class SfxViewShell; class SwViewOption; class SwViewShellImp; class SwPrintData; class SwPagePreviewPrtData; namespace vcl { class Window; } class OutputDevice; class SwLayIdle; struct ShellResource; class SwRegionRects; class SwFrm; class SvtAccessibilityOptions; class SwPagePreviewLayout; class SwTextFrm; class BitmapEx; struct SwAccessibilityOptions; namespace vcl { class Region; } class SwPostItMgr; class SdrPaintWindow; class SwAccessibleMap; namespace vcl { typedef OutputDevice RenderContext; class OldStylePrintAdaptor; } // Define for flags needed in ctor or layers below. // Currently the Preview flag is needed for DrawPage. #define VSHELLFLAG_ISPREVIEW ((long)0x1) #define VSHELLFLAG_SHARELAYOUT ((long)0x2) typedef std::shared_ptr SwRootFrmPtr; class SwViewShell; class SW_DLLPUBLIC SwViewShell : public sw::Ring { friend void SetOutDev( SwViewShell *pSh, OutputDevice *pOut ); friend void SetOutDevAndWin( SwViewShell *pSh, OutputDevice *pOut, vcl::Window *pWin, sal_uInt16 nZoom ); friend class SwViewShellImp; friend class SwLayIdle; // For setting visible area for page preview paint. friend class SwPagePreviewLayout; // Set SwVisArea in order to enable clean formatting before printing. friend void SetSwVisArea( SwViewShell *pSh, const SwRect & ); static BitmapEx* mpReplaceBmp; ///< replaced display of still loaded images static BitmapEx* mpErrorBmp; ///< error display of missed images static bool mbLstAct; // true if EndAction of last Shell // i.e. if the EndActions of the other // Shells on the document are through. Point maPrtOffst; // Ofst for Printer, // non-printable margin. Size maBrowseBorder; // Border for frame documents. SwRect maInvalidRect; SfxViewShell *mpSfxViewShell; SwViewShellImp *mpImp; // Core-internals of SwViewShell. // The pointer is never 0. VclPtr mpWin; ///< = 0 during printing or pdf export VclPtr mpOut; ///< Window, Printer, VirtDev, ... VclPtr mpTmpRef; // Temporariy reference device. Is used // during (printer depending) prospect // and page preview printing // (because a scaling has to be set at // the original printer) SwViewOption *mpOpt; SwAccessibilityOptions* mpAccOptions; bool mbDocSizeChgd :1; // For DocChgNotify(): Announce new DocSize // at EndAction to DocMDI. bool mbPaintWorks :1; // Normal Painting if true, // remember Paint if false. bool mbPaintInProgress :1; // Block any double paint. bool mbViewLocked :1; // Lock visible range; // in this case MakeVisible is ineffectual. bool mbInEndAction :1; // Avoid problems, cf. viewsh.cxx. bool mbPreview :1; // If true it is a Preview-SwViewShell. bool mbFrameView :1; // If true it is a (HTML-)Frame. bool mbEnableSmooth :1; // Disable SmoothScroll, e.g. for drag // of scrollbars. bool mbEndActionByVirDev:1; // Paints from EndAction always via virtual device // (e.g. when browsing). bool mbShowHeaderSeparator:1; ///< Flag to say that we are showing the header control bool mbShowFooterSeparator:1; ///< Flag to say that we are showing the footer control bool mbHeaderFooterEdit:1; ///< Flag to say that we are editing header or footer (according to the bShow(Header|Footer)Separator above) // boolean, indicating that class in constructor. bool mbInConstructor:1; SdrPaintWindow* mpTargetPaintWindow; VclPtr mpBufferedOut; SwRootFrmPtr mpLayout; // Initialization; called by the diverse constructors. SAL_DLLPRIVATE void Init( const SwViewOption *pNewOpt ); inline void ResetInvalidRect(); SAL_DLLPRIVATE void Reformat(); // Invalidates complete Layout (ApplyViewOption). SAL_DLLPRIVATE void PaintDesktop(vcl::RenderContext& rRenderContext, const SwRect&); // Collect values for painting of desktop // and calling. // PaintDesktop split. This pars is also used by PreviewPage. SAL_DLLPRIVATE void _PaintDesktop(vcl::RenderContext& rRenderContext, const SwRegionRects &rRegion); SAL_DLLPRIVATE bool CheckInvalidForPaint( const SwRect & ); // Direct Paint or rather // trigger an action. SAL_DLLPRIVATE void PrepareForPrint( const SwPrintData &rOptions ); SAL_DLLPRIVATE void ImplApplyViewOptions( const SwViewOption &rOpt ); protected: static ShellResource* mpShellRes; ///< Resources for the Shell. static VclPtr mpCareWindow; ///< Avoid this window. SwRect maVisArea; ///< The modern version of VisArea. SwDoc *mpDoc; ///< The document; never 0. sal_uInt16 mnStartAction; ///< != 0 if at least one Action is active. sal_uInt16 mnLockPaint; ///< != 0 if Paint is locked. bool mbSelectAll; ///< Special select all mode: whole document selected, even if doc starts with table. bool mbInLibreOfficeKitCallback; /// The virtual device we paint to will end up on the screen. bool mbOutputToWindow; public: TYPEINFO(); SwViewShellImp *Imp() { return mpImp; } const SwViewShellImp *Imp() const { return mpImp; } const SwNodes& GetNodes() const; // After change of printer; by Doc. void InitPrt( OutputDevice *pOutDev ); // Bracketing of actions belonging together. inline void StartAction(); void ImplStartAction(); inline void EndAction( const bool bIdleEnd = false ); void ImplEndAction( const bool bIdleEnd = false ); sal_uInt16 ActionCount() const { return mnStartAction; } bool ActionPend() const { return mnStartAction != 0; } bool IsInEndAction() const { return mbInEndAction; } void SetEndActionByVirDev( bool b ) { mbEndActionByVirDev = b; } bool IsEndActionByVirDev() { return mbEndActionByVirDev; } // The ActionCount for all Shells is temporarily set to zero and then // restored at the RootFrame via UNO. void SetRestoreActions(sal_uInt16 nSet); sal_uInt16 GetRestoreActions() const; inline bool HasInvalidRect() const { return maInvalidRect.HasArea(); } void ChgHyphenation() { Reformat(); } void ChgNumberDigits(); bool AddPaintRect( const SwRect &rRect ); void InvalidateWindows( const SwRect &rRect ); // #i72754# set of Pre/PostPaints with lock counter and initial target OutDev protected: std::stack mPrePostPaintRegions; // acts also as a lock counter (empty == not locked) VclPtr mpPrePostOutDev; MapMode maPrePostMapMode; public: void PrePaint(); void DLPrePaint2(const vcl::Region& rRegion); void DLPostPaint2(bool bPaintFormLayer); const MapMode& getPrePostMapMode() const { return maPrePostMapMode; } virtual void Paint(vcl::RenderContext& rRenderContext, const Rectangle &rRect); /** Paint tile. Sets the pOut so that the rRect is always painted over the entire pOut, ie. starts in 0,0 and ends in width/height. */ void PaintTile(VirtualDevice &rDevice, int contextWidth, int contextHeight, int tilePosX, int tilePosY, long tileWidth, long tileHeight); bool IsPaintInProgress() const { return mbPaintInProgress; } bool IsDrawingLayerPaintInProgress() const { return !mPrePostPaintRegions.empty(); } // Notification that visible area has been changed. // VisArea is reset, after that scrolling takes place. // The passed rect is situated on pixel borders // in order to avoid pixel errors when scrolling. virtual void VisPortChgd( const SwRect & ); bool SmoothScroll( long lXDiff, long lYDiff, const Rectangle* );//Browser void EnableSmooth( bool b ) { mbEnableSmooth = b; } const SwRect& VisArea() const; // If necessary scroll until passed Rect is situated in visible sector. void MakeVisible( const SwRect & ); // At nearest occasion pass new document size to UI. void SizeChgNotify(); void UISizeNotify(); // Passing of current size. Point GetPagePos( sal_uInt16 nPageNum ) const; sal_uInt16 GetNumPages(); // Ask count of current pages from layout. bool IsDummyPage( sal_uInt16 nPageNum ) const; // An empty page? // Invalidate first visible page for all Shells in ring. void SetFirstVisPageInvalid(); SwRootFrm *GetLayout() const; bool IsNewLayout() const; // Has Layout been loaded or created? Size GetDocSize() const; // Get document size. virtual void CalcLayout(); // Force complete formatting of layout. sal_uInt16 GetPageCount() const; const Size GetPageSize( sal_uInt16 nPageNum, bool bSkipEmptyPages ) const; inline SwDoc *GetDoc() const { return mpDoc; } //Never 0. /** Provides access to the document setting interface */ const IDocumentSettingAccess& getIDocumentSettingAccess() const; IDocumentSettingAccess& getIDocumentSettingAccess(); /** Provides access to the document device interface */ const IDocumentDeviceAccess& getIDocumentDeviceAccess() const; IDocumentDeviceAccess& getIDocumentDeviceAccess(); /** Provides access to the document bookmark interface */ const IDocumentMarkAccess* getIDocumentMarkAccess() const; IDocumentMarkAccess* getIDocumentMarkAccess(); /** Provides access to the document draw model interface */ const IDocumentDrawModelAccess& getIDocumentDrawModelAccess() const; IDocumentDrawModelAccess& getIDocumentDrawModelAccess(); /** Provides access to the document redline interface */ const IDocumentRedlineAccess& getIDocumentRedlineAccess() const; IDocumentRedlineAccess& getIDocumentRedlineAccess(); /** Provides access to the document layout interface */ const IDocumentLayoutAccess& getIDocumentLayoutAccess() const; IDocumentLayoutAccess& getIDocumentLayoutAccess(); /** Provides access to the content operations interface */ IDocumentContentOperations& getIDocumentContentOperations(); /** Provides access to the document style pool interface */ IDocumentStylePoolAccess& getIDocumentStylePoolAccess(); /** Provides access to the document statistics interface */ const IDocumentStatistics& getIDocumentStatistics() const; /** Provides access to the document undo/redo interface */ IDocumentUndoRedo const& GetIDocumentUndoRedo() const; IDocumentUndoRedo & GetIDocumentUndoRedo(); const IDocumentListItems* getIDocumentListItemsAccess() const; const IDocumentOutlineNodes* getIDocumentOutlineNodesAccess() const; // 1. GetRefDev: Either the printer or the virtual device from the doc // 2. GetWin: Available if we not printing // 3. GetOut: Printer, Window or Virtual device vcl::RenderContext& GetRefDev() const; inline vcl::Window* GetWin() const { return mpWin; } inline vcl::RenderContext* GetOut() const { return mpOut; } void SetWin(vcl::Window* win) { mpWin = win; } void SetOut(vcl::RenderContext* pOut) { mpOut = pOut; } static inline bool IsLstEndAction() { return SwViewShell::mbLstAct; } // Change of all page descriptors. void ChgAllPageOrientation( Orientation eOri ); void ChgAllPageSize( Size &rSz ); // Printing of one page. // bIsPDFExport == true is: do PDF Export (no printing!) bool PrintOrPDFExport( OutputDevice *pOutDev, SwPrintData const& rPrintData, sal_Int32 nRenderer /* offset in vector of pages to print */ ); // Printing of one brochure page. void PrintProspect( OutputDevice *pOutDev, const SwPrintData &rPrintData, sal_Int32 nRenderer /* offset in vector of page pairs for prospect printing */ ); // Printing for OLE 2.0. static void PrtOle2( SwDoc *pDoc, const SwViewOption *pOpt, const SwPrintData& rOptions, vcl::RenderContext& rRenderContext, const Rectangle& rRect ); // Fill temporary doc with selected text for Print or PDF export. SwDoc * FillPrtDoc( SwDoc* pPrtDoc, const SfxPrinter* pPrt ); // Called internally for Shell. Formats pages. void CalcPagesForPrint( sal_uInt16 nMax ); // All about fields. void UpdateFields(bool bCloseDB = false); bool IsAnyFieldInDoc() const; // Update all charts, for that exists any table. void UpdateAllCharts(); bool HasCharts() const; // DOCUMENT COMPATIBILITY FLAGS START // Add or maximize paragraph spacing? void SetParaSpaceMax( bool bNew ); // Add or maximize paragraph spacing? void SetParaSpaceMaxAtPages( bool bNew ); // Compatible behaviour of tabs. void SetTabCompat( bool bNew ); // Font metric attribute "External Leading" should be considered. void SetAddExtLeading( bool bNew ); // Formatting by virtual device or printer. void SetUseVirDev( bool bNew ); // Adding paragraph and table spacing at bottom // of table cells. void SetAddParaSpacingToTableCells( bool _bAddParaSpacingToTableCells ); // Former formatting of text lines with // proportional line spacing or not. void SetUseFormerLineSpacing( bool _bUseFormerLineSpacing ); // Former object positioning. void SetUseFormerObjectPositioning( bool _bUseFormerObjPos ); void SetConsiderWrapOnObjPos( bool _bConsiderWrapOnObjPos ); void SetUseFormerTextWrapping( bool _bUseFormerTextWrapping ); void SetDoNotJustifyLinesWithManualBreak( bool _bDoNotJustifyLinesWithManualBreak ); // DOCUMENT COMPATIBILITY FLAGS END // Calls Idle-formatter of Layout. void LayoutIdle(); inline const SwViewOption *GetViewOptions() const { return mpOpt; } virtual void ApplyViewOptions( const SwViewOption &rOpt ); void SetUIOptions( const SwViewOption &rOpt ); virtual void SetReadonlyOption(bool bSet); // Set readonly-bit of ViewOptions. void SetPDFExportOption(bool bSet); // Set/reset PDF export mode. void SetPrtFormatOption(bool bSet); // Set PrtFormat-Bit of ViewOptions. void SetReadonlySelectionOption(bool bSet); // Change the selection mode in readonly docs. const SwAccessibilityOptions* GetAccessibilityOptions() const { return mpAccOptions;} static void SetShellRes( ShellResource* pRes ) { mpShellRes = pRes; } static ShellResource* GetShellRes(); static void SetCareWin( vcl::Window* pNew ); static vcl::Window* GetCareWin(SwViewShell& rVSh) { return mpCareWindow ? mpCareWindow.get() : CareChildWin(rVSh); } static vcl::Window* CareChildWin(SwViewShell& rVSh); inline SfxViewShell *GetSfxViewShell() const { return mpSfxViewShell; } inline void SetSfxViewShell(SfxViewShell *pNew) { mpSfxViewShell = pNew; } // Selection of Draw Engine has been changed. virtual void DrawSelChanged(); SwPagePreviewLayout* PagePreviewLayout(); /** adjust view options for page preview Because page preview should show the document as it is printed - page preview is print preview -, the view options are adjusted to the same as for printing. @param _rPrintOptions input parameter - constant reference to print options, to which the view option will be adjusted. */ void AdjustOptionsForPagePreview( SwPrintData const& rPrintOptions ); bool IsViewLocked() const { return mbViewLocked; } void LockView( bool b ) { mbViewLocked = b; } inline void LockPaint(); void ImplLockPaint(); inline void UnlockPaint( bool bVirDev = false ); void ImplUnlockPaint( bool bVirDev ); bool IsPaintLocked() const { return mnLockPaint != 0; } // Get/set DrawView and PageView. bool HasDrawView() const; void MakeDrawView(); // DrawView may be used at UI. SdrView *GetDrawView(); const SdrView *GetDrawView() const { return const_cast(this)->GetDrawView(); } // Take care that MarkList is up-to-date in any case (Bug 57153). SdrView *GetDrawViewWithValidMarkList(); // Query attribute pool. inline const SfxItemPool& GetAttrPool() const; SfxItemPool& GetAttrPool(); bool IsPreview() const { return mbPreview; } bool IsFrameView() const { return mbFrameView; } // Invalidates pages and contents. // When bSizeChanged==true, adds/removes // headers and footers as necessary. void InvalidateLayout(bool bSizeChanged); const Size& GetBrowseBorder() const; sal_Int32 GetBrowseWidth() const; void SetBrowseBorder( const Size& rNew ); ::com::sun::star::uno::Reference< ::com::sun::star::accessibility::XAccessible > CreateAccessible(); ::com::sun::star::uno::Reference< ::com::sun::star::accessibility::XAccessible > CreateAccessiblePreview(); void ShowPreviewSelection( sal_uInt16 nSelPage ); void InvalidateAccessibleFocus(); // Apply Accessiblity options. void ApplyAccessiblityOptions(SvtAccessibilityOptions& rAccessibilityOptions); /** invalidate CONTENT_FLOWS_FROM/_TO relation for paragraphs @author OD @param _pFromTextFrm input parameter - paragraph frame, for which the relation CONTENT_FLOWS_FROM has to be invalidated. If NULL, no CONTENT_FLOWS_FROM relation has to be invalidated @param _pToTextFrm input parameter - paragraph frame, for which the relation CONTENT_FLOWS_TO has to be invalidated. If NULL, no CONTENT_FLOWS_TO relation has to be invalidated */ void InvalidateAccessibleParaFlowRelation( const SwTextFrm* _pFromTextFrm, const SwTextFrm* _pToTextFrm ); /** invalidate text selection for paragraphs @author OD */ void InvalidateAccessibleParaTextSelection(); /** invalidate attributes for paragraphs and paragraph's characters usage also for changes of the attributes of paragraph's characters. @author OD @param rTextFrm input parameter - paragraph frame, whose attributes have changed */ void InvalidateAccessibleParaAttrs( const SwTextFrm& rTextFrm ); SwAccessibleMap* GetAccessibleMap(); SwViewShell( SwViewShell&, vcl::Window *pWin = 0, OutputDevice *pOut = 0, long nFlags = 0 ); SwViewShell( SwDoc& rDoc, vcl::Window *pWin, const SwViewOption *pOpt = 0, OutputDevice *pOut = 0, long nFlags = 0 ); virtual ~SwViewShell(); sal_Int32 GetPageNumAndSetOffsetForPDF( OutputDevice& rOut, const SwRect& rRect ) const; inline bool IsInConstructor() const { return mbInConstructor; } static const BitmapEx& GetReplacementBitmap( bool bIsErrorState ); static void DeleteReplacementBitmaps(); const SwPostItMgr* GetPostItMgr() const { return (const_cast(this))->GetPostItMgr(); } SwPostItMgr* GetPostItMgr(); /// Acts both for headers / footers, depending on the bShow(Header|Footer)Separator flags void ToggleHeaderFooterEdit(); /// Acts both for headers / footers, depending on the bShow(Header|Footer)Separator flags bool IsHeaderFooterEdit() const { return mbHeaderFooterEdit; } bool IsShowHeaderFooterSeparator( FrameControlType eControl ) { return (eControl == Header)? mbShowHeaderSeparator: mbShowFooterSeparator; } virtual void SetShowHeaderFooterSeparator( FrameControlType eControl, bool bShow ) { if ( eControl == Header ) mbShowHeaderSeparator = bShow; else mbShowFooterSeparator = bShow; } bool IsSelectAll() { return mbSelectAll; } /// The actual implementation of the vcl::ITiledRenderable::registerCallback() API for Writer. void registerLibreOfficeKitCallback(LibreOfficeKitCallback pCallback, void* pLibreOfficeKitData); /// Invokes the registered callback, if there are any. void libreOfficeKitCallback(int nType, const char* pPayload) const; /// Set if we are doing tiled rendering. void setTiledRendering(bool bTiledRendering); /// Are we doing tiled rendering? bool isTiledRendering() const; void setOutputToWindow(bool bOutputToWindow); bool isOutputToWindow() const; virtual void dumpAsXml(struct _xmlTextWriter* pWriter) const; }; // manages global ShellPointer class CurrShell { public: SwViewShell *pPrev; SwRootFrm *pRoot; CurrShell( SwViewShell *pNew ); ~CurrShell(); }; inline void SwViewShell::ResetInvalidRect() { maInvalidRect.Clear(); } inline void SwViewShell::StartAction() { if ( !mnStartAction++ ) ImplStartAction(); } inline void SwViewShell::EndAction( const bool bIdleEnd ) { if( 0 == (mnStartAction - 1) ) ImplEndAction( bIdleEnd ); --mnStartAction; } inline void SwViewShell::LockPaint() { if ( !mnLockPaint++ ) ImplLockPaint(); } inline void SwViewShell::UnlockPaint( bool bVirDev ) { if ( 0 == --mnLockPaint ) ImplUnlockPaint( bVirDev ); } inline const SfxItemPool& SwViewShell::GetAttrPool() const { return const_cast(this)->GetAttrPool(); } #endif // INCLUDED_SW_INC_VIEWSH_HXX /* vim:set shiftwidth=4 softtabstop=4 expandtab: */