1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
|
/* -*- 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 .
*/
#ifndef INCLUDED_FRAMEWORK_INC_JOBS_HELPONSTARTUP_HXX
#define INCLUDED_FRAMEWORK_INC_JOBS_HELPONSTARTUP_HXX
#include <sal/config.h>
#include <string_view>
#include <cppuhelper/implbase.hxx>
#include <com/sun/star/task/XJob.hpp>
#include <com/sun/star/lang/XEventListener.hpp>
#include <com/sun/star/container/XNameAccess.hpp>
#include <com/sun/star/frame/XDesktop2.hpp>
#include <com/sun/star/frame/XModuleManager2.hpp>
#include <com/sun/star/lang/XServiceInfo.hpp>
#include <com/sun/star/uno/XComponentContext.hpp>
namespace framework{
/** @short implements a job component, which handle the special
feature to show a suitable help page for every (visible!)
loaded document.
*/
class HelpOnStartup final : public ::cppu::WeakImplHelper< css::lang::XServiceInfo,css::lang::XEventListener,css::task::XJob >
{
// member
private:
osl::Mutex m_mutex;
/** @short reference to a uno service manager. */
css::uno::Reference< css::uno::XComponentContext > m_xContext;
/** @short such module manager is used to classify new opened documents. */
css::uno::Reference< css::frame::XModuleManager2 > m_xModuleManager;
/** @short is needed to locate a might open help frame. */
css::uno::Reference< css::frame::XDesktop2 > 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.
*/
OUString m_sLocale;
/** @short knows the current operating system of this office session,
which is needed to build complete help URLs.
*/
OUString m_sSystem;
// native interface
public:
/** @short create new instance of this class.
@param xContext
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::uno::XComponentContext >& xContext);
/** @short does nothing real ...
@descr But it should exists as virtual function,
so this class can't make trouble
related to inline/symbols etcpp.!
*/
virtual ~HelpOnStartup() override;
// uno interface
public:
/* interface XServiceInfo */
virtual OUString SAL_CALL getImplementationName() override;
virtual sal_Bool SAL_CALL supportsService( const OUString& sServiceName ) override;
virtual css::uno::Sequence< OUString > SAL_CALL getSupportedServiceNames() override;
// css.task.XJob
virtual css::uno::Any SAL_CALL execute(const css::uno::Sequence< css::beans::NamedValue >& lArguments) override;
// css.lang.XEventListener
virtual void SAL_CALL disposing(const css::lang::EventObject& aEvent) override;
// 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 information.
@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.
*/
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 isn't still
open at calling time.
@return The URL of the current shown help content;
or an empty value if the help isn't still open.
*/
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.
*/
bool its_isHelpUrlADefaultOne(std::u16string_view sHelpURL);
/** @short checks, if the help module should be shown automatically for the
currently opened office module.
@descr This value is read 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.
*/
OUString its_checkIfHelpEnabledAndGetURL(const 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 OUString ist_createHelpURL(std::u16string_view sBaseURL,
std::u16string_view sLocale ,
std::u16string_view sSystem );
};
} // namespace framework
#endif // INCLUDED_FRAMEWORK_INC_JOBS_HELPONSTARTUP_HXX
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
|