viewsh.hxx

Go to the documentation of this file.

/* -*- 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 .
 */
 
#pragma once
 
#include "swdllapi.h"
#include "swtypes.hxx"
#include "ring.hxx"
#include "swrect.hxx"
#include <memory>
#include <stack>
#include <vcl/mapmod.hxx>
#include <vcl/vclptr.hxx>
#include <vcl/lazydelete.hxx>
#include <vcl/window.hxx>
 
namespace com::sun::star::accessibility { class XAccessible; }
class SwDoc;
class IDocumentSettingAccess;
class IDocumentDeviceAccess;
class IDocumentMarkAccess;
class IDocumentDrawModelAccess;
class IDocumentRedlineAccess;
class IDocumentLayoutAccess;
class IDocumentContentOperations;
class IDocumentStylePoolAccess;
class IDocumentStatistics;
class IDocumentUndoRedo;
class IDocumentListItems;
class IDocumentOutlineNodes;
class SfxPrinter;
class SwRootFrame;
class SwNodes;
class SdrView;
class SfxItemPool;
class SfxViewShell;
class SwViewOption;
class SwViewShellImp;
class SwPrintData;
struct ShellResource;
class SwRegionRects;
class SvtAccessibilityOptions;
class SwPagePreviewLayout;
class SwTextFrame;
 
struct SwAccessibilityOptions;
namespace vcl { class Region; }
class SwPostItMgr;
class SdrPaintWindow;
class SwAccessibleMap;
enum class Orientation;
 
enum class LockPaintReason
{
    ViewLayout = 1,
    OuterResize,
    Undo,
    Redo,
    OutlineFolding,
    EndSdrCreate,
    SwLayIdle,
    InvalidateLayout,
    StartDrag,
    DataChanged,
    InsertFrame,
    GotoPage,
    InsertGraphic,
    SetZoom,
    ExampleFrame
};
 
namespace vcl
{
    typedef OutputDevice RenderContext;
}
 
// Define for flags needed in ctor or layers below.
// Currently the Preview flag is needed for DrawPage.
#define VSHELLFLAG_ISPREVIEW            (tools::Long(0x1))
#define VSHELLFLAG_SHARELAYOUT          (tools::Long(0x2))
typedef std::shared_ptr<SwRootFrame> SwRootFramePtr;
 
typedef struct _xmlTextWriter* xmlTextWriterPtr;
 
struct SwVisiblePageNumbers
{
    sal_uInt16 nFirstPhy, nLastPhy;
    sal_uInt16 nFirstVirt, nLastVirt;
    OUString sFirstCustomPhy, sLastCustomPhy;
    OUString sFirstCustomVirt, sLastCustomVirt;
};
 
class SW_DLLPUBLIC SwViewShell : public sw::Ring<SwViewShell>
{
    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 & );
 
    std::unique_ptr<BitmapEx> m_xReplaceBmp; 
    std::unique_ptr<BitmapEx> m_xErrorBmp;   
 
    static bool sbLstAct;            // true if EndAction of last Shell
                                     // i.e. if the EndActions of the other
                                     // Shells on the document are through.
 
    Point         maPrtOffset;       // Offset for Printer,
                                     // non-printable margin.
    Size          maBrowseBorder;    // Border for frame documents.
    SwRect        maInvalidRect;
 
    SfxViewShell *mpSfxViewShell;
    std::unique_ptr<SwViewShellImp>
                  mpImp;             // Core-internals of SwViewShell.
                                     // The pointer is never 0.
 
    VclPtr<vcl::Window>   mpWin;     
    VclPtr<OutputDevice>  mpOut;     
 
    std::unique_ptr<SwViewOption> mpOpt;
    std::unique_ptr<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      mbShowHeaderSeparator:1; 
    bool      mbShowFooterSeparator:1; 
    bool      mbHeaderFooterEdit:1;  
 
    // boolean, indicating that class in constructor.
    bool mbInConstructor:1;
 
    SdrPaintWindow*         mpTargetPaintWindow;
    VclPtr<OutputDevice>    mpBufferedOut;
 
    SwRootFramePtr            mpLayout;
 
    // Initialization; called by the diverse constructors.
    SAL_DLLPRIVATE void Init( const SwViewOption *pNewOpt );
 
    inline void ResetInvalidRect();
 
 
 
    SAL_DLLPRIVATE void PaintDesktop(const 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_(const SwRegionRects &rRegion);
 
    SAL_DLLPRIVATE bool CheckInvalidForPaint( const SwRect & );  // Direct Paint or rather
                                                                    // trigger an action.
 
    SAL_DLLPRIVATE void PrepareForPrint( const SwPrintData &rOptions, bool bIsPDFExport = false );
 
    SAL_DLLPRIVATE void ImplApplyViewOptions( const SwViewOption &rOpt );
 
    SAL_DLLPRIVATE void InvalidateAll(std::vector<LockPaintReason>& rReasons);
 
protected:
    static ShellResource*      spShellRes;      
    static vcl::DeleteOnDeinit< std::shared_ptr<weld::Window> > spCareDialog;    
 
    SwRect                  maVisArea;       
    tools::Rectangle        maLOKVisibleArea;
    rtl::Reference<SwDoc>   mxDoc;          
 
    sal_uInt16 mnStartAction; 
    sal_uInt16 mnLockPaint;   
    std::vector<LockPaintReason> maLockPaintReasons;
    bool      mbSelectAll; 
 
    bool mbOutputToWindow;
 
public:
 
          SwViewShellImp *Imp() { return mpImp.get(); }
    const SwViewShellImp *Imp() const { return mpImp.get(); }
 
    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 );
    sal_uInt16 ActionCount() const { return mnStartAction; }
    bool ActionPend() const { return mnStartAction != 0; }
    bool IsInEndAction() const { return mbInEndAction; }
 
    // 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;
 
    bool HasInvalidRect() const { return maInvalidRect.HasArea(); }
    void ChgHyphenation() { Reformat(); }
    void ChgNumberDigits();
 
    bool AddPaintRect( const SwRect &rRect );
 
    void InvalidateWindows( const SwRect &rRect );
    void FlushPendingLOKInvalidateTiles();
 
    void Reformat();
 
    // #i72754# set of Pre/PostPaints with lock counter and initial target OutDev
protected:
    std::stack<vcl::Region> mPrePostPaintRegions; // acts also as a lock counter (empty == not locked)
    VclPtr<OutputDevice>    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 tools::Rectangle &rRect);
 
    void PaintTile(VirtualDevice &rDevice, int contextWidth, int contextHeight, int tilePosX, int tilePosY, tools::Long tileWidth, tools::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( tools::Long lXDiff, tools::Long lYDiff, const tools::Rectangle* );//Browser
    void EnableSmooth( bool b ) { mbEnableSmooth = b; }
 
    const SwRect& VisArea() const;
 
    const tools::Rectangle & getLOKVisibleArea() const { return maLOKVisibleArea; }
    void setLOKVisibleArea(const tools::Rectangle& rArea) { maLOKVisibleArea = rArea; }
 
    // 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() const;   // 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();
 
    SwRootFrame   *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;
 
    Size GetPageSize( sal_uInt16 nPageNum, bool bSkipEmptyPages ) const;
 
    SwDoc *GetDoc()  const { return mxDoc.get(); }  //Never 0.
 
    const IDocumentSettingAccess& getIDocumentSettingAccess() const;
          IDocumentSettingAccess& getIDocumentSettingAccess();
 
    const IDocumentDeviceAccess& getIDocumentDeviceAccess() const;
          IDocumentDeviceAccess& getIDocumentDeviceAccess();
 
    const IDocumentMarkAccess* getIDocumentMarkAccess() const;
          IDocumentMarkAccess* getIDocumentMarkAccess();
 
    const IDocumentDrawModelAccess& getIDocumentDrawModelAccess() const;
          IDocumentDrawModelAccess& getIDocumentDrawModelAccess();
 
    const IDocumentRedlineAccess& getIDocumentRedlineAccess() const;
          IDocumentRedlineAccess& getIDocumentRedlineAccess();
 
    const IDocumentLayoutAccess& getIDocumentLayoutAccess() const;
          IDocumentLayoutAccess& getIDocumentLayoutAccess();
 
    IDocumentContentOperations& getIDocumentContentOperations();
 
    IDocumentStylePoolAccess& getIDocumentStylePoolAccess();
 
    const IDocumentStatistics& getIDocumentStatistics() const;
 
    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;
    vcl::Window* GetWin()    const { return mpWin; }
    vcl::RenderContext* GetOut()     const { return mpOut; }
 
    void SetWin(vcl::Window* win) { mpWin = win; }
    void SetOut(vcl::RenderContext* pOut) { mpOut = pOut; }
    static bool IsLstEndAction() { return SwViewShell::sbLstAct; }
 
    // Change of all page descriptors.
    void   ChgAllPageOrientation( Orientation eOri );
    void   ChgAllPageSize( Size const &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 */
            bool bIsPDFExport );
 
    // 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 tools::Rectangle& rRect,
                         bool bOutputForScreen );
 
    // Fill temporary doc with selected text for Print or PDF export.
    void FillPrtDoc( SwDoc& rPrtDoc, 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;
 
    void UpdateOleObjectPreviews();
 
    // 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 );
 
    // 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 );
 
    void SetProtectForm( bool _bProtectForm );
 
    void SetMsWordCompTrailingBlanks( bool _bMsWordCompTrailingBlanks );
 
    void SetSubtractFlysAnchoredAtFlys(bool bSubtractFlysAnchoredAtFlys);
 
    void SetEmptyDbFieldHidesPara(bool bEmptyDbFieldHidesPara);
 
    // DOCUMENT COMPATIBILITY FLAGS END
 
    // Calls Idle-formatter of Layout.
    void LayoutIdle();
 
    const SwViewOption *GetViewOptions() const { return mpOpt.get(); }
    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.get();}
 
    static void           SetShellRes( ShellResource* pRes ) { spShellRes = pRes; }
    static ShellResource* GetShellRes();
 
    static weld::Window*   CareChildWin(SwViewShell const & rVSh);
    static void           SetCareDialog(const std::shared_ptr<weld::Window>& rNew);
    static weld::Window*  GetCareDialog(SwViewShell const & rVSh)
                          { return (*spCareDialog.get()) ? spCareDialog.get()->get() : CareChildWin(rVSh); }
 
    SfxViewShell   *GetSfxViewShell() const { return mpSfxViewShell; }
    void           SetSfxViewShell(SfxViewShell *pNew) { mpSfxViewShell = pNew; }
 
    // Selection of  Draw Engine has been changed.
    virtual void DrawSelChanged();
 
    SwPagePreviewLayout* PagePreviewLayout();
 
    void AdjustOptionsForPagePreview( SwPrintData const& rPrintOptions );
 
    bool IsViewLocked() const { return mbViewLocked; }
    void LockView( bool b )   { mbViewLocked = b;    }
 
    inline void LockPaint(LockPaintReason eReason);
           void ImplLockPaint();
    inline void UnlockPaint(bool bVirDev = false );
           void ImplUnlockPaint( std::vector<LockPaintReason>& rReasons, bool bVirDev );
           bool IsPaintLocked() const { return mnLockPaint != 0; }
 
    // Get/set DrawView and PageView.
    bool HasDrawView() const;
    void MakeDrawView();
 
    // Are we dragging draw shapes around.
    bool HasDrawViewDrag() const;
 
    // DrawView may be used at UI.
          SdrView *GetDrawView();
    const SdrView *GetDrawView() const { return const_cast<SwViewShell*>(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 );
 
    css::uno::Reference< css::accessibility::XAccessible > CreateAccessible();
 
    css::uno::Reference< css::accessibility::XAccessible >  CreateAccessiblePreview();
 
    void ShowPreviewSelection( sal_uInt16 nSelPage );
    void InvalidateAccessibleFocus();
 
    // Apply Accessibility options.
    void ApplyAccessibilityOptions(SvtAccessibilityOptions const & rAccessibilityOptions);
 
    void InvalidateAccessibleParaFlowRelation( const SwTextFrame* _pFromTextFrame,
                                               const SwTextFrame* _pToTextFrame );
 
    void InvalidateAccessibleParaTextSelection();
 
    void InvalidateAccessibleParaAttrs( const SwTextFrame& rTextFrame );
 
    SwAccessibleMap* GetAccessibleMap();
 
    SwViewShell( SwViewShell&, vcl::Window *pWin, OutputDevice *pOut = nullptr,
                tools::Long nFlags = 0 );
    SwViewShell( SwDoc& rDoc, vcl::Window *pWin,
               const SwViewOption *pOpt, OutputDevice *pOut = nullptr,
               tools::Long nFlags = 0 );
    virtual ~SwViewShell() override;
 
    sal_Int32 GetPageNumAndSetOffsetForPDF( OutputDevice& rOut, const SwRect& rRect ) const;
 
    bool IsInConstructor() const { return mbInConstructor; }
 
    const BitmapEx& GetReplacementBitmap(bool bIsErrorState);
    void DeleteReplacementBitmaps();
 
    const SwPostItMgr* GetPostItMgr() const { return const_cast<SwViewShell*>(this)->GetPostItMgr(); }
    SwPostItMgr* GetPostItMgr();
 
    void ToggleHeaderFooterEdit();
    bool IsHeaderFooterEdit() const { return mbHeaderFooterEdit; }
    bool IsShowHeaderFooterSeparator( FrameControlType eControl ) { return (eControl == FrameControlType::Header)? mbShowHeaderSeparator: mbShowFooterSeparator; }
    virtual void SetShowHeaderFooterSeparator( FrameControlType eControl, bool bShow );
    bool IsSelectAll() const { return mbSelectAll; }
 
    void setOutputToWindow(bool bOutputToWindow);
    bool isOutputToWindow() const;
    void OnGraphicArrived(const SwRect&);
 
    void GetFirstLastVisPageNumbers(SwVisiblePageNumbers& rVisiblePageNumbers);
 
    virtual void dumpAsXml(xmlTextWriterPtr pWriter) const;
};
 
// manages global ShellPointer
class CurrShell
{
public:
    SwViewShell *pPrev;
    SwRootFrame *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(LockPaintReason eReason)
{
    maLockPaintReasons.push_back(eReason);
    if ( !mnLockPaint++ )
        ImplLockPaint();
}
 
inline void SwViewShell::UnlockPaint(bool bVirDev )
{
    if ( 0 == --mnLockPaint )
    {
        ImplUnlockPaint(maLockPaintReasons, bVirDev);
        maLockPaintReasons.clear();
    }
}
 
inline const SfxItemPool& SwViewShell::GetAttrPool() const
{
    return const_cast<SwViewShell*>(this)->GetAttrPool();
}
 
 
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */