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
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
|
/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*************************************************************************
*
* 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 _XMLOFF_FORMLAYEREXPORT_HXX_
#define _XMLOFF_FORMLAYEREXPORT_HXX_
#include "sal/config.h"
#include "xmloff/dllapi.h"
#include <com/sun/star/drawing/XDrawPage.hpp>
#include <com/sun/star/container/XIndexAccess.hpp>
#include <com/sun/star/beans/XPropertySet.hpp>
#include <com/sun/star/frame/XModel.hpp>
#include <rtl/ref.hxx>
#include <salhelper/simplereferenceobject.hxx>
#include <xmloff/xmlexppr.hxx>
namespace com { namespace sun { namespace star { namespace awt {
class XControlModel;
} } } }
class SvXMLExport;
//.........................................................................
namespace xmloff
{
//.........................................................................
class OFormLayerXMLExport_Impl;
class OFormsRootExport;
//=====================================================================
//= OFormLayerXMLExport
//=====================================================================
/** provides functionallity for exporting a complete form layer.
*/
class XMLOFF_DLLPUBLIC OFormLayerXMLExport
:public ::salhelper::SimpleReferenceObject
{
protected:
/// our export context
SvXMLExport& m_rContext;
// impl class
OFormLayerXMLExport_Impl* m_pImpl;
protected:
~OFormLayerXMLExport();
public:
OFormLayerXMLExport(SvXMLExport& _rContext);
/** initial the object
<p>To be called if you want to reuse the same object for exportin different documents.</p>
<p>You don't need to call this if you just constructed the object, in this case it is already
initialized..</p>
*/
void initialize();
/** initializes some internal structures for fast access to the given page
<p>This method has to be called before you use getControlId for controls on the given page.
This way a performance optimization can be done for faster access to the control ids</p>
@return
<TRUE/> if the page has been examined before. If <FALSE/> is returned, this is a serious error.
@see getControlId
@see examineForms
*/
sal_Bool seekPage(
const ::com::sun::star::uno::Reference< ::com::sun::star::drawing::XDrawPage >& _rxDrawPage);
/** get the id for the given control
<p>The page the control belongs to must have been examined and sought to.</p>
@param _rxControl
the control which's id should be retrieved. Must not be <NULL/>.
@see examineForms
@see seekPage
*/
::rtl::OUString getControlId(
const ::com::sun::star::uno::Reference< ::com::sun::star::beans::XPropertySet >& _rxControl);
/** retrieves the style name for the control's number style.
<p>For performance reasons, this method is allowed to be called for any controls, even those which
do not have a number style. In this case, an empty string is returned.</p>
@param _rxControl
the control which's id should be retrieved. Must not be <NULL/>.
@see examineForms
@see seekPage
*/
::rtl::OUString getControlNumberStyle(
const ::com::sun::star::uno::Reference< ::com::sun::star::beans::XPropertySet >& _rxControl );
/** examines the forms collection given.
<p>This method will collect all form layer related data of the given draw page</p>
@param _rxDrawPage
the draw page to examine. The object will be queried for a <type scope="com.sun.star.form">XFormsSupplier</type>
interface to obtain the forms container.
*/
void examineForms(const ::com::sun::star::uno::Reference< ::com::sun::star::drawing::XDrawPage >& _rxDrawPage);
/** exports the structure of a form layer
<p>This method does not export styles (e.g. font properties of the controls), or any references
external instances may have to the control models contained in the form layer (e.g. uno control
shapes in the drawing layer may have such references)</p>
<p>No top level element describing the whole collection is inserted. I.e. if within your document, you
expect the the forms collection to be stored like
<listing>
<Forms>
.... // all the forms stuff here
</Forms>
</listing>
you have to start the Forms element yourself.</p>
@param _rxDrawPage
the draw page to examine. The object will be queried for a <type scope="com.sun.star.form">XFormsSupplier</type>
interface to obtain the forms container.
*/
void exportForms(const ::com::sun::star::uno::Reference< ::com::sun::star::drawing::XDrawPage >& _rxDrawPage);
/** exports the XForms model data
*/
void exportXForms() const;
/** determines whether the given page contains logical forms
*/
bool pageContainsForms( const ::com::sun::star::uno::Reference< ::com::sun::star::drawing::XDrawPage >& _rxDrawPage ) const;
/** determines whether the given page contains XForm instances
*/
bool documentContainsXForms() const;
/// retrieves the property mapper for control styles
::rtl::Reference< SvXMLExportPropertyMapper > getStylePropertyMapper();
/** exports the controls number styles
*/
void exportControlNumberStyles();
/** exports the automatic controls number styles
*/
void exportAutoControlNumberStyles();
/** exports the auto-styles collected during the examineForms calls
*/
void exportAutoStyles();
/** exclude the given control (model) from export.
<p>If your document contains form controls which are not to be exported for whatever reason,
you need to announce the models of these controls (can be retrieved from XControlShape::getControl)
to the form layer exporter.<br/>
Of course you have to do this before calling <member>exportForms</member></p>
*/
void excludeFromExport( const ::com::sun::star::uno::Reference< ::com::sun::star::awt::XControlModel > _rxControl );
};
//=========================================================================
//= OOfficeFormsExport
//=========================================================================
/// export helper for the office::forms element
class XMLOFF_DLLPUBLIC OOfficeFormsExport
{
private:
OFormsRootExport* m_pImpl;
public:
OOfficeFormsExport( SvXMLExport& _rExp );
~OOfficeFormsExport();
};
//.........................................................................
} // namespace xmloff
//.........................................................................
#endif // _XMLOFF_FORMLAYEREXPORT_HXX_
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
|
