sw/source/core/inc/layfrm.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 #ifndef INCLUDED_SW_SOURCE_CORE_INC_LAYFRM_HXX
  20 #define INCLUDED_SW_SOURCE_CORE_INC_LAYFRM_HXX
  21
  22 #include "frame.hxx"
  23 #include <swdllapi.h>
  24
  25 class SwAnchoredObject;
  26 class SwContentFrame;
  27 class SwFormatCol;
  28 struct SwCursorMoveState;
  29 class SwFrameFormat;
  30 class SwBorderAttrs;
  31 class SwFormatFrameSize;
  32 class SwCellFrame;
  33
  34 /// A layout frame is a frame that contains other frames (m_pLower), e.g. SwPageFrame or SwTabFrame.
  35 class SW_DLLPUBLIC SwLayoutFrame: public SwFrame
  36 {
  37     // The SwFrame in disguise
  38     friend class SwFlowFrame;
  39     friend class SwFrame;
  40
  41     // Releases the Lower while restructuring columns
  42     friend SwFrame* SaveContent( SwLayoutFrame *, SwFrame * );
  43     friend void   RestoreContent( SwFrame *, SwLayoutFrame *, SwFrame *pSibling );
  44
  45 protected:
  46
  47     virtual void DestroyImpl() override;
  48     virtual ~SwLayoutFrame() override;
  49
  50     virtual void Format( vcl::RenderContext* pRenderContext, const SwBorderAttrs *pAttrs = nullptr ) override;
  51     virtual void MakeAll(vcl::RenderContext* pRenderContext) override;
  52
  53     SwFrame * m_pLower;
  54     std::vector<SwAnchoredObject*> m_VertPosOrientFramesFor;
  55
  56     virtual SwTwips ShrinkFrame( SwTwips, bool bTst = false, bool bInfo = false ) override;
  57     virtual SwTwips GrowFrame  ( SwTwips, bool bTst = false, bool bInfo = false ) override;
  58
  59     tools::Long CalcRel( const SwFormatFrameSize &rSz ) const;
  60
  61 public:
  62     // --> #i28701#
  63
  64     virtual void PaintSubsidiaryLines( const SwPageFrame*, const SwRect& ) const;
  65     void RefreshLaySubsidiary( const SwPageFrame*, const SwRect& ) const;
  66     void RefreshExtraData( const SwRect & ) const;
  67
  68     /// Change size of lowers proportionally
  69     void ChgLowersProp( const Size& rOldSize );
  70
  71     void AdjustColumns( const SwFormatCol *pCol, bool bAdjustAttributes );
  72
  73     void ChgColumns( const SwFormatCol &rOld, const SwFormatCol &rNew,
  74         const bool bChgFootnote = false );
  75
  76     /// Paints the column separation line for the inner columns
  77     void PaintColLines( const SwRect &, const SwFormatCol &,
  78                         const SwPageFrame * ) const;
  79
  80     virtual bool    FillSelection( SwSelectionList& rList, const SwRect& rRect ) const override;
  81
  82     virtual bool GetModelPositionForViewPoint( SwPosition *, Point&,
  83                                SwCursorMoveState* = nullptr, bool bTestBackground = false ) const override;
  84
  85     virtual void Cut() override;
  86     virtual void Paste( SwFrame* pParent, SwFrame* pSibling = nullptr ) override;
  87
  88     /**
  89      * Finds the closest Content for the SPoint
  90      * Is used for Pages, Flys and Cells if GetModelPositionForViewPoint failed
  91      */
  92     const SwContentFrame* GetContentPos( Point &rPoint, const bool bDontLeave,
  93                                    const bool bBodyOnly = false,
  94                                    SwCursorMoveState *pCMS = nullptr,
  95                                    const bool bDefaultExpand = true ) const;
  96
  97     SwLayoutFrame( SwFrameFormat*, SwFrame* );
  98
  99     virtual void PaintSwFrame( vcl::RenderContext& rRenderContext, SwRect const&,
 100                         SwPrintData const*const pPrintData = nullptr ) const override;
 101     const SwFrame *Lower() const { return m_pLower; }
 102           SwFrame *Lower()       { return m_pLower; }
 103     const SwContentFrame *ContainsContent() const;
 104     inline SwContentFrame *ContainsContent();
 105     const SwCellFrame *FirstCell() const;
 106     inline SwCellFrame *FirstCell();
 107
 108     /**
 109      * Method <ContainsAny()> doesn't investigate content of footnotes by default.
 110      * But under certain circumstances this investigation is intended.
 111      * Thus, introduce new optional parameter <_bInvestigateFootnoteForSections>.
 112      * It's default is <false>, still indicating that content of footnotes isn't
 113      * investigated for sections.
 114      */
 115     const SwFrame *ContainsAny( const bool _bInvestigateFootnoteForSections = false ) const;
 116     inline SwFrame *ContainsAny( const bool _bInvestigateFootnoteForSections = false );
 117     bool IsAnLower( const SwFrame * ) const;
 118
 119     virtual const SwFrameFormat *GetFormat() const;
 120     virtual       SwFrameFormat *GetFormat();
 121     void        SetFrameFormat( SwFrameFormat* );
 122
 123     /**
 124      * Moving the Footnotes of all Lowers - starting from StartContent
 125      *
 126      * @returns true if at least one Footnote was moved
 127      * Calls the page number update if bFootnoteNums is set
 128      */
 129     bool MoveLowerFootnotes( SwContentFrame *pStart, SwFootnoteBossFrame *pOldBoss,
 130                         SwFootnoteBossFrame *pNewBoss, const bool bFootnoteNums );
 131
 132     // --> #i28701# - change purpose of method and its name
 133     // --> #i44016# - add parameter <_bUnlockPosOfObjs> to
 134     /// force an unlockposition call for the lower objects.
 135     void NotifyLowerObjs( const bool _bUnlockPosOfObjs = false );
 136
 137     /**
 138      * Invalidates the inner Frames, whose width and/or height are
 139      * calculated using percentages.
 140      * Frames that are anchored to this or inner Frames, are also invalidated.
 141      */
 142     void InvaPercentLowers( SwTwips nDiff = 0 );
 143
 144     /// Called by Format for Frames and Areas with columns
 145     void FormatWidthCols( const SwBorderAttrs &, const SwTwips nBorder,
 146                           const SwTwips nMinHeight );
 147
 148     /**
 149      * InnerHeight returns the height of the content and may be bigger or
 150      * less than the PrtArea-Height of the layoutframe himself
 151      */
 152     SwTwips InnerHeight() const;
 153
 154     /** method to check relative position of layout frame to
 155         a given layout frame.
 156
 157         refactoring of pseudo-local method <lcl_Apres(..)> in
 158         <txtftn.cxx> for #104840#.
 159
 160         @param _aCheckRefLayFrame
 161         constant reference of an instance of class <SwLayoutFrame> which
 162         is used as the reference for the relative position check.
 163
 164         @return true, if <this> is positioned before the layout frame <p>
 165     */
 166     bool IsBefore( const SwLayoutFrame* _pCheckRefLayFrame ) const;
 167
 168     const SwFrame* GetLastLower() const;
 169     inline SwFrame* GetLastLower();
 170
 171     virtual void PaintBreak() const;
 172
 173     void SetVertPosOrientFrameFor(SwAnchoredObject *pObj)
 174     {
 175         m_VertPosOrientFramesFor.push_back(pObj);
 176     }
 177
 178     void ClearVertPosOrientFrameFor(SwAnchoredObject *pObj)
 179     {
 180         m_VertPosOrientFramesFor.erase(
 181             std::remove(m_VertPosOrientFramesFor.begin(),
 182                 m_VertPosOrientFramesFor.end(), pObj),
 183             m_VertPosOrientFramesFor.end());
 184     }
 185 };
 186
 187 /**
 188  * In order to save us from duplicating implementations, we cast here
 189  * a little.
 190  */
 191 inline SwContentFrame* SwLayoutFrame::ContainsContent()
 192 {
 193     return const_cast<SwContentFrame*>(static_cast<const SwLayoutFrame*>(this)->ContainsContent());
 194 }
 195
 196 inline SwCellFrame* SwLayoutFrame::FirstCell()
 197 {
 198     return const_cast<SwCellFrame*>(static_cast<const SwLayoutFrame*>(this)->FirstCell());
 199 }
 200
 201 inline SwFrame* SwLayoutFrame::ContainsAny( const bool _bInvestigateFootnoteForSections )
 202 {
 203     return const_cast<SwFrame*>(static_cast<const SwLayoutFrame*>(this)->ContainsAny( _bInvestigateFootnoteForSections ));
 204 }
 205
 206 /**
 207  * These SwFrame inlines are here, so that frame.hxx does not need to include layfrm.hxx
 208  */
 209 inline bool SwFrame::IsColBodyFrame() const
 210 {
 211     return mnFrameType == SwFrameType::Body && GetUpper()->IsColumnFrame();
 212 }
 213
 214 inline bool SwFrame::IsPageBodyFrame() const
 215 {
 216     return mnFrameType == SwFrameType::Body && GetUpper()->IsPageFrame();
 217 }
 218
 219 inline SwFrame* SwLayoutFrame::GetLastLower()
 220 {
 221     return const_cast<SwFrame*>(static_cast<const SwLayoutFrame*>(this)->GetLastLower());
 222 }
 223
 224 #endif // INCLUDED_SW_SOURCE_CORE_INC_LAYFRM_HXX
 225
 226 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */