sw/source/core/inc/viewimp.hxx

   1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
   2 /*
   3  * This file is part of the LibreOffice project.
   4  *
   5  * This Source Code Form is subject to the terms of the Mozilla Public
   6  * License, v. 2.0. If a copy of the MPL was not distributed with this
   7  * file, You can obtain one at http://mozilla.org/MPL/2.0/.
   8  *
   9  * This file incorporates work covered by the following license notice:
  10  *
  11  *   Licensed to the Apache Software Foundation (ASF) under one or more
  12  *   contributor license agreements. See the NOTICE file distributed
  13  *   with this work for additional information regarding copyright
  14  *   ownership. The ASF licenses this file to you under the Apache
  15  *   License, Version 2.0 (the "License"); you may not use this file
  16  *   except in compliance with the License. You may obtain a copy of
  17  *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
  18  */
  19
  20 #pragma once
  21
  22 #include <tools/color.hxx>
  23 #include <svx/svdtypes.hxx>
  24 #include <swrect.hxx>
  25 #include <swregion.hxx>
  26 #include <memory>
  27 #include <optional>
  28 #include <vector>
  29
  30 class OutputDevice;
  31 class SwViewShell;
  32 class SwFlyFrame;
  33 class SwViewOption;
  34 class SwFrame;
  35 class SwLayAction;
  36 class SwLayIdle;
  37 class SwDrawView;
  38 class SdrPageView;
  39 class SwPageFrame;
  40 class SwAccessibleMap;
  41 class SdrObject;
  42 class Fraction;
  43 class SwPrintData;
  44 class SwPagePreviewLayout;
  45 struct PreviewPage;
  46 class SwTextFrame;
  47 // --> OD #i76669#
  48 namespace sdr::contact { class ViewObjectContactRedirector; }
  49 // <--
  50
  51 class SwViewShellImp
  52 {
  53     friend class SwViewShell;
  54
  55     friend class SwLayAction;   // Lay- and IdleAction register and deregister
  56     friend class SwLayIdle;
  57
  58     // for paint of page preview
  59     friend class SwPagePreviewLayout;
  60
  61     SwViewShell *m_pShell;           // If someone passes an Imp, but needs a SwViewShell, we
  62                                 // keep a backlink here
  63
  64     std::unique_ptr<SwDrawView> m_pDrawView; // Our DrawView
  65     SdrPageView *m_pSdrPageView;  // Exactly one Page for our DrawView
  66
  67     SwPageFrame     *m_pFirstVisiblePage; // Always points to the first visible Page
  68     std::optional<SwRegionRects> m_oPaintRegion; // Collector of Paintrects from the LayAction
  69
  70     std::vector<SwRect> m_pendingLOKInvalidations;
  71
  72     SwLayAction   *m_pLayAction;      // Is set if an Action object exists
  73                                  // Is registered by the SwLayAction ctor and deregistered by the dtor
  74     SwLayIdle     *m_pIdleAct;     // The same as SwLayAction for SwLayIdle
  75
  76     /// note: the map is *uniquely* owned here - the shared_ptr is only
  77     /// used so that SwAccessibleContext can check via weak_ptr that it's alive
  78     std::shared_ptr<SwAccessibleMap> m_pAccessibleMap;
  79
  80     bool m_bFirstPageInvalid : 1; // Pointer to the first Page invalid?
  81     bool m_bResetHdlHiddenPaint : 1; // Ditto
  82     bool m_bSmoothUpdate : 1; // For SmoothScroll
  83     bool m_bStopSmooth : 1;
  84
  85     sal_uInt16 m_nRestoreActions  ; // Count for the Action that need to be restored (UNO)
  86     SwRect m_aSmoothRect;
  87
  88     std::unique_ptr<SwPagePreviewLayout> m_pPagePreviewLayout;
  89
  90     void SetFirstVisPage(OutputDevice const * pRenderContext); // Recalculate the first visible Page
  91
  92     void StartAction();         // Show handle and hide
  93     void EndAction();           // Called by SwViewShell::ImplXXXAction
  94     void LockPaint();           // Ditto; called by SwViewShell::ImplLockPaint
  95     void UnlockPaint();
  96
  97 private:
  98
  99     SwAccessibleMap *CreateAccessibleMap();
 100
 101     /** invalidate CONTENT_FLOWS_FROM/_TO relation for paragraphs
 102
 103         #i27138#
 104         implementation for wrapper method
 105         <SwViewShell::InvalidateAccessibleParaFlowRelation(..)>
 106
 107         @param _pFromTextFrame
 108         input parameter - paragraph frame, for which the relation CONTENT_FLOWS_FROM
 109         has to be invalidated.
 110         If NULL, no CONTENT_FLOWS_FROM relation has to be invalidated
 111
 112         @param _pToTextFrame
 113         input parameter - paragraph frame, for which the relation CONTENT_FLOWS_TO
 114         has to be invalidated.
 115         If NULL, no CONTENT_FLOWS_TO relation has to be invalidated
 116     */
 117     void InvalidateAccessibleParaFlowRelation_( const SwTextFrame* _pFromTextFrame,
 118                                                 const SwTextFrame* _pToTextFrame );
 119
 120     /** invalidate text selection for paragraphs
 121
 122         #i27301#
 123         implementation for wrapper method
 124         <SwViewShell::InvalidateAccessibleParaTextSelection(..)>
 125     */
 126     void InvalidateAccessibleParaTextSelection_();
 127
 128     /** invalidate attributes for paragraphs and paragraph's characters
 129
 130         #i88069#
 131         implementation for wrapper method
 132         <SwViewShell::InvalidateAccessibleParaAttrs(..)>
 133     */
 134     void InvalidateAccessibleParaAttrs_( const SwTextFrame& rTextFrame );
 135
 136 public:
 137     SwViewShellImp( SwViewShell * );
 138     ~SwViewShellImp();
 139     void Init( const SwViewOption * ); /// Only for SwViewShell::Init()
 140
 141     const SwViewShell *GetShell() const { return m_pShell; }
 142           SwViewShell *GetShell()       { return m_pShell; }
 143
 144     Color GetRetoucheColor() const;
 145
 146     /// Management of the first visible Page
 147     const SwPageFrame *GetFirstVisPage(OutputDevice const * pRenderContext) const;
 148           SwPageFrame *GetFirstVisPage(OutputDevice const * pRenderContext);
 149     void SetFirstVisPageInvalid() { m_bFirstPageInvalid = true; }
 150
 151     const SwPageFrame* GetLastVisPage(const OutputDevice* pRenderContext) const;
 152
 153     bool AddPaintRect( const SwRect &rRect );
 154     bool HasPaintRegion()      { return m_oPaintRegion.has_value(); }
 155     std::optional<SwRegionRects> TakePaintRegion() { auto ret = std::move(m_oPaintRegion); m_oPaintRegion.reset(); return ret; }
 156     const std::optional<SwRegionRects>& GetPaintRegion() { return m_oPaintRegion; }
 157     void DeletePaintRegion() { m_oPaintRegion.reset(); }
 158
 159     void AddPendingLOKInvalidation( const SwRect& rRect );
 160     std::vector<SwRect> TakePendingLOKInvalidations();
 161
 162     /// New Interface for StarView Drawing
 163     bool  HasDrawView()             const { return nullptr != m_pDrawView; }
 164           SwDrawView* GetDrawView()       { return m_pDrawView.get(); }
 165     const SwDrawView* GetDrawView() const { return m_pDrawView.get(); }
 166           SdrPageView*GetPageView()       { return m_pSdrPageView; }
 167     const SdrPageView*GetPageView() const { return m_pSdrPageView; }
 168     void MakeDrawView();
 169
 170     /**
 171      * @param _pPageBackgrdColor for setting this color as the background color
 172      * at the outliner of the draw view for painting layers "hell" and "heaven"
 173      *
 174      * @param _bIsPageRightToLeft for the horizontal text direction of the page
 175      * in order to set the default horizontal text direction at the outliner of
 176      * the draw view for painting layers "hell" and "heaven"
 177      */
 178     void   PaintLayer( const SdrLayerID _nLayerID,
 179                        SwPageFrame const& rPageFrame,
 180                        const SwRect& _rRect,
 181                        const Color* _pPageBackgrdColor,
 182                        const bool _bIsPageRightToLeft,
 183                        sdr::contact::ViewObjectContactRedirector* pRedirector );
 184
 185     /**
 186      * Is passed to the DrawEngine as a Link and decides what is painted
 187      * or not and in what way
 188      */
 189
 190     // Interface Drawing
 191     bool IsDragPossible( const Point &rPoint );
 192     void NotifySizeChg( const Size &rNewSz );
 193
 194     /// SS for the Lay-/IdleAction and relatives
 195     bool  IsAction() const                   { return m_pLayAction  != nullptr; }
 196     bool  IsIdleAction() const               { return m_pIdleAct != nullptr; }
 197           SwLayAction &GetLayAction()        { return *m_pLayAction; }
 198     const SwLayAction &GetLayAction() const  { return *m_pLayAction; }
 199
 200     /**
 201      * If an Action is running we ask it to check whether it's time
 202      * to enable the WaitCursor
 203      */
 204     void CheckWaitCursor();
 205
 206     /// Asks the LayAction if present
 207     bool IsCalcLayoutProgress() const;
 208
 209     /**
 210      * @returns true if a LayAction is running
 211      *
 212      * There we also set the Flag for ExpressionFields
 213      */
 214     bool IsUpdateExpFields();
 215
 216     void    SetRestoreActions(sal_uInt16 nSet){m_nRestoreActions = nSet;}
 217     sal_uInt16  GetRestoreActions() const{return m_nRestoreActions;}
 218
 219     void InitPagePreviewLayout();
 220
 221     SwPagePreviewLayout* PagePreviewLayout()
 222     {
 223         return m_pPagePreviewLayout.get();
 224     }
 225
 226     /// Is this view accessible?
 227     bool IsAccessible() const { return m_pAccessibleMap != nullptr; }
 228
 229     inline SwAccessibleMap& GetAccessibleMap();
 230
 231     /// Update (this) accessible view
 232     void UpdateAccessible();
 233
 234     /// Remove a frame from the accessible view
 235     void DisposeAccessible( const SwFrame *pFrame, const SdrObject *pObj,
 236                             bool bRecursive, bool bCanSkipInvisible );
 237     inline void DisposeAccessibleFrame( const SwFrame *pFrame,
 238                                bool bRecursive = false );
 239     inline void DisposeAccessibleObj( const SdrObject *pObj, bool bCanSkipInvisible );
 240
 241     /// Move a frame's position in the accessible view
 242     void MoveAccessible( const SwFrame *pFrame, const SdrObject *pObj,
 243                          const SwRect& rOldFrame );
 244     inline void MoveAccessibleFrame( const SwFrame *pFrame, const SwRect& rOldFrame );
 245
 246     /// Add a frame in the accessible view
 247     inline void AddAccessibleFrame( const SwFrame *pFrame );
 248
 249     inline void AddAccessibleObj( const SdrObject *pObj );
 250
 251     /// Invalidate accessible frame's content
 252     void InvalidateAccessibleFrameContent( const SwFrame *pFrame );
 253
 254     /// Invalidate accessible frame's cursor position
 255     void InvalidateAccessibleCursorPosition( const SwFrame *pFrame );
 256
 257     /// Invalidate editable state for all accessible frames
 258     void InvalidateAccessibleEditableState( bool bAllShells,
 259                                                const SwFrame *pFrame=nullptr );
 260
 261     /// Invalidate frame's relation set (for chained frames)
 262     void InvalidateAccessibleRelationSet( const SwFlyFrame *pMaster,
 263                                           const SwFlyFrame *pFollow );
 264
 265     /// update data for accessible preview
 266     /// change method signature due to new page preview functionality
 267     void UpdateAccessiblePreview( const std::vector<std::unique_ptr<PreviewPage>>& _rPreviewPages,
 268                                   const Fraction&  _rScale,
 269                                   const SwPageFrame* _pSelectedPageFrame,
 270                                   const Size&      _rPreviewWinSize );
 271
 272     void InvalidateAccessiblePreviewSelection( sal_uInt16 nSelPage );
 273
 274     /// Fire all accessible events that have been collected so far
 275     void FireAccessibleEvents();
 276 };
 277
 278 inline SwAccessibleMap& SwViewShellImp::GetAccessibleMap()
 279 {
 280     if( !m_pAccessibleMap )
 281         CreateAccessibleMap();
 282
 283     return *m_pAccessibleMap;
 284 }
 285
 286 inline void SwViewShellImp::DisposeAccessibleFrame( const SwFrame *pFrame,
 287                                bool bRecursive )
 288 {
 289     DisposeAccessible( pFrame, nullptr, bRecursive, true );
 290 }
 291
 292 inline void SwViewShellImp::DisposeAccessibleObj( const SdrObject *pObj, bool bCanSkipInvisible )
 293 {
 294     DisposeAccessible( nullptr, pObj, false, bCanSkipInvisible );
 295 }
 296
 297 inline void SwViewShellImp::MoveAccessibleFrame( const SwFrame *pFrame,
 298                                           const SwRect& rOldFrame )
 299 {
 300     MoveAccessible( pFrame, nullptr, rOldFrame );
 301 }
 302
 303 inline void SwViewShellImp::AddAccessibleFrame( const SwFrame *pFrame )
 304 {
 305     SwRect aEmptyRect;
 306     MoveAccessible( pFrame, nullptr, aEmptyRect );
 307 }
 308
 309 inline void SwViewShellImp::AddAccessibleObj( const SdrObject *pObj )
 310 {
 311     SwRect aEmptyRect;
 312     MoveAccessible( nullptr, pObj, aEmptyRect );
 313 }
 314
 315 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */