/* -*- 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_NODE_HXX #define INCLUDED_SW_INC_NODE_HXX #include #include #include "swdllapi.h" #include #include #include #include #include #include class SwContentFrame; class SwContentNode; class SwDoc; class SwEndNode; class SwFrame; class SwFrameFormat; class SwGrfNode; class SwNoTextNode; class SwNodeIndex; class SwOLENode; class SwRect; class SwSection; class SwSectionFormat; class SwTOXBase; class SwSectionNode; class SwStartNode; class SwTabFrame; class SwRootFrame; class SwTable; class SwTableNode; class SwTableBox; class SwTextNode; class SwPageDesc; class SwViewShell; struct SwPosition; class IStyleAccess; class IDocumentSettingAccess; class IDocumentDeviceAccess; class IDocumentMarkAccess; class IDocumentRedlineAccess; class IDocumentStylePoolAccess; class IDocumentLinksAdministration; class IDocumentFieldsAccess; class IDocumentContentOperations; class IDocumentListItems; class Point; typedef std::vector SwOLENodes; // docary.hxx //UUUU namespace drawinglayer { namespace attribute { class SdrAllFillAttributesHelper; typedef std::shared_ptr< SdrAllFillAttributesHelper > SdrAllFillAttributesHelperPtr; }} /// Base class of the Writer document model elements. class SW_DLLPUBLIC SwNode : private BigPtrEntry { friend class SwNodes; sal_uInt8 m_nNodeType; /// For text nodes: level of auto format. Was put here because we had still free bits. sal_uInt8 m_nAFormatNumLvl : 3; bool m_bSetNumLSpace : 1; ///< For numbering: TRUE: set indent. bool m_bIgnoreDontExpand : 1; ///< for Text Attributes - ignore the flag #ifdef DBG_UTIL static long s_nSerial; long m_nSerial; #endif /// all SwFrameFormat that are anchored at the node /// invariant: SwFrameFormat is in the list iff /// SwFrameFormat::GetAnchor().GetContentAnchor() points to this node std::unique_ptr> m_pAnchoredFlys; protected: SwStartNode* m_pStartOfSection; SwNode( const SwNodeIndex &rWhere, const sal_uInt8 nNodeId ); /// for the initial StartNode SwNode( SwNodes& rNodes, sal_uLong nPos, const sal_uInt8 nNodeId ); public: /** the = 0 forces the class to be an abstract base class, but the dtor can be still called from subclasses */ virtual ~SwNode() = 0; #ifdef DBG_UTIL long GetSerial() const { return m_nSerial; } #endif sal_uInt16 GetSectionLevel() const; inline sal_uLong StartOfSectionIndex() const; inline const SwStartNode* StartOfSectionNode() const { return m_pStartOfSection; } inline SwStartNode* StartOfSectionNode() { return m_pStartOfSection; } inline sal_uLong EndOfSectionIndex() const; inline const SwEndNode* EndOfSectionNode() const; inline SwEndNode* EndOfSectionNode(); inline sal_uInt8 GetAutoFormatLvl() const { return m_nAFormatNumLvl; } inline void SetAutoFormatLvl( sal_uInt8 nVal ) { m_nAFormatNumLvl = nVal; } inline void SetNumLSpace( bool bFlag ) { m_bSetNumLSpace = bFlag; } inline bool IsIgnoreDontExpand() const { return m_bIgnoreDontExpand; } inline void SetIgnoreDontExpand( bool bNew ) { m_bIgnoreDontExpand = bNew; } sal_uInt8 GetNodeType() const { return m_nNodeType; } inline SwStartNode *GetStartNode(); inline const SwStartNode *GetStartNode() const; inline SwContentNode *GetContentNode(); inline const SwContentNode *GetContentNode() const; inline SwEndNode *GetEndNode(); inline const SwEndNode *GetEndNode() const; inline SwTextNode *GetTextNode(); inline const SwTextNode *GetTextNode() const; inline SwOLENode *GetOLENode(); inline const SwOLENode *GetOLENode() const; inline SwNoTextNode *GetNoTextNode(); inline const SwNoTextNode *GetNoTextNode() const; inline SwGrfNode *GetGrfNode(); inline const SwGrfNode *GetGrfNode() const; inline SwTableNode *GetTableNode(); inline const SwTableNode *GetTableNode() const; inline SwSectionNode *GetSectionNode(); inline const SwSectionNode *GetSectionNode() const; inline bool IsStartNode() const; inline bool IsContentNode() const; inline bool IsEndNode() const; inline bool IsTextNode() const; inline bool IsTableNode() const; inline bool IsSectionNode() const; inline bool IsOLENode() const; inline bool IsNoTextNode() const; inline bool IsGrfNode() const; /** Checks if this node is in redlines. @retval true this node is in redlines @retval false else */ bool IsInRedlines() const; /** Search table node, in which it is. If it is in no table @return 0. */ SwTableNode *FindTableNode(); inline const SwTableNode *FindTableNode() const; /** Search section node, in which it is. If it is in no section @return 0. */ SwSectionNode *FindSectionNode(); inline const SwSectionNode *FindSectionNode() const; SwStartNode* FindSttNodeByType( SwStartNodeType eTyp ); inline const SwStartNode* FindSttNodeByType( SwStartNodeType eTyp ) const; const SwStartNode* FindTableBoxStartNode() const { return FindSttNodeByType( SwTableBoxStartNode ); } const SwStartNode* FindFlyStartNode() const { return FindSttNodeByType( SwFlyStartNode ); } const SwStartNode* FindFootnoteStartNode() const { return FindSttNodeByType( SwFootnoteStartNode ); } const SwStartNode* FindHeaderStartNode() const { return FindSttNodeByType( SwHeaderStartNode ); } const SwStartNode* FindFooterStartNode() const { return FindSttNodeByType( SwFooterStartNode ); } /// Node is in which nodes-array/doc? inline SwNodes& GetNodes(); inline const SwNodes& GetNodes() const; inline SwDoc* GetDoc(); inline const SwDoc* GetDoc() const; /** Provides access to the document setting interface */ const IDocumentSettingAccess* getIDocumentSettingAccess() const; /** Provides access to the document device interface */ const IDocumentDeviceAccess& getIDocumentDeviceAccess() const; /** Provides access to the document bookmark interface */ const IDocumentMarkAccess* getIDocumentMarkAccess() const; /** Provides access to the document redline interface */ const IDocumentRedlineAccess& getIDocumentRedlineAccess() const; /** Provides access to the document style pool interface */ const IDocumentStylePoolAccess& getIDocumentStylePoolAccess() const; /** Provides access to the document draw model interface */ const IDocumentDrawModelAccess& getIDocumentDrawModelAccess() const; /** Provides access to the document layout interface */ const IDocumentLayoutAccess& getIDocumentLayoutAccess() const; IDocumentLayoutAccess& getIDocumentLayoutAccess(); /** Provides access to the document links administration interface */ const IDocumentLinksAdministration& getIDocumentLinksAdministration() const; IDocumentLinksAdministration& getIDocumentLinksAdministration(); /** Provides access to the document fields administration interface */ const IDocumentFieldsAccess& getIDocumentFieldsAccess() const; IDocumentFieldsAccess& getIDocumentFieldsAccess(); /** Provides access to the document content operations interface */ IDocumentContentOperations& getIDocumentContentOperations(); /** Provides access to the document automatic styles interface */ IStyleAccess& getIDocumentStyleAccess(); /** Provides access to the document's numbered items interface @author OD */ IDocumentListItems& getIDocumentListItems(); /// Is node in the visible area of the Shell? bool IsInVisibleArea( SwViewShell const * pSh = nullptr ) const; /// Is node in an protected area? bool IsInProtectSect() const; /** Is node in something that is protected (range, frame, table cells ... including anchor in case of frames or footnotes)? */ bool IsProtect() const; /** Search PageDesc with which this node is formatted. If layout is existent search over layout, else only the hard way is left: search over the nodes to the front!! */ const SwPageDesc* FindPageDesc( size_t* pPgDescNdIdx = nullptr ) const; /// If node is in a fly return the respective format. SwFrameFormat* GetFlyFormat() const; /// If node is in a table return the respective table box. SwTableBox* GetTableBox() const; inline sal_uLong GetIndex() const { return GetPos(); } const SwTextNode* FindOutlineNodeOfLevel( sal_uInt8 nLvl ) const; sal_uInt8 HasPrevNextLayNode() const; std::vector const* GetAnchoredFlys() const { return m_pAnchoredFlys.get(); } void AddAnchoredFly(SwFrameFormat *); void RemoveAnchoredFly(SwFrameFormat *); /** * Dumps the node structure to the given destination (file nodes.xml in the current directory by default) * @since 3.5 */ virtual void dumpAsXml(struct _xmlTextWriter* pWriter) const; private: SwNode( const SwNode & rNodes ) = delete; SwNode & operator= ( const SwNode & rNodes ) = delete; }; /// Starts a section of nodes in the document model. class SwStartNode: public SwNode { friend class SwNode; friend class SwNodes; friend class SwEndNode; ///< to set the theEndOfSection !! SwEndNode* m_pEndOfSection; SwStartNodeType m_eStartNodeType; /// for the initial StartNode SwStartNode( SwNodes& rNodes, sal_uLong nPos ); protected: SwStartNode( const SwNodeIndex &rWhere, const sal_uInt8 nNodeType = ND_STARTNODE, SwStartNodeType = SwNormalStartNode ); public: DECL_FIXEDMEMPOOL_NEWDEL(SwStartNode) SwStartNodeType GetStartNodeType() const { return m_eStartNodeType; } /// Call ChkCondcoll to all ContentNodes of section. void CheckSectionCondColl() const; virtual void dumpAsXml(struct _xmlTextWriter* pWriter) const override; private: SwStartNode( const SwStartNode & rNode ) = delete; SwStartNode & operator= ( const SwStartNode & rNode ) = delete; }; /// Ends a section of nodes in the document model. class SwEndNode : public SwNode { friend class SwNodes; friend class SwTableNode; ///< To enable creation of its EndNote. friend class SwSectionNode; ///< To enable creation of its EndNote. /// for the initial StartNode SwEndNode( SwNodes& rNodes, sal_uLong nPos, SwStartNode& rSttNd ); protected: SwEndNode( const SwNodeIndex &rWhere, SwStartNode& rSttNd ); DECL_FIXEDMEMPOOL_NEWDEL(SwEndNode) private: SwEndNode( const SwEndNode & rNode ) = delete; SwEndNode & operator= ( const SwEndNode & rNode ) = delete; }; // SwContentNode class SW_DLLPUBLIC SwContentNode: public SwModify, public SwNode, public SwIndexReg { //FEATURE::CONDCOLL SwDepend* m_pCondColl; //FEATURE::CONDCOLL mutable bool mbSetModifyAtAttr; protected: SwContentNode( const SwNodeIndex &rWhere, const sal_uInt8 nNodeType, SwFormatColl *pFormatColl ); /** the = 0 forces the class to be an abstract base class, but the dtor can be still called from subclasses */ virtual ~SwContentNode() = 0; /** Attribute-set for all auto attributes of a ContentNode. (e.g. TextNode or NoTextNode). */ std::shared_ptr mpAttrSet; /// Make respective nodes create the specific AttrSets. virtual void NewAttrSet( SwAttrPool& ) = 0; /** There some functions that like to remove items from the internal SwAttrSet (handle): */ sal_uInt16 ClearItemsFromAttrSet( const std::vector& rWhichIds ); virtual void Modify( const SfxPoolItem* pOld, const SfxPoolItem *pNew) override; public: /** MakeFrame will be called for a certain layout pSib is another SwFrame of the same layout (e.g. the SwRootFrame itself, a sibling, the parent) */ virtual SwContentFrame *MakeFrame( SwFrame* pSib ) = 0; virtual SwContentNode *SplitContentNode(const SwPosition & ) = 0; virtual SwContentNode *JoinNext(); virtual void JoinPrev(); /** Is it possible to join two nodes? In pIdx the second position can be returned. */ bool CanJoinNext( SwNodeIndex* pIdx =nullptr ) const; bool CanJoinPrev( SwNodeIndex* pIdx =nullptr ) const; void MakeStartIndex( SwIndex * pIdx ) { pIdx->Assign( this, 0 ); } void MakeEndIndex( SwIndex * pIdx ) { pIdx->Assign( this, Len() ); } bool GoNext(SwIndex *, sal_uInt16 nMode ) const; bool GoPrevious(SwIndex *, sal_uInt16 nMode ) const; /// Replacement for good old GetFrame(..): SwContentFrame *getLayoutFrame( const SwRootFrame*, const Point* pDocPos = nullptr, const SwPosition *pPos = nullptr, const bool bCalcFrame = true ) const; /** @return the real size of the frame or an empty rectangle if no layout exists. Needed for export filters. */ SwRect FindLayoutRect( const bool bPrtArea = false, const Point* pPoint = nullptr ) const; SwRect FindPageFrameRect() const; /** Method creates all views of document for given node. The content frames that are created are put in the respective layout. */ void MakeFrames( SwContentNode& rNode ); /** Method deletes all views of document for the node. The content- frames are removed from the respective layout. Add an input param to identify if acc table should be disposed */ void DelFrames( bool bIsAccTableDispose = true ); /** @return count of elements of node content. Default is 1. There are differences between text node and formula node. */ virtual sal_Int32 Len() const; virtual SwContentNode* MakeCopy( SwDoc*, const SwNodeIndex& ) const = 0; /// Get information from Client. virtual bool GetInfo( SfxPoolItem& ) const override; /// SS for PoolItems: hard attributation. /// If bInParent is FALSE search for attribute only in this node. const SfxPoolItem& GetAttr( sal_uInt16 nWhich, bool bInParent=true ) const; bool GetAttr( SfxItemSet& rSet ) const; /// made virtual virtual bool SetAttr( const SfxPoolItem& ); virtual bool SetAttr( const SfxItemSet& rSet ); virtual bool ResetAttr( sal_uInt16 nWhich1, sal_uInt16 nWhich2 = 0 ); virtual bool ResetAttr( const std::vector& rWhichArr ); virtual sal_uInt16 ResetAllAttr(); /// Obtains attribute that is not delivered via conditional style! const SfxPoolItem* GetNoCondAttr( sal_uInt16 nWhich, bool bInParents ) const; /** Does node has already its own auto-attributes? Access to SwAttrSet. */ inline const SwAttrSet &GetSwAttrSet() const; inline const SwAttrSet *GetpSwAttrSet() const { return static_cast(mpAttrSet.get()); } inline bool HasSwAttrSet() const { return mpAttrSet != nullptr; } virtual SwFormatColl* ChgFormatColl( SwFormatColl* ); SwFormatColl* GetFormatColl() const { return const_cast(static_cast(GetRegisteredIn())); } //FEATURE::CONDCOLL inline SwFormatColl& GetAnyFormatColl() const; void SetCondFormatColl( SwFormatColl* ); inline SwFormatColl* GetCondFormatColl() const; bool IsAnyCondition( SwCollCondition& rTmp ) const; void ChkCondColl(); //FEATURE::CONDCOLL /** Invalidates NumRule at the node. NumRule is updated on EndAction of a Shell at the latest. */ bool InvalidateNumRule(); /** determines the text direction for a certain position. @return -1, if text direction could *not* be determined. */ short GetTextDirection( const SwPosition& rPos, const Point* pPt ) const; inline void SetModifyAtAttr( bool bSetModifyAtAttr ) const { mbSetModifyAtAttr = bSetModifyAtAttr; } inline bool GetModifyAtAttr() const { return mbSetModifyAtAttr; } static SwOLENodes* CreateOLENodesArray( const SwFormatColl& rColl, bool bOnlyWithInvalidSize ); //UUUU Access to DrawingLayer FillAttributes in a preprocessed form for primitive usage virtual drawinglayer::attribute::SdrAllFillAttributesHelperPtr getSdrAllFillAttributesHelper() const; private: SwContentNode( const SwContentNode & rNode ) = delete; SwContentNode & operator= ( const SwContentNode & rNode ) = delete; }; // SwTableNode class SW_DLLPUBLIC SwTableNode : public SwStartNode, public SwModify { friend class SwNodes; SwTable* m_pTable; protected: virtual ~SwTableNode(); public: SwTableNode( const SwNodeIndex & ); const SwTable& GetTable() const { return *m_pTable; } SwTable& GetTable() { return *m_pTable; } SwTabFrame *MakeFrame( SwFrame* ); /// Creates the frms for the table node (i.e. the TabFrames). void MakeFrames( SwNodeIndex* pIdxBehind ); /** Method deletes all views of document for the node. The content frames are removed from the respective layout. */ void DelFrames(); /** Method creates all views of the document for the previous node. The content frames that are created are put into the respective layout. */ void MakeFrames( const SwNodeIndex & rIdx ); SwTableNode* MakeCopy( SwDoc*, const SwNodeIndex& ) const; void SetNewTable( SwTable* , bool bNewFrames=true ); // Removes redline objects that relate to this table from the 'Extra Redlines' table void RemoveRedlines(); private: SwTableNode( const SwTableNode & rNode ) = delete; SwTableNode & operator= ( const SwTableNode & rNode ) = delete; }; class SwSectionNode : public SwStartNode { friend class SwNodes; private: SwSectionNode(const SwSectionNode&) = delete; SwSectionNode& operator=(const SwSectionNode&) = delete; std::unique_ptr const m_pSection; protected: virtual ~SwSectionNode(); public: SwSectionNode(SwNodeIndex const&, SwSectionFormat & rFormat, SwTOXBase const*const pTOXBase); const SwSection& GetSection() const { return *m_pSection; } SwSection& GetSection() { return *m_pSection; } SwFrame *MakeFrame( SwFrame* ); /** Creates the frms for the SectionNode (i.e. the SectionFrames). On default the frames are created until the end of the range. When another NodeIndex pEnd is passed a MakeFrames is called up to it. Used by TableToText. */ void MakeFrames( SwNodeIndex* pIdxBehind, SwNodeIndex* pEnd = nullptr ); /** Method deletes all views of document for the node. The content frames are removed from the respective layout. */ void DelFrames(); /** Method creates all views of document for the previous node. The content frames created are put into the respective layout. */ void MakeFrames( const SwNodeIndex & rIdx ); SwSectionNode* MakeCopy( SwDoc*, const SwNodeIndex& ) const; /// Set pointer in format of section on itself. void NodesArrChgd(); /** Check for not hidden areas whether there is content that is not in a hidden sub-area. */ bool IsContentHidden() const; }; /** This class is internal, used only during DocumentContentOperationsManager::CopyWithFlyInFly(), and for undo. Some of the nodes are then replaced with SwPlaceholderNode, and at the end of the operation, removed again. FIXME find out if this is really necessary, and if we can avoid creation of the SwPlaceholderNodes in the first place. */ class SwPlaceholderNode : private SwNode { private: friend class SwNodes; SwPlaceholderNode(const SwNodeIndex &rWhere); }; inline SwEndNode *SwNode::GetEndNode() { return ND_ENDNODE == m_nNodeType ? static_cast(this) : nullptr; } inline const SwEndNode *SwNode::GetEndNode() const { return ND_ENDNODE == m_nNodeType ? static_cast(this) : nullptr; } inline SwStartNode *SwNode::GetStartNode() { return ND_STARTNODE & m_nNodeType ? static_cast(this) : nullptr; } inline const SwStartNode *SwNode::GetStartNode() const { return ND_STARTNODE & m_nNodeType ? static_cast(this) : nullptr; } inline SwTableNode *SwNode::GetTableNode() { return ND_TABLENODE == m_nNodeType ? static_cast(this) : nullptr; } inline const SwTableNode *SwNode::GetTableNode() const { return ND_TABLENODE == m_nNodeType ? static_cast(this) : nullptr; } inline SwSectionNode *SwNode::GetSectionNode() { return ND_SECTIONNODE == m_nNodeType ? static_cast(this) : nullptr; } inline const SwSectionNode *SwNode::GetSectionNode() const { return ND_SECTIONNODE == m_nNodeType ? static_cast(this) : nullptr; } inline SwContentNode *SwNode::GetContentNode() { return ND_CONTENTNODE & m_nNodeType ? static_cast(this) : nullptr; } inline const SwContentNode *SwNode::GetContentNode() const { return ND_CONTENTNODE & m_nNodeType ? static_cast(this) : nullptr; } inline bool SwNode::IsStartNode() const { return (ND_STARTNODE & m_nNodeType) != 0; } inline bool SwNode::IsContentNode() const { return (ND_CONTENTNODE & m_nNodeType) != 0; } inline bool SwNode::IsEndNode() const { return ND_ENDNODE == m_nNodeType; } inline bool SwNode::IsTextNode() const { return ND_TEXTNODE == m_nNodeType; } inline bool SwNode::IsTableNode() const { return ND_TABLENODE == m_nNodeType; } inline bool SwNode::IsSectionNode() const { return ND_SECTIONNODE == m_nNodeType; } inline bool SwNode::IsNoTextNode() const { return (ND_NOTXTNODE & m_nNodeType) != 0; } inline bool SwNode::IsOLENode() const { return ND_OLENODE == m_nNodeType; } inline bool SwNode::IsGrfNode() const { return ND_GRFNODE == m_nNodeType; } inline const SwStartNode* SwNode::FindSttNodeByType( SwStartNodeType eTyp ) const { return const_cast(this)->FindSttNodeByType( eTyp ); } inline const SwTableNode* SwNode::FindTableNode() const { return const_cast(this)->FindTableNode(); } inline const SwSectionNode* SwNode::FindSectionNode() const { return const_cast(this)->FindSectionNode(); } inline sal_uLong SwNode::StartOfSectionIndex() const { return m_pStartOfSection->GetIndex(); } inline sal_uLong SwNode::EndOfSectionIndex() const { const SwStartNode* pStNd = IsStartNode() ? static_cast(this) : m_pStartOfSection; return pStNd->m_pEndOfSection->GetIndex(); } inline const SwEndNode* SwNode::EndOfSectionNode() const { const SwStartNode* pStNd = IsStartNode() ? static_cast(this) : m_pStartOfSection; return pStNd->m_pEndOfSection; } inline SwEndNode* SwNode::EndOfSectionNode() { const SwStartNode* pStNd = IsStartNode() ? static_cast(this) : m_pStartOfSection; return pStNd->m_pEndOfSection; } inline SwNodes& SwNode::GetNodes() { return static_cast(GetArray()); } inline const SwNodes& SwNode::GetNodes() const { return static_cast(GetArray()); } inline SwDoc* SwNode::GetDoc() { return GetNodes().GetDoc(); } inline const SwDoc* SwNode::GetDoc() const { return GetNodes().GetDoc(); } inline SwFormatColl* SwContentNode::GetCondFormatColl() const { return m_pCondColl ? static_cast(m_pCondColl->GetRegisteredIn()) : nullptr; } inline SwFormatColl& SwContentNode::GetAnyFormatColl() const { return m_pCondColl && m_pCondColl->GetRegisteredIn() ? *static_cast(m_pCondColl->GetRegisteredIn()) : *const_cast(static_cast(GetRegisteredIn())); } inline const SwAttrSet& SwContentNode::GetSwAttrSet() const { return mpAttrSet ? *GetpSwAttrSet() : GetAnyFormatColl().GetAttrSet(); } //FEATURE::CONDCOLL inline const SfxPoolItem& SwContentNode::GetAttr( sal_uInt16 nWhich, bool bInParents ) const { return GetSwAttrSet().Get( nWhich, bInParents ); } inline SwPlaceholderNode::SwPlaceholderNode(const SwNodeIndex &rWhere) : SwNode(rWhere, ND_PLACEHOLDER) { } inline SwNodePtr SwNodes::operator[]( sal_uLong n ) const { return static_cast(BigPtrArray::operator[] ( n )); } #endif /* vim:set shiftwidth=4 softtabstop=4 expandtab: */