/************************************************************** * * 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 * * Unless required by applicable law or agreed to in writing, * software distributed under the License is distributed on an * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY * KIND, either express or implied. See the License for the * specific language governing permissions and limitations * under the License. * *************************************************************/ #ifndef __FRAMEWORK_JOBS_HELPONSTARTUP_HXX_ #define __FRAMEWORK_JOBS_HELPONSTARTUP_HXX_ //_______________________________________________ // my own includes #include #include #include #include //_______________________________________________ // other includes #include //_______________________________________________ // uno includes #include #include #include #include #include //_______________________________________________ // namespace namespace framework{ //_______________________________________________ // declarations //_______________________________________________ /** @short implements a job component, which handle the special feature to show a suitable help page for every (visible!) loaded document. @author as96863 */ class HelpOnStartup : private ThreadHelpBase ,public ::cppu::WeakImplHelper3< ::com::sun::star::lang::XServiceInfo,::com::sun::star::lang::XEventListener,::com::sun::star::task::XJob > { //------------------------------------------- // member private: //....................................... /** @short reference to an uno service manager. */ css::uno::Reference< css::lang::XMultiServiceFactory > m_xSMGR; //....................................... /** @short such module manager is used to classify new opened documents. */ css::uno::Reference< css::frame::XModuleManager > m_xModuleManager; //....................................... /** @short is needed to locate a might open help frame. */ css::uno::Reference< css::frame::XFrame > m_xDesktop; //....................................... /** @short provides read access to the underlying configuration. */ css::uno::Reference< css::container::XNameAccess > m_xConfig; //....................................... /** @short knows the current locale of this office session, which is needed to build complete help URLs. */ ::rtl::OUString m_sLocale; //....................................... /** @short knows the current operating system of this office session, which is needed to build complete help URLs. */ ::rtl::OUString m_sSystem; //------------------------------------------- // native interface public: //--------------------------------------- /** @short create new instance of this class. @param xSMGR reference to the uno service manager, which created this instance. Can be used later to create own needed uno resources on demand. */ HelpOnStartup(const css::uno::Reference< css::lang::XMultiServiceFactory >& xSMGR); //--------------------------------------- /** @short does nothing real ... @descr But it should exists as virtual function, so this class cant make trouble related to inline/symbols etcpp.! */ virtual ~HelpOnStartup(); //------------------------------------------- // uno interface public: //--------------------------------------- // css.lang.XServiceInfo DECLARE_XSERVICEINFO // css.task.XJob virtual css::uno::Any SAL_CALL execute(const css::uno::Sequence< css::beans::NamedValue >& lArguments) throw(css::lang::IllegalArgumentException, css::uno::Exception , css::uno::RuntimeException ); // css.lang.XEventListener virtual void SAL_CALL disposing(const css::lang::EventObject& aEvent) throw(css::uno::RuntimeException); //------------------------------------------- // helper private: //--------------------------------------- /** @short analyze the given job arguments, try to locate a model reference and try to classify this model. @descr As a result of this operation a module identifier will be returned. It can be used against the module configuration then to retrieve further informations. @param lArguments the list of job arguments which is given on our interface method execute(). @return [string] a module identifier ... or an empty value if no model could be located ... or if it could not be classified successfully. */ ::rtl::OUString its_getModuleIdFromEnv(const css::uno::Sequence< css::beans::NamedValue >& lArguments); //--------------------------------------- /** @short tries to locate the open help module and return the url of the currently shown help content. @descr It returns an empty string, if the help isnt still open at calling time. @return The URL of the current shown help content; or an empty value if the help isnt still open. */ ::rtl::OUString its_getCurrentHelpURL(); //--------------------------------------- /** @short checks if the given help url match to a default help url of any office module. @param sHelpURL the help url for checking. @return [bool] sal_True if the given URL is any default one ... sal_False otherwise. */ ::sal_Bool its_isHelpUrlADefaultOne(const ::rtl::OUString& sHelpURL); //--------------------------------------- /** @short checks, if the help module should be shown automaticly for the currently opened office module. @descr This value is readed from the module configuration. In case the help should be shown, this method returns a help URL, which can be used to show the right help content. @param sModule identifies the used office module. @return [string] A valid help URL in case the help content should be shown; an empty value if such automatism was disabled for the specified office module. */ ::rtl::OUString its_checkIfHelpEnabledAndGetURL(const ::rtl::OUString& sModule); //--------------------------------------- /** @short create a help URL for the given parameters. @param sBaseURL must be the base URL for a requested help content e.g. "vnd.sun.star.help://swriter/" or "vnd.sun.star.help://swriter/67351" @param sLocale the current office locale e.g. "en-US" @param sSystem the current operating system e.g. "WIN" @return The URL which was generated. e.g. e.g. "vnd.sun.star.help://swriter/?Language=en-US&System=WIN" or "vnd.sun.star.help://swriter/67351?Language=en-US&System=WIN" */ static ::rtl::OUString ist_createHelpURL(const ::rtl::OUString& sBaseURL, const ::rtl::OUString& sLocale , const ::rtl::OUString& sSystem ); }; } // namespace framework #endif // __FRAMEWORK_JOBS_HELPONSTARTUP_HXX_