acceleratorconfiguration.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 <sal/config.h>
 
#include <string_view>
 
#include <accelerators/presethandler.hxx>
#include <accelerators/acceleratorcache.hxx>
 
#include <com/sun/star/container/XNameAccess.hpp>
#include <com/sun/star/ui/XAcceleratorConfiguration.hpp>
 
#include <com/sun/star/io/XInputStream.hpp>
#include <com/sun/star/io/XOutputStream.hpp>
#include <com/sun/star/util/XChangesListener.hpp>
 
// TODO use XPresetHandler interface instead if available
#include <com/sun/star/form/XReset.hpp>
 
#include <cppuhelper/implbase.hxx>
 
// definition
 
namespace framework
{
 
inline constexpr OUStringLiteral CFG_ENTRY_PRIMARY = u"PrimaryKeys";
inline constexpr OUStringLiteral CFG_ENTRY_GLOBAL = u"Global";
inline constexpr OUStringLiteral CFG_ENTRY_MODULES = u"Modules";
 
class XMLBasedAcceleratorConfiguration : public    ::cppu::WeakImplHelper<
                                                       css::form::XReset,                    // TODO use XPresetHandler instead if available
                                                       css::ui::XAcceleratorConfiguration >  // => css::ui::XUIConfigurationPersistence
                                                                                             //    css::ui::XUIConfigurationStorage
                                                                                             //    css::ui::XUIConfiguration
{
 
    // member
 
    protected:
 
        css::uno::Reference< css::uno::XComponentContext > m_xContext;
 
        PresetHandler m_aPresetHandler;
 
        AcceleratorCache m_aReadCache;
 
        std::unique_ptr<AcceleratorCache> m_pWriteCache;
 
        // native interface!
 
    public:
 
        XMLBasedAcceleratorConfiguration( const css::uno::Reference< css::uno::XComponentContext >& xContext);
        virtual ~XMLBasedAcceleratorConfiguration(                                                                    ) override;
 
        // uno interface!
 
    public:
 
        // XAcceleratorConfiguration
        virtual css::uno::Sequence< css::awt::KeyEvent > SAL_CALL getAllKeyEvents() override;
 
        virtual OUString SAL_CALL getCommandByKeyEvent(const css::awt::KeyEvent& aKeyEvent) override;
 
        virtual void SAL_CALL setKeyEvent(const css::awt::KeyEvent& aKeyEvent,
            const OUString&    sCommand ) override;
 
        virtual void SAL_CALL removeKeyEvent(const css::awt::KeyEvent& aKeyEvent) override;
 
        virtual css::uno::Sequence< css::awt::KeyEvent > SAL_CALL getKeyEventsByCommand(const OUString& sCommand) override;
 
        virtual css::uno::Sequence< css::uno::Any > SAL_CALL getPreferredKeyEventsForCommandList(const css::uno::Sequence< OUString >& lCommandList) override;
 
        virtual void SAL_CALL removeCommandFromAllKeyEvents(const OUString& sCommand) override;
 
        // XUIConfigurationPersistence
        virtual void SAL_CALL reload() override;
 
        virtual void SAL_CALL store() override;
 
        virtual void SAL_CALL storeToStorage(const css::uno::Reference< css::embed::XStorage >& xStorage) override;
 
        virtual sal_Bool SAL_CALL isModified() override;
 
        virtual sal_Bool SAL_CALL isReadOnly() override;
 
        // XUIConfigurationStorage
        virtual void SAL_CALL setStorage(const css::uno::Reference< css::embed::XStorage >& xStorage) override;
 
        virtual sal_Bool SAL_CALL hasStorage() override;
 
        // XUIConfiguration
        virtual void SAL_CALL addConfigurationListener(const css::uno::Reference< css::ui::XUIConfigurationListener >& xListener) override;
 
        virtual void SAL_CALL removeConfigurationListener(const css::uno::Reference< css::ui::XUIConfigurationListener >& xListener) override;
 
        // XReset
        // TODO use XPresetHandler instead if available
        virtual void SAL_CALL reset() override;
 
        virtual void SAL_CALL addResetListener(const css::uno::Reference< css::form::XResetListener >& xListener) override;
 
        virtual void SAL_CALL removeResetListener(const css::uno::Reference< css::form::XResetListener >& xListener) override;
 
        // called when changes occurred in the storage
        void changesOccurred();
 
        // helper for derived classes
 
    protected:
 
        OUString impl_ts_getLocale() const;
 
        // helper
 
    private:
 
        void impl_ts_load(const css::uno::Reference< css::io::XInputStream >& xStream);
 
        void impl_ts_save(const css::uno::Reference< css::io::XOutputStream >& xStream);
 
        AcceleratorCache& impl_getCFG(bool bWriteAccessRequested = false);
 
};
 
class XCUBasedAcceleratorConfiguration : public  ::cppu::WeakImplHelper<
                                                     css::util::XChangesListener,
                                                     css::form::XReset,                    // TODO use XPresetHandler instead if available
                                                     css::ui::XAcceleratorConfiguration >  // => css::ui::XUIConfigurationPersistence
                                                                                           //    css::ui::XUIConfigurationStorage
                                                                                           //    css::ui::XUIConfiguration
{
 
    // member
 
    protected:
 
        css::uno::Reference< css::uno::XComponentContext > m_xContext;
 
        css::uno::Reference< css::container::XNameAccess > m_xCfg;
        AcceleratorCache m_aPrimaryReadCache;
        AcceleratorCache m_aSecondaryReadCache;
        std::unique_ptr<AcceleratorCache> m_pPrimaryWriteCache;
        std::unique_ptr<AcceleratorCache> m_pSecondaryWriteCache;
 
        OUString m_sGlobalOrModules;
        OUString m_sModuleCFG;
 
        // native interface!
 
    public:
 
        XCUBasedAcceleratorConfiguration( css::uno::Reference< css::uno::XComponentContext >  xContext );
        virtual ~XCUBasedAcceleratorConfiguration(                                                           ) override;
 
        // uno interface!
 
    public:
 
        // XAcceleratorConfiguration
        virtual css::uno::Sequence< css::awt::KeyEvent > SAL_CALL getAllKeyEvents() override;
 
        virtual OUString SAL_CALL getCommandByKeyEvent(const css::awt::KeyEvent& aKeyEvent) override;
 
        virtual void SAL_CALL setKeyEvent(const css::awt::KeyEvent& aKeyEvent,
            const OUString&    sCommand ) override;
 
        virtual void SAL_CALL removeKeyEvent(const css::awt::KeyEvent& aKeyEvent) override;
 
        virtual css::uno::Sequence< css::awt::KeyEvent > SAL_CALL getKeyEventsByCommand(const OUString& sCommand) override;
 
        virtual css::uno::Sequence< css::uno::Any > SAL_CALL getPreferredKeyEventsForCommandList(const css::uno::Sequence< OUString >& lCommandList) override;
 
        virtual void SAL_CALL removeCommandFromAllKeyEvents(const OUString& sCommand) override;
 
        // XUIConfigurationPersistence
        virtual void SAL_CALL reload() override;
 
        virtual void SAL_CALL store() override;
 
        virtual void SAL_CALL storeToStorage(const css::uno::Reference< css::embed::XStorage >& xStorage) override;
 
        virtual sal_Bool SAL_CALL isModified() override;
 
        virtual sal_Bool SAL_CALL isReadOnly() override;
 
        // XUIConfigurationStorage
        virtual void SAL_CALL setStorage(const css::uno::Reference< css::embed::XStorage >& xStorage) override;
 
        virtual sal_Bool SAL_CALL hasStorage() override;
 
        // XUIConfiguration
        virtual void SAL_CALL addConfigurationListener(const css::uno::Reference< css::ui::XUIConfigurationListener >& xListener) override;
 
        virtual void SAL_CALL removeConfigurationListener(const css::uno::Reference< css::ui::XUIConfigurationListener >& xListener) override;
 
        // XReset
        // TODO use XPresetHandler instead if available
        virtual void SAL_CALL reset() override;
 
        virtual void SAL_CALL addResetListener(const css::uno::Reference< css::form::XResetListener >& xListener) override;
 
        virtual void SAL_CALL removeResetListener(const css::uno::Reference< css::form::XResetListener >& xListener) override;
 
        // css.util.XChangesListener
        virtual void SAL_CALL changesOccurred(const css::util::ChangesEvent& aEvent) override;
 
        // css.lang.XEventListener
        virtual void SAL_CALL disposing(const css::lang::EventObject& aEvent) override;
 
        // helper for derived classes
 
    protected:
 
        OUString impl_ts_getLocale() const;
 
        // helper
 
    private:
 
        void impl_ts_load(bool bPreferred, const css::uno::Reference< css::container::XNameAccess >& xCfg);
        void impl_ts_save(bool bPreferred);
 
        void insertKeyToConfiguration(const css::awt::KeyEvent& aKeyEvent, const OUString& sCommand, const bool bPreferred);
        void removeKeyFromConfiguration(const css::awt::KeyEvent& aKeyEvent, const bool bPreferred);
 
        void reloadChanged(const OUString& sPrimarySecondary, std::u16string_view sGlobalModules, const OUString& sModule, const OUString& sKey);
        AcceleratorCache& impl_getCFG(bool bPreferred, bool bWriteAccessRequested = false);
 
};
 
} // namespace framework
 
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */