/* -*- 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 SW_FMTMETA_HXX #define SW_FMTMETA_HXX #include #include #include #include #include #include namespace com { namespace sun { namespace star { namespace text { class XTextField; } }}} /** * The classes that make up a meta entity are: *
*
SwTxtMeta
the text hint
*
SwFmtMeta
the pool item
*
sw::Meta
the metadatable entity itself
*
SwXMeta
the UNO wrapper object
*
* * The text hint contains the pool item (as usual) and has a pointer to the * text node at which it is attached. * The pool item has a shared pointer to the metadatable entity, and a reverse * pointer to the text attribute at which it is attached. * The pool item is non-poolable; it may only be attached to one text * attribute. * Of all the pool items that refer to a metadatable entity, only one may be * in the document content at any time. Others may be in the undo array, or in * undo objects. * The metadatable entity has a reverse pointer to the pool item that is * currently in the document. It also registers as a client at the text node * at which it is attached via this pool item and its text attribute. * The UNO wrapper object registers as a client at the metadatable entity. * * Copying the metadatable entity proceeds in the following way: *
    *
  1. The pool item is cloned (because it is non-poolable); the clone * points to the same metadatable entity, but the metadatable entity's * reverse pointer is unchanged.
  2. *
  3. The DoCopy() method is called at the new pool item: * it will clone the metadatable entity (using RegisterAsCopyOf). * This is necessary, because first, a metadatable entity may * only be inserted once into a document, and second, the copy may be * inserted into a different document than the source document!
  4. *
  5. A new text hint is created, taking over the new pool item.
  6. *
  7. The text hint is inserted into the hints array of some text node.
  8. *
*/ class SwTxtMeta; class SwXMeta; class SwXMetaField; namespace sw { class Meta; } class SwFmtMeta : public SfxPoolItem { private: friend class SwTxtMeta; ///< needs SetTxtAttr, DoCopy friend class ::sw::Meta; ///< needs m_pTxtAttr ::boost::shared_ptr< ::sw::Meta > m_pMeta; SwTxtMeta * m_pTxtAttr; SwTxtMeta * GetTxtAttr() { return m_pTxtAttr; } void SetTxtAttr(SwTxtMeta * const i_pTxtAttr); /// this method must be called when the hint is actually copied void DoCopy(::sw::MetaFieldManager & i_rTargetDocManager, SwTxtNode & i_rTargetTxtNode); explicit SwFmtMeta( const sal_uInt16 i_nWhich ); public: /// takes ownership explicit SwFmtMeta( ::boost::shared_ptr< ::sw::Meta > const & i_pMeta, const sal_uInt16 i_nWhich ); virtual ~SwFmtMeta(); /// SfxPoolItem virtual int operator==( const SfxPoolItem & ) const; virtual SfxPoolItem * Clone( SfxItemPool *pPool = 0 ) const; /// notify clients registered at m_pMeta that this meta is being (re-)moved void NotifyChangeTxtNode(SwTxtNode *const pTxtNode); static SwFmtMeta * CreatePoolDefault( const sal_uInt16 i_nWhich ); ::sw::Meta * GetMeta() { return m_pMeta.get(); } }; namespace sw { class MetaFieldManager; class Meta : public ::sfx2::Metadatable , public SwModify { protected: friend class ::SwFmtMeta; ///< SetFmtMeta, NotifyChangeTxtNode friend class ::SwXMeta; ///< GetTxtNode, GetTxtAttr, Get/SetXMeta ::com::sun::star::uno::WeakReference< ::com::sun::star::rdf::XMetadatable> m_wXMeta; SwFmtMeta * m_pFmt; SwTxtNode * m_pTxtNode; SwTxtMeta * GetTxtAttr() const; SwTxtNode * GetTxtNode() const; ///< @return 0 if not in document (undo) SwFmtMeta * GetFmtMeta() const { return m_pFmt; } void SetFmtMeta( SwFmtMeta * const i_pFmt ) { m_pFmt = i_pFmt; }; void NotifyChangeTxtNodeImpl(); void NotifyChangeTxtNode(SwTxtNode *const pTxtNode); ::com::sun::star::uno::WeakReference< ::com::sun::star::rdf::XMetadatable> const& GetXMeta() const { return m_wXMeta; } void SetXMeta(::com::sun::star::uno::Reference< ::com::sun::star::rdf::XMetadatable> const& xMeta) { m_wXMeta = xMeta; } /// SwClient virtual void Modify( const SfxPoolItem* pOld, const SfxPoolItem *pNew ); public: explicit Meta(SwFmtMeta * const i_pFmt = 0); virtual ~Meta(); /// sfx2::Metadatable virtual ::sfx2::IXmlIdRegistry& GetRegistry(); virtual bool IsInClipboard() const; virtual bool IsInUndo() const; virtual bool IsInContent() const; virtual ::com::sun::star::uno::Reference< ::com::sun::star::rdf::XMetadatable > MakeUnoObject(); }; class MetaField : public Meta { private: friend class ::SwFmtMeta; friend class ::SwXMetaField; friend class ::sw::MetaFieldManager; sal_uInt32 m_nNumberFormat; bool m_bIsFixedLanguage; sal_uInt32 GetNumberFormat(OUString const & rContent) const; void SetNumberFormat(sal_uInt32 nNumberFormat); bool IsFixedLanguage() const { return m_bIsFixedLanguage; } void SetIsFixedLanguage(bool b) { m_bIsFixedLanguage = b; } explicit MetaField(SwFmtMeta * const i_pFmt = 0, const sal_uInt32 nNumberFormat = SAL_MAX_UINT32, const bool bIsFixedLanguage = false ); public: /// get prefix/suffix from the RDF repository. @throws RuntimeException void GetPrefixAndSuffix( OUString *const o_pPrefix, OUString *const o_pSuffix); }; /// knows all meta-fields in the document. class MetaFieldManager : private ::boost::noncopyable { private: typedef ::std::vector< ::boost::weak_ptr > MetaFieldList_t; MetaFieldList_t m_MetaFields; public: MetaFieldManager(); ::boost::shared_ptr makeMetaField( SwFmtMeta * const i_pFmt = 0, const sal_uInt32 nNumberFormat = SAL_MAX_UINT32, const bool bIsFixedLanguage = false ); /// get all meta fields ::std::vector< ::com::sun::star::uno::Reference< ::com::sun::star::text::XTextField> > getMetaFields(); }; } // namespace sw #endif // SW_FMTMETA_HXX /* vim:set shiftwidth=4 softtabstop=4 expandtab: */