sw/inc/docsh.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_INC_DOCSH_HXX
  20 #define INCLUDED_SW_INC_DOCSH_HXX
  21
  22 #include <memory>
  23 #include <vector>
  24 #include <rtl/ref.hxx>
  25 #include <com/sun/star/uno/Sequence.h>
  26 #include <sfx2/docfac.hxx>
  27 #include <sfx2/objsh.hxx>
  28 #include "swdllapi.h"
  29 #include "shellid.hxx"
  30
  31 #include <svl/lstner.hxx>
  32 #include <sfx2/StyleManager.hxx>
  33 #include <o3tl/deleter.hxx>
  34
  35 class SwDoc;
  36 class SfxDocumentInfoDialog;
  37 class SfxInPlaceClient;
  38 class FontList;
  39 class SwEditShell;
  40 class SwView;
  41 class SwWrtShell;
  42 class SwFEShell;
  43 class Reader;
  44 class SwReader;
  45 typedef std::unique_ptr<SwReader, o3tl::default_delete<SwReader>> SwReaderPtr;
  46 class SwCursorShell;
  47 class SwSrcView;
  48 class SwPaM;
  49 class SwgReaderOption;
  50 class IDocumentDeviceAccess;
  51 class IDocumentChartDataProviderAccess;
  52 class SwDocShell;
  53 class SwDrawModel;
  54 class SwViewShell;
  55 namespace svt
  56 {
  57 class EmbeddedObjectRef;
  58 }
  59 namespace com::sun::star::frame { class XController; }
  60 namespace ooo::vba { class XSinkCaller; }
  61 namespace ooo::vba::word { class XDocument; }
  62
  63 // initialize DrawModel (in form of a SwDrawModel) and DocShell (in form of a SwDocShell)
  64 // as needed, one or both parameters may be zero
  65 void InitDrawModelAndDocShell(SwDocShell* pSwDocShell, SwDrawModel* pSwDrawModel);
  66
  67 class SW_DLLPUBLIC SwDocShell
  68     : public SfxObjectShell
  69     , public SfxListener
  70 {
  71     rtl::Reference< SwDoc >                 m_xDoc;      ///< Document.
  72     rtl::Reference< SfxStyleSheetBasePool > m_xBasePool; ///< Passing through for formats.
  73     std::unique_ptr<FontList> m_pFontList;          ///< Current Fontlist.
  74     bool        m_IsInUpdateFontList; ///< prevent nested calls of UpdateFontList
  75
  76     std::unique_ptr<sfx2::StyleManager> m_pStyleManager;
  77
  78     /** For "historical reasons" nothing can be done without the WrtShell.
  79      Back-pointer on View (again "for historical reasons").
  80      Back-pointer is valid until in Activate a new one is set
  81      or until it is deleted in the View's Dtor. */
  82
  83     SwView*     m_pView;
  84     SwWrtShell* m_pWrtShell;
  85
  86     std::unique_ptr<comphelper::EmbeddedObjectContainer> m_pOLEChildList;
  87     sal_Int16   m_nUpdateDocMode;   ///< contains the css::document::UpdateDocMode
  88     bool        m_IsATemplate;      ///< prevent nested calls of UpdateFontList
  89
  90     bool m_IsRemovedInvisibleContent;
  91         ///< whether SID_MAIL_PREPAREEXPORT removed content that
  92         ///< SID_MAIL_EXPORT_FINISHED needs to restore
  93
  94     css::uno::Reference< ooo::vba::XSinkCaller > mxAutomationDocumentEventsCaller;
  95     css::uno::Reference< ooo::vba::word::XDocument> mxAutomationDocumentObject;
  96
  97     /// Methods for access to doc.
  98     SAL_DLLPRIVATE void                  AddLink();
  99     SAL_DLLPRIVATE void                  RemoveLink();
 100
 101     /// Catch hint for DocInfo.
 102     SAL_DLLPRIVATE virtual void          Notify( SfxBroadcaster& rBC, const SfxHint& rHint ) override;
 103
 104     /// FileIO
 105     SAL_DLLPRIVATE virtual bool InitNew( const css::uno::Reference< css::embed::XStorage >& xStorage ) override;
 106     SAL_DLLPRIVATE virtual bool Load( SfxMedium& rMedium ) override;
 107     SAL_DLLPRIVATE virtual bool LoadFrom( SfxMedium& rMedium ) override;
 108     SAL_DLLPRIVATE virtual bool ConvertFrom( SfxMedium &rMedium ) override;
 109     SAL_DLLPRIVATE virtual bool ConvertTo( SfxMedium &rMedium ) override;
 110     SAL_DLLPRIVATE virtual bool SaveAs( SfxMedium& rMedium ) override;
 111     SAL_DLLPRIVATE virtual bool SaveCompleted( const css::uno::Reference< css::embed::XStorage >& xStorage ) override;
 112
 113     SAL_DLLPRIVATE virtual bool     PrepareClose( bool bUI = true ) override;
 114
 115     SAL_DLLPRIVATE virtual bool     InsertGeneratedStream(SfxMedium& rMedium,
 116             css::uno::Reference<css::text::XTextRange> const& xInsertPosition)
 117         override;
 118
 119     /// Make DocInfo known to the Doc.
 120     SAL_DLLPRIVATE virtual std::shared_ptr<SfxDocumentInfoDialog> CreateDocumentInfoDialog(weld::Window* pParent,
 121                                                                                            const SfxItemSet &rSet) override;
 122     /// OLE-stuff
 123     SAL_DLLPRIVATE virtual void Draw(OutputDevice*, const JobSetup&, sal_uInt16 nAspect, bool bOutputToWindow) override;
 124
 125     /// Methods for StyleSheets
 126
 127     /// @param nSlot
 128     /// Only used for nFamily == SfxStyleFamily::Page. Identifies optional Slot by which the edit is triggered.
 129     /// Used to activate certain dialog pane
 130     SAL_DLLPRIVATE void Edit(
 131         weld::Window* pDialogParent,
 132         const OUString &rName,
 133         const OUString& rParent,
 134         const SfxStyleFamily nFamily,
 135         SfxStyleSearchBits nMask,
 136         const bool bNew,
 137         const OUString& sPageId,
 138         SwWrtShell* pActShell,
 139         SfxRequest* pRequest = nullptr,
 140         sal_uInt16 nSlot = 0);
 141
 142     SAL_DLLPRIVATE void                  Delete(const OUString &rName, SfxStyleFamily nFamily);
 143     SAL_DLLPRIVATE void                  Hide(const OUString &rName, SfxStyleFamily nFamily, bool bHidden);
 144     SAL_DLLPRIVATE SfxStyleFamily        ApplyStyles(const OUString &rName,
 145         const SfxStyleFamily nFamily,
 146         SwWrtShell* pShell,
 147         sal_uInt16 nMode);
 148     SAL_DLLPRIVATE SfxStyleFamily        DoWaterCan( const OUString &rName, SfxStyleFamily nFamily);
 149     SAL_DLLPRIVATE void                  UpdateStyle(const OUString &rName, SfxStyleFamily nFamily, SwWrtShell* pShell);
 150     SAL_DLLPRIVATE void                  MakeByExample(const OUString &rName,
 151                                                SfxStyleFamily nFamily, SfxStyleSearchBits nMask, SwWrtShell* pShell);
 152
 153     SAL_DLLPRIVATE void                  SubInitNew();   ///< for InitNew and HtmlSourceMode.
 154
 155     SAL_DLLPRIVATE void                  RemoveOLEObjects();
 156     SAL_DLLPRIVATE void                  CalcLayoutForOLEObjects();
 157
 158     SAL_DLLPRIVATE void                  Init_Impl();
 159
 160     using SfxObjectShell::GetVisArea;
 161
 162 protected:
 163     /// override to update text fields
 164     virtual void                DoFlushDocInfo() override;
 165
 166 public:
 167     /// but we implement this ourselves.
 168     SFX_DECL_INTERFACE(SW_DOCSHELL)
 169     SFX_DECL_OBJECTFACTORY()
 170
 171 private:
 172     /// SfxInterface initializer.
 173     static void InitInterface_Impl();
 174
 175 public:
 176     static OUString GetEventName( sal_Int32 nId );
 177
 178     /// Doc is required for SO data exchange!
 179     SwDocShell( SfxObjectCreateMode eMode = SfxObjectCreateMode::EMBEDDED );
 180     SwDocShell( SfxModelFlags i_nSfxCreationFlags );
 181     SwDocShell( SwDoc& rDoc, SfxObjectCreateMode eMode );
 182     virtual ~SwDocShell() override;
 183
 184     /// OLE 2.0-notification.
 185     DECL_DLLPRIVATE_LINK( Ole2ModifiedHdl, bool, void );
 186
 187     /// OLE-stuff.
 188     virtual void      SetVisArea( const tools::Rectangle &rRect ) override;
 189     virtual tools::Rectangle GetVisArea( sal_uInt16 nAspect ) const override;
 190     virtual Printer  *GetDocumentPrinter() override;
 191     virtual OutputDevice* GetDocumentRefDev() override;
 192     virtual void      OnDocumentPrinterChanged( Printer * pNewPrinter ) override;
 193
 194     virtual void            SetModified( bool = true ) override;
 195
 196     /// Dispatcher
 197     void                    Execute(SfxRequest &);
 198     void                    ExecStyleSheet(SfxRequest&);
 199
 200     void                    GetState(SfxItemSet &);
 201     void                    StateStyleSheet(SfxItemSet&, SwWrtShell* pSh = nullptr );
 202
 203     /// returns Doc. But be careful!
 204     SwDoc*                   GetDoc() { return m_xDoc.get(); }
 205     const SwDoc*             GetDoc() const { return m_xDoc.get(); }
 206     IDocumentDeviceAccess&          getIDocumentDeviceAccess();
 207     IDocumentChartDataProviderAccess& getIDocumentChartDataProviderAccess();
 208
 209     void                    UpdateFontList();
 210     void                    UpdateChildWindows();
 211
 212     /// global IO.
 213     virtual bool            Save() override;
 214
 215     /// For Style PI.
 216     virtual SfxStyleSheetBasePool*  GetStyleSheetPool() override;
 217     virtual sfx2::StyleManager* GetStyleManager() override;
 218
 219     /// Set View for actions via Shell.
 220     void          SetView(SwView* pVw);
 221     const SwView *GetView() const { return m_pView; }
 222     SwView       *GetView()       { return m_pView; }
 223
 224     /// Access to the SwWrtShell belonging to SwView.
 225           SwWrtShell *GetWrtShell()       { return m_pWrtShell; }
 226     const SwWrtShell *GetWrtShell() const { return m_pWrtShell; }
 227     // Same as GetWrtShell, but return pointer to SwEditShell base of
 228     // (potentially incomplete) SwWrtShell:
 229     SwEditShell * GetEditShell();
 230
 231     /// For Core - it knows the DocShell but not the WrtShell!
 232           SwFEShell *GetFEShell();
 233     const SwFEShell *GetFEShell() const
 234                 { return const_cast<SwDocShell*>(this)->GetFEShell(); }
 235
 236     /// For inserting document.
 237     Reader* StartConvertFrom(SfxMedium& rMedium, SwReaderPtr& rpRdr,
 238                             SwCursorShell const * pCursorSh = nullptr, SwPaM* pPaM = nullptr);
 239
 240 #if defined(_WIN32)
 241     virtual bool DdeGetData( const OUString& rItem, const OUString& rMimeType,
 242                              css::uno::Any & rValue ) override;
 243     virtual bool DdeSetData( const OUString& rItem, const OUString& rMimeType,
 244                              const css::uno::Any & rValue ) override;
 245 #endif
 246     virtual ::sfx2::SvLinkSource* DdeCreateLinkSource( const OUString& rItem ) override;
 247     virtual void ReconnectDdeLink(SfxObjectShell& rServer) override;
 248
 249     virtual void FillClass( SvGlobalName * pClassName,
 250                                    SotClipboardFormatId * pClipFormat,
 251                                    OUString * pLongUserName,
 252                                    sal_Int32 nFileFormat,
 253                                    bool bTemplate = false ) const override;
 254
 255     virtual std::set<Color> GetDocColors() override;
 256
 257     virtual std::shared_ptr<model::ColorSet> GetThemeColors() override;
 258
 259     sfx::AccessibilityIssueCollection runAccessibilityCheck() override;
 260
 261     virtual void LoadStyles( SfxObjectShell& rSource ) override;
 262
 263     void LoadStyles_( SfxObjectShell& rSource, bool bPreserveCurrentDocument );
 264
 265     /// Show page style format dialog
 266     /// @param nSlot
 267     /// Identifies slot by which the dialog is triggered. Used to activate certain dialog pane
 268     void FormatPage(
 269         weld::Window* pDialogParent,
 270         const OUString& rPage,
 271         const OUString& rPageId,
 272         SwWrtShell& rActShell,
 273         SfxRequest* pRequest = nullptr);
 274
 275     // #i59688#
 276     /** linked graphics are now loaded on demand.
 277      Thus, loading of linked graphics no longer needed and necessary for
 278      the load of document being finished. */
 279
 280     void LoadingFinished();
 281
 282     /// Cancel transfer (called from SFX).
 283     virtual void CancelTransfers() override;
 284
 285     /// Re-read Doc from Html-source.
 286     void    ReloadFromHtml( const OUString& rStreamName, SwSrcView* pSrcView );
 287
 288     sal_Int16   GetUpdateDocMode() const { return m_nUpdateDocMode; }
 289
 290     void ToggleLayoutMode(SwView* pView);
 291
 292     ErrCode LoadStylesFromFile(const OUString& rURL, SwgReaderOption& rOpt, bool bUnoCall);
 293     void InvalidateModel();
 294     void ReactivateModel();
 295
 296     virtual css::uno::Sequence< OUString >  GetEventNames() override;
 297
 298     /// #i20883# Digital Signatures and Encryption
 299     virtual HiddenInformation GetHiddenInformationState( HiddenInformation nStates ) override;
 300
 301     /** #i42634# Overwrites SfxObjectShell::UpdateLinks
 302      This new function is necessary to trigger update of links in docs
 303      read by the binary filter: */
 304     virtual void UpdateLinks() override;
 305
 306     css::uno::Reference< css::frame::XController >
 307                                 GetController();
 308
 309     SfxInPlaceClient* GetIPClient( const ::svt::EmbeddedObjectRef& xObjRef );
 310     SAL_DLLPRIVATE bool IsTemplate() const { return m_IsATemplate; }
 311     SAL_DLLPRIVATE void SetIsTemplate( bool bValue ) { m_IsATemplate = bValue; }
 312
 313     virtual const ::sfx2::IXmlIdRegistry* GetXmlIdRegistry() const override;
 314
 315     /** passwword protection for Writer (derived from SfxObjectShell)
 316      see also:    FN_REDLINE_ON, FN_REDLINE_ON */
 317     virtual bool    IsChangeRecording() const override;
 318     virtual bool    HasChangeRecordProtection() const override;
 319     virtual void    SetChangeRecording( bool bActivate, bool bLockAllViews = false ) override;
 320     virtual void    SetProtectionPassword( const OUString &rPassword ) override;
 321     virtual bool    GetProtectionHash( /*out*/ css::uno::Sequence< sal_Int8 > &rPasswordHash ) override;
 322
 323     void RegisterAutomationDocumentEventsCaller(css::uno::Reference< ooo::vba::XSinkCaller > const& xCaller);
 324     void CallAutomationDocumentEventSinks(const OUString& Method, css::uno::Sequence< css::uno::Any >& Arguments);
 325     void RegisterAutomationDocumentObject(css::uno::Reference< ooo::vba::word::XDocument > const& xDocument);
 326
 327     // Lock all unlocked views, and returns a guard object which unlocks those views when destructed
 328     virtual std::unique_ptr<LockAllViewsGuard> LockAllViews() override;
 329
 330 protected:
 331     class LockAllViewsGuard_Impl final : public LockAllViewsGuard
 332     {
 333         std::vector<SwViewShell*> m_aViewWasUnLocked;
 334
 335     public:
 336         explicit LockAllViewsGuard_Impl(SwViewShell* pViewShell);
 337         ~LockAllViewsGuard_Impl();
 338     };
 339
 340 };
 341
 342 /** Find the right DocShell and create a new one:
 343     The return value specifies what should happen to the Shell
 344     0 - Error, could not find the DocShell
 345     1 - DocShell is an existing Document
 346     2 - DocShell was created anew, thus it needs to be closed again
 347         (will be assigned to xLockRef additionally)
 348 */
 349 int SwFindDocShell( SfxObjectShellRef& xDocSh,
 350                     SfxObjectShellLock& xLockRef,
 351                     std::u16string_view rFileName,
 352                     const OUString& rPasswd,
 353                     const OUString& rFilter,
 354                     sal_Int16 nVersion,
 355                     SwDocShell* pDestSh );
 356
 357 #endif
 358
 359 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */