6707e3b919
2006/11/02 18:38:46 hr 1.3.138.2: RESYNC: (1.3-1.4); FILE MERGED 2006/05/03 15:52:25 hr 1.3.138.1: #i55967#: remove not needed STL includes
276 lines
9.8 KiB
C++
276 lines
9.8 KiB
C++
/*************************************************************************
|
|
*
|
|
* OpenOffice.org - a multi-platform office productivity suite
|
|
*
|
|
* $RCSfile: helponstartup.hxx,v $
|
|
*
|
|
* $Revision: 1.5 $
|
|
*
|
|
* last change: $Author: vg $ $Date: 2006-11-22 10:40:40 $
|
|
*
|
|
* The Contents of this file are made available subject to
|
|
* the terms of GNU Lesser General Public License Version 2.1.
|
|
*
|
|
*
|
|
* GNU Lesser General Public License Version 2.1
|
|
* =============================================
|
|
* Copyright 2005 by Sun Microsystems, Inc.
|
|
* 901 San Antonio Road, Palo Alto, CA 94303, USA
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License version 2.1, as published by the Free Software Foundation.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library; if not, write to the Free Software
|
|
* Foundation, Inc., 59 Temple Place, Suite 330, Boston,
|
|
* MA 02111-1307 USA
|
|
*
|
|
************************************************************************/
|
|
|
|
#ifndef __FRAMEWORK_JOBS_HELPONSTARTUP_HXX_
|
|
#define __FRAMEWORK_JOBS_HELPONSTARTUP_HXX_
|
|
|
|
//_______________________________________________
|
|
// my own includes
|
|
|
|
#ifndef __FRAMEWORK_THREADHELP_THREADHELPBASE_HXX_
|
|
#include <threadhelp/threadhelpbase.hxx>
|
|
#endif
|
|
|
|
#ifndef __FRAMEWORK_MACROS_XINTERFACE_HXX_
|
|
#include <macros/xinterface.hxx>
|
|
#endif
|
|
|
|
#ifndef __FRAMEWORK_MACROS_XTYPEPROVIDER_HXX_
|
|
#include <macros/xtypeprovider.hxx>
|
|
#endif
|
|
|
|
#ifndef __FRAMEWORK_MACROS_XSERVICEINFO_HXX_
|
|
#include <macros/xserviceinfo.hxx>
|
|
#endif
|
|
|
|
//_______________________________________________
|
|
// other includes
|
|
|
|
#ifndef _CPPUHELPER_WEAK_HXX_
|
|
#include <cppuhelper/weak.hxx>
|
|
#endif
|
|
|
|
//_______________________________________________
|
|
// uno includes
|
|
|
|
#ifndef _COM_SUN_STAR_FRAME_XFRAME_HPP_
|
|
#include <com/sun/star/frame/XFrame.hpp>
|
|
#endif
|
|
|
|
#ifndef _COM_SUN_STAR_TASK_XJOB_HPP_
|
|
#include <com/sun/star/task/XJob.hpp>
|
|
#endif
|
|
|
|
#ifndef _COM_SUN_STAR_LANG_XEVENTLISTENER_HPP_
|
|
#include <com/sun/star/lang/XEventListener.hpp>
|
|
#endif
|
|
|
|
#ifndef _COM_SUN_STAR_CONTAINER_XNAMEACCESS_HPP_
|
|
#include <com/sun/star/container/XNameAccess.hpp>
|
|
#endif
|
|
|
|
#ifndef _COM_SUN_STAR_FRAME_XMODULEMANAGER_HPP_
|
|
#include <com/sun/star/frame/XModuleManager.hpp>
|
|
#endif
|
|
|
|
//_______________________________________________
|
|
// 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 : public css::lang::XTypeProvider
|
|
, public css::lang::XServiceInfo
|
|
, public css::task::XJob
|
|
, public css::lang::XEventListener
|
|
, private ThreadHelpBase
|
|
, public ::cppu::OWeakObject
|
|
{
|
|
//-------------------------------------------
|
|
// 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.uno.XInterface
|
|
// css.lang.XTypeProvider
|
|
// css.lang.XServiceInfo
|
|
FWK_DECLARE_XINTERFACE
|
|
FWK_DECLARE_XTYPEPROVIDER
|
|
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]
|
|
TRUE if the given URL is any default one ...
|
|
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_
|