embeddedobj/source/inc/oleembobj.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 <com/sun/star/uno/Sequence.hxx>
  23 #include <com/sun/star/uno/Reference.hxx>
  24 #include <com/sun/star/embed/XEmbeddedObject.hpp>
  25 #include <com/sun/star/embed/XEmbeddedOleObject.hpp>
  26 #include <com/sun/star/embed/XInplaceObject.hpp>
  27 #include <com/sun/star/embed/XEmbedPersist.hpp>
  28 #include <com/sun/star/embed/XLinkageSupport.hpp>
  29 #include <com/sun/star/embed/VerbDescriptor.hpp>
  30 #include <com/sun/star/container/XChild.hpp>
  31 #include <com/sun/star/util/XCloseable.hpp>
  32 #include <com/sun/star/util/XCloseListener.hpp>
  33 #include <com/sun/star/io/XActiveDataStreamer.hpp>
  34 #include <com/sun/star/lang/XInitialization.hpp>
  35 #include <com/sun/star/lang/XServiceInfo.hpp>
  36 #include <com/sun/star/uno/XComponentContext.hpp>
  37 #include <cppuhelper/implbase.hxx>
  38 #include <rtl/ref.hxx>
  39
  40 #include <osl/thread.h>
  41 #include <memory>
  42
  43 namespace comphelper {
  44     class OMultiTypeInterfaceContainerHelper2;
  45 }
  46
  47 class VerbExecutionController
  48 {
  49     // the following mutex is allowed to be locked only for variables initialization, so no deadlock can be caused
  50     ::osl::Mutex    m_aVerbExecutionMutex;
  51
  52     sal_Int32 m_nNotificationLock;
  53
  54 #ifdef _WIN32
  55     bool m_bWasEverActive;
  56     bool m_bVerbExecutionInProgress;
  57     oslThreadIdentifier m_nVerbExecutionThreadIdentifier;
  58     bool m_bChangedOnVerbExecution;
  59 #endif
  60
  61 public:
  62
  63     VerbExecutionController()
  64     : m_nNotificationLock( 0 )
  65 #ifdef _WIN32
  66     , m_bWasEverActive( false )
  67     , m_bVerbExecutionInProgress( false )
  68     , m_nVerbExecutionThreadIdentifier( 0 )
  69     , m_bChangedOnVerbExecution( false )
  70 #endif
  71     {}
  72
  73 #ifdef _WIN32
  74     void StartControlExecution();
  75     bool EndControlExecution_WasModified();
  76     void ModificationNotificationIsDone();
  77     // no need to lock anything to check the value of the numeric members
  78     bool CanDoNotification() { return ( !m_bVerbExecutionInProgress && !m_bWasEverActive && !m_nNotificationLock ); }
  79     // ... or to change it
  80     void ObjectIsActive() { m_bWasEverActive = true; }
  81 #endif
  82     void LockNotification();
  83     void UnlockNotification();
  84 };
  85
  86 class VerbExecutionControllerGuard
  87 {
  88     VerbExecutionController& m_rController;
  89 public:
  90
  91     VerbExecutionControllerGuard( VerbExecutionController& rController )
  92     : m_rController( rController )
  93     {
  94         m_rController.LockNotification();
  95     }
  96
  97     ~VerbExecutionControllerGuard()
  98     {
  99         m_rController.UnlockNotification();
 100     }
 101 };
 102
 103
 104 class OleComponent;
 105 class OwnView_Impl;
 106 /**
 107  * Represents an OLE object that has native data and we try to let an external
 108  * application handle that data.
 109  */
 110 class OleEmbeddedObject : public ::cppu::WeakImplHelper
 111                         < css::embed::XEmbeddedObject
 112                         , css::embed::XEmbeddedOleObject
 113                         , css::embed::XEmbedPersist
 114                         , css::embed::XLinkageSupport
 115                         , css::embed::XInplaceObject
 116                         , css::container::XChild
 117                         , css::io::XActiveDataStreamer
 118                         , css::lang::XInitialization
 119                         , css::lang::XServiceInfo >
 120 {
 121     friend class OleComponent;
 122
 123     ::osl::Mutex    m_aMutex;
 124
 125     rtl::Reference<OleComponent> m_pOleComponent;
 126
 127     std::unique_ptr<::comphelper::OMultiTypeInterfaceContainerHelper2> m_pInterfaceContainer;
 128
 129     bool m_bReadOnly;
 130
 131     bool m_bDisposed;
 132     sal_Int32 m_nObjectState;
 133     sal_Int32 m_nTargetState;
 134     sal_Int32 m_nUpdateMode;
 135
 136     css::uno::Reference< css::uno::XComponentContext > m_xContext;
 137
 138     css::uno::Sequence< sal_Int8 > m_aClassID;
 139     OUString m_aClassName;
 140
 141     css::uno::Reference< css::embed::XEmbeddedClient > m_xClientSite;
 142
 143     OUString m_aContainerName;
 144
 145     css::uno::Reference< css::util::XCloseListener > m_xClosePreventer;
 146
 147     bool m_bWaitSaveCompleted;
 148     bool m_bNewVisReplInStream;
 149     css::uno::Reference< css::io::XStream > m_xNewCachedVisRepl;
 150     OUString m_aNewEntryName;
 151     css::uno::Reference< css::embed::XStorage > m_xNewParentStorage;
 152     css::uno::Reference< css::io::XStream > m_xNewObjectStream;
 153     bool m_bStoreLoaded;
 154
 155     css::uno::Reference< css::io::XStream > m_xCachedVisualRepresentation;
 156     bool m_bVisReplInitialized;
 157     bool m_bVisReplInStream;
 158     bool m_bStoreVisRepl;
 159
 160     bool m_bIsLink;
 161
 162     // TODO/LATER: may need to cache more than one aspect in future
 163     bool m_bHasCachedSize; // the object has cached size
 164     css::awt::Size m_aCachedSize;
 165     sal_Int64 m_nCachedAspect;
 166
 167     bool m_bHasSizeToSet;  // the object has cached size that should be set to OLE component
 168     css::awt::Size m_aSizeToSet; // this size might be different from the cached one ( scaling is applied )
 169     sal_Int64 m_nAspectToSet;
 170
 171
 172     // cache the status of the object
 173     // TODO/LATER: may need to cache more than one aspect in future
 174     bool m_bGotStatus;
 175     sal_Int64 m_nStatus;
 176     sal_Int64 m_nStatusAspect;
 177
 178     // embedded object related stuff
 179     OUString m_aEntryName;
 180     css::uno::Reference< css::embed::XStorage > m_xParentStorage;
 181     css::uno::Reference< css::io::XStream > m_xObjectStream;
 182
 183     // link related stuff
 184     OUString m_aLinkURL; // ???
 185
 186     // points to own view provider if the object has no server
 187     rtl::Reference<OwnView_Impl> m_xOwnView;
 188
 189     // whether the object should be initialized from clipboard in case of default initialization
 190     bool m_bFromClipboard;
 191
 192     OUString m_aTempURL;
 193
 194     OUString m_aTempDumpURL;
 195
 196     // STAMPIT solution
 197     // the following member is used during verb execution to detect whether the verb execution modifies the object
 198     VerbExecutionController m_aVerbExecutionController;
 199
 200     // if the following member is set, the object works in wrapper mode
 201     css::uno::Reference< css::embed::XEmbeddedObject > m_xWrappedObject;
 202     bool m_bTriedConversion;
 203     OUString m_aFilterName; // if m_bTriedConversion, then the filter detected by that
 204
 205     css::uno::Reference< css::uno::XInterface > m_xParent;
 206
 207     /// If it is allowed to modify entries in the stream of the OLE storage.
 208     bool m_bStreamReadOnly = false;
 209
 210 protected:
 211     /// @throws css::uno::Exception
 212     css::uno::Reference< css::io::XStream > TryToGetAcceptableFormat_Impl(
 213                                     const css::uno::Reference< css::io::XStream >& xStream );
 214
 215     /// @throws css::io::IOException
 216     /// @throws css::uno::RuntimeException
 217     css::uno::Reference< css::io::XStream > GetNewFilledTempStream_Impl(
 218                                     const css::uno::Reference< css::io::XInputStream >& xInStream );
 219 #ifdef _WIN32
 220     void SwitchComponentToRunningState_Impl();
 221 #endif
 222     void MakeEventListenerNotification_Impl( const OUString& aEventName );
 223 #ifdef _WIN32
 224     void StateChangeNotification_Impl( bool bBeforeChange, sal_Int32 nOldState, sal_Int32 nNewState );
 225     css::uno::Reference< css::io::XOutputStream > GetStreamForSaving();
 226
 227
 228     css::uno::Sequence< sal_Int32 > GetIntermediateVerbsSequence_Impl( sal_Int32 nNewState );
 229
 230     static css::uno::Sequence< sal_Int32 > GetReachableStatesList_Impl(
 231                         const css::uno::Sequence< css::embed::VerbDescriptor >& aVerbList );
 232 #endif
 233
 234     void Dispose();
 235
 236     void SwitchOwnPersistence(
 237                 const css::uno::Reference< css::embed::XStorage >& xNewParentStorage,
 238                 const css::uno::Reference< css::io::XStream >& xNewObjectStream,
 239                 const OUString& aNewName );
 240
 241     void SwitchOwnPersistence(
 242                 const css::uno::Reference< css::embed::XStorage >& xNewParentStorage,
 243                 const OUString& aNewName );
 244
 245     void GetRidOfComponent();
 246
 247     /// @throws css::uno::Exception
 248     void StoreToLocation_Impl(
 249                             const css::uno::Reference< css::embed::XStorage >& xStorage,
 250                             const OUString& sEntName,
 251                             const css::uno::Sequence< css::beans::PropertyValue >& lObjArgs,
 252                             bool bSaveAs );
 253 #ifdef _WIN32
 254     /// @throws css::uno::Exception
 255     void StoreObjectToStream( css::uno::Reference< css::io::XOutputStream > const & xOutStream );
 256 #endif
 257     /// @throws css::uno::Exception
 258     void InsertVisualCache_Impl(
 259             const css::uno::Reference< css::io::XStream >& xTargetStream,
 260             const css::uno::Reference< css::io::XStream >& xCachedVisualRepresentation );
 261
 262     /// @throws css::uno::Exception
 263     void RemoveVisualCache_Impl( const css::uno::Reference< css::io::XStream >& xTargetStream );
 264
 265     void SetVisReplInStream( bool bExists );
 266     bool HasVisReplInStream();
 267
 268     /// @throws css::uno::Exception
 269     css::embed::VisualRepresentation GetVisualRepresentationInNativeFormat_Impl(
 270                     const css::uno::Reference< css::io::XStream >& xCachedVisRepr );
 271
 272     css::uno::Reference< css::io::XStream > TryToRetrieveCachedVisualRepresentation_Impl(
 273                     const css::uno::Reference< css::io::XStream >& xStream,
 274                     bool bAllowRepair50 = false )
 275         noexcept;
 276 #ifdef _WIN32
 277     bool SaveObject_Impl();
 278     bool OnShowWindow_Impl( bool bShow );
 279     void CreateOleComponent_Impl( rtl::Reference<OleComponent> const & pOleComponent = {} );
 280     void CreateOleComponentAndLoad_Impl( rtl::Reference<OleComponent> const & pOleComponent = {} );
 281     void CreateOleComponentFromClipboard_Impl( OleComponent* pOleComponent = nullptr );
 282     OUString CreateTempURLEmpty_Impl();
 283     OUString GetTempURL_Impl();
 284     void SetObjectIsLink_Impl( bool bIsLink ) { m_bIsLink = bIsLink; }
 285 #endif
 286
 287     // the following 4 methods are related to switch to wrapping mode
 288     void MoveListeners();
 289     css::uno::Reference< css::embed::XStorage > CreateTemporarySubstorage( OUString& o_aStorageName );
 290     OUString MoveToTemporarySubstream();
 291     bool TryToConvertToOOo( const css::uno::Reference< css::io::XStream >& xStream );
 292
 293 public:
 294     // in case a new object must be created the class ID must be specified
 295     OleEmbeddedObject( css::uno::Reference< css::uno::XComponentContext > xContext,
 296                         const css::uno::Sequence< sal_Int8 >& aClassID,
 297                         OUString  aClassName );
 298
 299     // in case object will be loaded from a persistent entry or from a file the class ID will be detected on loading
 300     // factory can do it for OOo objects, but for OLE objects OS dependent code is required
 301     OleEmbeddedObject( css::uno::Reference< css::uno::XComponentContext > xContext,
 302                         bool bLink );
 303 #ifdef _WIN32
 304     // this constructor let object be initialized from clipboard
 305     OleEmbeddedObject( const css::uno::Reference< css::uno::XComponentContext >& xContext );
 306 #endif
 307
 308     virtual ~OleEmbeddedObject() override;
 309
 310 #ifdef _WIN32
 311     static void OnIconChanged_Impl();
 312     void OnViewChanged_Impl();
 313     void OnClosed_Impl();
 314 #endif
 315
 316 // XEmbeddedObject
 317
 318     virtual void SAL_CALL changeState( sal_Int32 nNewState ) override;
 319
 320     virtual css::uno::Sequence< sal_Int32 > SAL_CALL getReachableStates() override;
 321
 322     virtual sal_Int32 SAL_CALL getCurrentState() override;
 323
 324     virtual void SAL_CALL doVerb( sal_Int32 nVerbID ) override;
 325
 326     virtual css::uno::Sequence< css::embed::VerbDescriptor > SAL_CALL getSupportedVerbs() override;
 327
 328     virtual void SAL_CALL setClientSite(
 329                 const css::uno::Reference< css::embed::XEmbeddedClient >& xClient ) override;
 330
 331     virtual css::uno::Reference< css::embed::XEmbeddedClient > SAL_CALL getClientSite() override;
 332
 333     virtual void SAL_CALL update() override;
 334
 335     virtual void SAL_CALL setUpdateMode( sal_Int32 nMode ) override;
 336
 337     virtual sal_Int64 SAL_CALL getStatus( sal_Int64 nAspect ) override;
 338
 339     virtual void SAL_CALL setContainerName( const OUString& sName ) override;
 340
 341
 342 // XVisualObject
 343
 344     virtual void SAL_CALL setVisualAreaSize( sal_Int64 nAspect, const css::awt::Size& aSize ) override;
 345
 346     virtual css::awt::Size SAL_CALL getVisualAreaSize( sal_Int64 nAspect ) override;
 347
 348     virtual css::embed::VisualRepresentation SAL_CALL getPreferredVisualRepresentation( ::sal_Int64 nAspect ) override;
 349
 350     virtual sal_Int32 SAL_CALL getMapUnit( sal_Int64 nAspect ) override;
 351
 352
 353 // XEmbedPersist
 354
 355     virtual void SAL_CALL setPersistentEntry(
 356                     const css::uno::Reference< css::embed::XStorage >& xStorage,
 357                     const OUString& sEntName,
 358                     sal_Int32 nEntryConnectionMode,
 359                     const css::uno::Sequence< css::beans::PropertyValue >& lArguments,
 360                     const css::uno::Sequence< css::beans::PropertyValue >& lObjArgs ) override;
 361
 362     virtual void SAL_CALL storeToEntry( const css::uno::Reference< css::embed::XStorage >& xStorage, const OUString& sEntName, const css::uno::Sequence< css::beans::PropertyValue >& lArguments, const css::uno::Sequence< css::beans::PropertyValue >& lObjArgs ) override;
 363
 364     virtual void SAL_CALL storeAsEntry(
 365                 const css::uno::Reference< css::embed::XStorage >& xStorage,
 366                 const OUString& sEntName,
 367                 const css::uno::Sequence< css::beans::PropertyValue >& lArguments,
 368                 const css::uno::Sequence< css::beans::PropertyValue >& lObjArgs ) override;
 369
 370     virtual void SAL_CALL saveCompleted( sal_Bool bUseNew ) override;
 371
 372     virtual sal_Bool SAL_CALL hasEntry() override;
 373
 374     virtual OUString SAL_CALL getEntryName() override;
 375
 376 // XLinkageSupport
 377
 378     virtual void SAL_CALL breakLink( const css::uno::Reference< css::embed::XStorage >& xStorage,
 379                                      const OUString& sEntName ) override;
 380
 381     virtual sal_Bool SAL_CALL isLink() override;
 382
 383     virtual OUString SAL_CALL getLinkURL() override;
 384
 385 // XCommonEmbedPersist
 386     virtual void SAL_CALL storeOwn() override;
 387
 388     virtual sal_Bool SAL_CALL isReadonly() override;
 389
 390     virtual void SAL_CALL reload(
 391                 const css::uno::Sequence< css::beans::PropertyValue >& lArguments,
 392                 const css::uno::Sequence< css::beans::PropertyValue >& lObjArgs ) override;
 393
 394 // XClassifiedObject
 395
 396     virtual css::uno::Sequence< sal_Int8 > SAL_CALL getClassID() override;
 397
 398     virtual OUString SAL_CALL getClassName() override;
 399
 400     virtual void SAL_CALL setClassInfo(
 401                 const css::uno::Sequence< sal_Int8 >& aClassID, const OUString& aClassName ) override;
 402
 403 // XStateChangeBroadcaster
 404     virtual void SAL_CALL addStateChangeListener( const css::uno::Reference< css::embed::XStateChangeListener >& xListener ) override;
 405     virtual void SAL_CALL removeStateChangeListener( const css::uno::Reference< css::embed::XStateChangeListener >& xListener ) override;
 406
 407
 408 // XComponentSupplier
 409
 410     virtual css::uno::Reference< css::util::XCloseable > SAL_CALL getComponent() override;
 411
 412 // XCloseable
 413
 414     virtual void SAL_CALL close( sal_Bool DeliverOwnership ) override;
 415
 416     virtual void SAL_CALL addCloseListener(
 417                 const css::uno::Reference< css::util::XCloseListener >& Listener ) override;
 418
 419     virtual void SAL_CALL removeCloseListener(
 420                 const css::uno::Reference< css::util::XCloseListener >& Listener ) override;
 421
 422 // XEventBroadcaster
 423     virtual void SAL_CALL addEventListener(
 424                 const css::uno::Reference< css::document::XEventListener >& Listener ) override;
 425
 426     virtual void SAL_CALL removeEventListener(
 427                 const css::uno::Reference< css::document::XEventListener >& Listener ) override;
 428
 429 // XInplaceObject ( only for wrapping scenario here )
 430
 431     virtual void SAL_CALL setObjectRectangles( const css::awt::Rectangle& aPosRect,
 432                                           const css::awt::Rectangle& aClipRect ) override;
 433
 434     virtual void SAL_CALL enableModeless( sal_Bool bEnable ) override;
 435
 436     virtual void SAL_CALL translateAccelerators(
 437                     const css::uno::Sequence< css::awt::KeyEvent >& aKeys ) override;
 438
 439     // XChild ( only for wrapping scenario here )
 440     virtual css::uno::Reference< css::uno::XInterface > SAL_CALL getParent(  ) override;
 441     virtual void SAL_CALL setParent( const css::uno::Reference< css::uno::XInterface >& Parent ) override;
 442
 443     // XActiveDataStreamer
 444     void SAL_CALL setStream(const css::uno::Reference<css::io::XStream>& xStream) override;
 445     css::uno::Reference<css::io::XStream> SAL_CALL getStream() override;
 446
 447     // XInitialization
 448     void SAL_CALL initialize(const css::uno::Sequence<css::uno::Any>& rArguments) override;
 449
 450     // XServiceInfo
 451     OUString SAL_CALL getImplementationName() override;
 452     sal_Bool SAL_CALL supportsService( const OUString& ServiceName ) override;
 453     css::uno::Sequence< OUString > SAL_CALL getSupportedServiceNames() override;
 454 };
 455
 456 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */