AppController.hxx

Go to the documentation of this file.

/* -*- 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 .
 */
 
#pragma once
 
#include <AppElementType.hxx>
#include <callbacks.hxx>
#include <commontypes.hxx>
#include <dsntypes.hxx>
#include <dbaccess/genericcontroller.hxx>
#include <linkeddocuments.hxx>
#include <TableCopyHelper.hxx>
 
#include <com/sun/star/beans/XPropertyChangeListener.hpp>
#include <com/sun/star/container/XContainerListener.hpp>
#include <com/sun/star/sdb/application/XDatabaseDocumentUI.hpp>
#include <com/sun/star/ui/XContextMenuInterception.hpp>
 
#include <comphelper/namedvaluecollection.hxx>
#include <comphelper/uno3.hxx>
#include <cppuhelper/implbase5.hxx>
#include <comphelper/interfacecontainer2.hxx>
#include <vcl/transfer.hxx>
#include <svx/dataaccessdescriptor.hxx>
 
#include <memory>
 
class TransferableHelper;
class TransferableClipboardListener;
 
namespace com::sun::star {
    namespace container {
        class XNameContainer;
        class XContainer;
    }
    namespace ucb {
        class XContent;
    }
}
 
namespace svx
{
    class OComponentTransferable;
}
 
namespace weld
{
    class TreeView;
}
 
namespace dbaui
{
    class ODataClipboard;
    class TreeListBox;
    class SubComponentManager;
    class OApplicationController;
    class OApplicationView;
    class OLinkedDocumentsAccess;
    class SelectionNotifier;
 
    typedef ::cppu::ImplHelper5 <   css::container::XContainerListener
                                ,   css::beans::XPropertyChangeListener
                                ,   css::sdb::application::XDatabaseDocumentUI
                                ,   css::ui::XContextMenuInterception
                                ,   css::view::XSelectionSupplier
                                >   OApplicationController_Base;
 
 
    class OApplicationController
            :public OGenericUnoController
            ,public OApplicationController_Base
            ,public IControlActionListener
            ,public IContextMenuProvider
    {
    public:
        typedef std::vector< css::uno::Reference< css::container::XContainer > >  TContainerVector;
 
    private:
 
        OTableCopyHelper::DropDescriptor            m_aAsyncDrop;
 
        SharedConnection        m_xDataSourceConnection;
        css::uno::Reference< css::sdbc::XDatabaseMetaData >
                                m_xMetaData;
 
        TransferableDataHelper  m_aSystemClipboard;     // content of the clipboard
        css::uno::Reference< css::beans::XPropertySet >
                                m_xDataSource;
        css::uno::Reference< css::frame::XModel >
                                m_xModel;
        ::comphelper::OInterfaceContainerHelper2
                                m_aContextMenuInterceptors;
 
        TContainerVector        m_aCurrentContainers;       // the containers where we are listener on
        ::rtl::Reference< SubComponentManager >
                                m_pSubComponentManager;
        ::dbaccess::ODsnTypeCollection
                                m_aTypeCollection;
        OTableCopyHelper        m_aTableCopyHelper;
        rtl::Reference<TransferableClipboardListener>
                                m_pClipboardNotifier;        // notifier for changes in the clipboard
        ImplSVEvent *           m_nAsyncDrop;
        OAsynchronousLink       m_aSelectContainerEvent;
        PreviewMode             m_ePreviewMode;             // the mode of the preview
        ElementType             m_eCurrentType;
        bool                    m_bNeedToReconnect;         // true when the settings of the data source were modified and the connection is no longer up to date
        bool                    m_bSuspended;               // is true when the controller was already suspended
 
        std::unique_ptr< SelectionNotifier >
                                m_pSelectionNotifier;
        typedef std::map< ElementType, std::vector< OUString > > SelectionByElementType;
        SelectionByElementType  m_aPendingSelection;
 
    private:
 
        OApplicationView*       getContainer() const;
 
        OUString getDatabaseName() const;
 
        OUString getStrippedDatabaseName() const;
 
        static ElementType getElementType(const css::uno::Reference< css::container::XContainer >& _xContainer);
 
        css::uno::Reference< css::lang::XComponent > openElementWithArguments(
            const OUString& _sName,
            ElementType _eType,
            ElementOpenMode _eOpenMode,
            sal_uInt16 _nInstigatorCommand,
            const ::comphelper::NamedValueCollection& _rAdditionalArguments
        );
 
        css::uno::Reference< css::lang::XComponent >
            newElement(
                ElementType _eType,
                const ::comphelper::NamedValueCollection& i_rAdditionalArguments,
                css::uno::Reference< css::lang::XComponent >& o_rDocumentDefinition
            );
 
        void newElementWithPilot( ElementType _eType );
 
        void convertToView(const OUString& _sName);
 
        bool isConnectionReadOnly() const;
 
        void getSelectionElementNames( std::vector< OUString>& _rNames ) const;
 
        void deleteEntries();
 
        void renameEntry();
 
        void deleteObjects( ElementType _eType,
                            const std::vector< OUString>& _rList,
                            bool _bConfirm );
 
        void deleteTables(const std::vector< OUString>& _rList);
 
        rtl::Reference<TransferableHelper> copyObject();
 
        bool copySQLObject(ODataClipboard& rExchange);
 
        bool copyDocObject(svx::OComponentTransferable& rExchange);
 
        css::uno::Reference< css::container::XNameAccess > getElements(ElementType _eType);
 
        std::unique_ptr<OLinkedDocumentsAccess> getDocumentsAccess(ElementType _eType);
 
        css::uno::Reference< css::container::XNameContainer> getQueryDefinitions() const;
 
        void pasteFormat(SotClipboardFormatId _nFormatId);
 
        bool paste( ElementType _eType, const svx::ODataAccessDescriptor& _rPasteData, const OUString& _sParentFolder = OUString(), bool _bMove = false);
 
        const TransferableDataHelper& getViewClipboard() const { return m_aSystemClipboard; }
 
        bool isTableFormat() const;
 
        static void getSupportedFormats(ElementType _eType,std::vector<SotClipboardFormatId>& _rFormatIds);
 
        void addContainerListener(const css::uno::Reference< css::container::XNameAccess>& _xCollection);
 
        void openDialog(const OUString& _sServiceName);
 
        void askToReconnect();
 
        void onDocumentOpened(
            const OUString&  _rName,
            const sal_Int32         _nType,
            const ElementOpenMode   _eMode,
            const css::uno::Reference< css::lang::XComponent >& _xDocument,
            const css::uno::Reference< css::lang::XComponent >& _xDefinition
        );
 
        bool insertHierarchyElement(  ElementType _eType
                                    ,const OUString& _sParentFolder
                                    ,bool _bCollection = true
                                    ,const css::uno::Reference< css::ucb::XContent>& _xContent = css::uno::Reference< css::ucb::XContent>()
                                    ,bool _bMove = false);
        bool isRenameDeleteAllowed(ElementType _eType, bool _bDelete) const;
        void doAction(sal_uInt16 _nId, ElementOpenMode _eOpenMode);
 
        OUString getCurrentlySelectedName(sal_Int32& _rnCommandType) const;
 
        void showPreviewFor( const ElementType _eType,const OUString& _sName );
 
        void onAttachedFrame();
 
        bool    impl_isAlterableView_nothrow( const OUString& _rTableOrViewName ) const;
 
        void    impl_validateObjectTypeAndName_throw( const sal_Int32 _nObjectType, const ::std::optional< OUString >& i_rObjectName );
 
    protected:
        // initializing members
 
        // state of a feature. 'feature' may be the handle of a css::util::URL somebody requested a dispatch interface for OR a toolbar slot.
        virtual FeatureState    GetState(sal_uInt16 nId) const override;
        // execute a feature
        virtual void            Execute(sal_uInt16 nId, const css::uno::Sequence< css::beans::PropertyValue>& aArgs) override;
 
        // OGenericUnoController
        virtual void            onLoadedMenu( const css::uno::Reference< css::frame::XLayoutManager >& _xLayoutManager ) override;
 
        virtual css::uno::Reference< css::frame::XModel > getPrivateModel() const override
        {
            return m_xModel;
        }
 
        virtual ~OApplicationController() override;
 
    public:
        explicit OApplicationController(const css::uno::Reference< css::uno::XComponentContext >& _rxORB);
 
        DECLARE_XINTERFACE( )
        DECLARE_XTYPEPROVIDER( )
 
        // XServiceInfo
        virtual OUString SAL_CALL getImplementationName() override;
        virtual css::uno::Sequence< OUString> SAL_CALL getSupportedServiceNames() override;
 
        // css::frame::XController
        virtual void SAL_CALL attachFrame(const css::uno::Reference< css::frame::XFrame > & xFrame) override;
        virtual sal_Bool SAL_CALL suspend(sal_Bool bSuspend) override;
        virtual sal_Bool SAL_CALL attachModel(const css::uno::Reference< css::frame::XModel > & xModel) override;
        virtual css::uno::Reference< css::frame::XModel >  SAL_CALL getModel() override;
 
        // css::container::XContainerListener
        virtual void SAL_CALL elementInserted(const css::container::ContainerEvent& Event) override;
        virtual void SAL_CALL elementRemoved(const css::container::ContainerEvent& Event) override;
        virtual void SAL_CALL elementReplaced(const css::container::ContainerEvent& Event) override;
 
        // XPropertyChangeListener
        virtual void SAL_CALL propertyChange( const css::beans::PropertyChangeEvent& evt ) override;
 
        // XDatabaseDocumentUI
        virtual css::uno::Reference< css::sdbc::XDataSource > SAL_CALL getDataSource() override;
        virtual css::uno::Reference< css::awt::XWindow > SAL_CALL getApplicationMainWindow() override;
        virtual css::uno::Reference< css::sdbc::XConnection > SAL_CALL getActiveConnection() override;
        virtual css::uno::Sequence< css::uno::Reference< css::lang::XComponent > > SAL_CALL getSubComponents() override;
        virtual sal_Bool SAL_CALL isConnected(  ) override;
        // DO NOT CALL with getMutex() held!!
        virtual void SAL_CALL connect(  ) override;
        virtual css::beans::Pair< ::sal_Int32, OUString > SAL_CALL identifySubComponent( const css::uno::Reference< css::lang::XComponent >& SubComponent ) override;
        virtual sal_Bool SAL_CALL closeSubComponents(  ) override;
        virtual css::uno::Reference< css::lang::XComponent > SAL_CALL loadComponent( ::sal_Int32 ObjectType, const OUString& ObjectName, sal_Bool ForEditing ) override;
        virtual css::uno::Reference< css::lang::XComponent > SAL_CALL loadComponentWithArguments( ::sal_Int32 ObjectType, const OUString& ObjectName, sal_Bool ForEditing, const css::uno::Sequence< css::beans::PropertyValue >& Arguments ) override;
        virtual css::uno::Reference< css::lang::XComponent > SAL_CALL createComponent( ::sal_Int32 ObjectType, css::uno::Reference< css::lang::XComponent >& o_DocumentDefinition ) override;
        virtual css::uno::Reference< css::lang::XComponent > SAL_CALL createComponentWithArguments( ::sal_Int32 ObjectType, const css::uno::Sequence< css::beans::PropertyValue >& Arguments, css::uno::Reference< css::lang::XComponent >& o_DocumentDefinition ) override;
 
        // XContextMenuInterception
        virtual void SAL_CALL registerContextMenuInterceptor( const css::uno::Reference< css::ui::XContextMenuInterceptor >& Interceptor ) override;
        virtual void SAL_CALL releaseContextMenuInterceptor( const css::uno::Reference< css::ui::XContextMenuInterceptor >& Interceptor ) override;
 
        // XSelectionSupplier
        virtual sal_Bool SAL_CALL select( const css::uno::Any& xSelection ) override;
        virtual css::uno::Any SAL_CALL getSelection(  ) override;
        virtual void SAL_CALL addSelectionChangeListener( const css::uno::Reference< css::view::XSelectionChangeListener >& xListener ) override;
        virtual void SAL_CALL removeSelectionChangeListener( const css::uno::Reference< css::view::XSelectionChangeListener >& xListener ) override;
 
        const SharedConnection& ensureConnection( ::dbtools::SQLExceptionInfo* _pErrorInfo = nullptr );
 
        const SharedConnection& getConnection() const { return m_xDataSourceConnection; }
 
        bool isConnected() const { return m_xDataSourceConnection.is(); }
 
        void refreshTables();
 
        bool onEntryDoubleClick(const weld::TreeView& rTree);
 
        bool onContainerSelect(ElementType _eType);
 
        void onSelectionChanged();
 
        void onCopyEntry();
 
        void onPasteEntry();
 
        void onDeleteEntry();
 
        void previewChanged( sal_Int32 _nMode);
 
        void containerFound( const css::uno::Reference< css::container::XContainer >& _xContainer);
 
        // IController
        virtual bool        isDataSourceReadOnly() const override;
 
        // IControlActionListener overridables
        virtual bool        requestQuickHelp(const void* pUserData, OUString& rText) const override;
        virtual bool        requestDrag(const weld::TreeIter& rEntry) override;
        virtual sal_Int8    queryDrop( const AcceptDropEvent& _rEvt, const DataFlavorExVector& _rFlavors ) override;
        virtual sal_Int8    executeDrop( const ExecuteDropEvent& _rEvt ) override;
 
        // IContextMenuProvider
        virtual OUString          getContextMenuResourceName() const override;
        virtual IController&      getCommandController() override;
        virtual ::comphelper::OInterfaceContainerHelper2*
                                getContextMenuInterceptors() override;
        virtual css::uno::Any getCurrentSelection(weld::TreeView& rControl) const override;
        virtual vcl::Window* getMenuParent() const override;
        virtual void adjustMenuPosition(const weld::TreeView& rControl, ::Point& rPos) const override;
 
        void OnInvalidateClipboard();
        DECL_LINK( OnClipboardChanged, TransferableDataHelper*, void );
        DECL_LINK( OnAsyncDrop, void*, void );
        DECL_LINK( OnCreateWithPilot, void*, void );
        DECL_LINK( OnSelectContainer, void*, void );
        void OnFirstControllerConnected();
 
    protected:
        using OGenericUnoController::connect;
 
        void        disconnect();
 
        // late construction
        virtual bool        Construct(vcl::Window* pParent) override;
        virtual void        describeSupportedFeatures() override;
 
    protected:
        // XEventListener
        virtual void SAL_CALL disposing(const css::lang::EventObject& Source) override;
 
        // OComponentHelper
        virtual void SAL_CALL disposing() override;
    };
 
}   // namespace dbaui
 
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */