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
|
/*************************************************************************
*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* Copyright 2000, 2010 Oracle and/or its affiliates.
*
* OpenOffice.org - a multi-platform office productivity suite
*
* This file is part of OpenOffice.org.
*
* OpenOffice.org is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License version 3
* only, as published by the Free Software Foundation.
*
* OpenOffice.org 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 version 3 for more details
* (a copy is included in the LICENSE file that accompanied this code).
*
* You should have received a copy of the GNU Lesser General Public License
* version 3 along with OpenOffice.org. If not, see
* <http://www.openoffice.org/license.html>
* for a copy of the LGPLv3 License.
*
************************************************************************/
#ifndef BASICMANAGERREPOSITORY_HXX
#define BASICMANAGERREPOSITORY_HXX
/** === begin UNO includes === **/
#include <com/sun/star/frame/XModel.hpp>
#include <com/sun/star/embed/XStorage.hpp>
/** === end UNO includes === **/
class BasicManager;
//........................................................................
namespace basic
{
//........................................................................
//====================================================================
//= BasicManagerRepository
//====================================================================
/** specifies a callback for instances which are interested in BasicManagers
created by the BasicManagerRepository.
*/
class SAL_NO_VTABLE BasicManagerCreationListener
{
public:
/** is called when a BasicManager has been created
@param _rxForDocument
denotes the document for which the BasicManager has been created. If this is <NULL/>,
then the BasicManager is the application-wide BasicManager.
@param _pBasicManager
denotes the BasicManager which has been created. The listener might for instance
decide to add global variables to it, or otherwise initialize it.
*/
virtual void onBasicManagerCreated(
const ::com::sun::star::uno::Reference< ::com::sun::star::frame::XModel >& _rxForDocument,
BasicManager& _rBasicManager
) = 0;
};
//====================================================================
//= BasicManagerRepository
//====================================================================
class BasicManagerRepository
{
public:
/** returns the BasicManager belonging to the given document
If the BasicManager does not yet exist, it is created. In this case, if the application's
BasicManager does not yet exist, it is also created. This is necessary since
the application's BasicManager acts as parent for all document's BasicManagers.
If you're interested in this case - the implicit creation of the application's BasicManager -,
then you need to register as BasicManagerCreationListener.
@param _rxDocumentModel
denotes the document model whose BasicManager is to be retrieved. Must not be <NULL/>.
The document should support the XDocumentInfoSupplier interface, for retrieving
its title, which is needed in some error conditions.
Also it <em>must</em> support the XStorageBasedDocument interface, since we
must be able to retrieve the document's storage. If this interface is <em>not</em>
supported, creating a new BasicManager will certainly fail.
@return
the BasicManager for this model.
@attention
The returned BasicManager instances is owned by the repository. In particular,
you are not allowed to delete it. Instead, the given model is observed: As soon
as it's closed, the associated BasicManager is deleted.
*/
static BasicManager* getDocumentBasicManager(
const ::com::sun::star::uno::Reference< ::com::sun::star::frame::XModel >& _rxDocumentModel
);
/** returns the application-wide BasicManager
@param _bCreate
determines whether the BasicManager should be created (<TRUE/>) if it
does not yet exist.
@attention
If the BasicManager is newly created, then it is still owned by the repository.
In particular, you are not allowed to delete it. Instead, call resetApplicationBasicManager
to release the BasicManager.
*/
static BasicManager* getApplicationBasicManager( bool _bCreate );
/** resets the application-wide BasicManager to <NULL/>
*/
static void resetApplicationBasicManager();
/** registers a BasicManagerCreationListener instance which is notified whenever
the repository creates a BasicManager instance.
Note that this listener is <em>not</em> called when somebody else
creates BasicManager instances.
If the same listener is registered multiple times, it is also notified
multiple times, and needs to be revoked once for each registration.
*/
static void registerCreationListener(
BasicManagerCreationListener& _rListener
);
/** reveokes a BasicManagerCreationListener instance which has previously
been registered to be notified about created BasicManager instances.
*/
static void revokeCreationListener(
BasicManagerCreationListener& _rListener
);
};
//........................................................................
} // namespace basic
//........................................................................
#endif // BASICMANAGERREPOSITORY_HXX
|
