summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorOliver Bolte <obo@openoffice.org>2008-10-16 06:57:26 +0000
committerOliver Bolte <obo@openoffice.org>2008-10-16 06:57:26 +0000
commit478407d418b4a59bb01a9783b2cd24694e53766f (patch)
treeed47e28a74dee516b27c42c25d8a039429989c00
parent1a784f6768595b62ce05076f22a2c93b90e24cc3 (diff)
CWS-TOOLING: integrate CWS odbmacros3
-rw-r--r--idlc/inc/idlc/errorhandler.hxx2
-rw-r--r--idlc/source/errorhandler.cxx2
-rw-r--r--idlc/source/parser.y2
-rw-r--r--offapi/com/sun/star/document/DocumentEvent.idl87
-rw-r--r--offapi/com/sun/star/document/EventObject.idl5
-rw-r--r--offapi/com/sun/star/document/OfficeDocument.idl20
-rw-r--r--offapi/com/sun/star/document/XDocumentEventBroadcaster.idl127
-rw-r--r--offapi/com/sun/star/document/XDocumentEventListener.idl67
-rw-r--r--offapi/com/sun/star/document/XEventBroadcaster.idl5
-rw-r--r--offapi/com/sun/star/document/XEventListener.idl9
-rw-r--r--offapi/com/sun/star/document/makefile.mk11
-rw-r--r--offapi/com/sun/star/script/provider/ScriptFrameworkErrorType.idl11
-rw-r--r--offapi/com/sun/star/sdb/OfficeDatabaseDocument.idl157
-rw-r--r--offapi/com/sun/star/sdb/XOfficeDatabaseDocument.idl6
14 files changed, 480 insertions, 31 deletions
diff --git a/idlc/inc/idlc/errorhandler.hxx b/idlc/inc/idlc/errorhandler.hxx
index 05993edbadd2..27e429082a85 100644
--- a/idlc/inc/idlc/errorhandler.hxx
+++ b/idlc/inc/idlc/errorhandler.hxx
@@ -7,7 +7,7 @@
* OpenOffice.org - a multi-platform office productivity suite
*
* $RCSfile: errorhandler.hxx,v $
- * $Revision: 1.11 $
+ * $Revision: 1.10.10.2 $
*
* This file is part of OpenOffice.org.
*
diff --git a/idlc/source/errorhandler.cxx b/idlc/source/errorhandler.cxx
index 71f681e31387..b85bc991911a 100644
--- a/idlc/source/errorhandler.cxx
+++ b/idlc/source/errorhandler.cxx
@@ -7,7 +7,7 @@
* OpenOffice.org - a multi-platform office productivity suite
*
* $RCSfile: errorhandler.cxx,v $
- * $Revision: 1.17 $
+ * $Revision: 1.16.10.2 $
*
* This file is part of OpenOffice.org.
*
diff --git a/idlc/source/parser.y b/idlc/source/parser.y
index 09754522fcde..51df5943ea72 100644
--- a/idlc/source/parser.y
+++ b/idlc/source/parser.y
@@ -7,7 +7,7 @@
* OpenOffice.org - a multi-platform office productivity suite
*
* $RCSfile: parser.y,v $
- * $Revision: 1.19 $
+ * $Revision: 1.18.10.1 $
*
* This file is part of OpenOffice.org.
*
diff --git a/offapi/com/sun/star/document/DocumentEvent.idl b/offapi/com/sun/star/document/DocumentEvent.idl
new file mode 100644
index 000000000000..1391f9becaf5
--- /dev/null
+++ b/offapi/com/sun/star/document/DocumentEvent.idl
@@ -0,0 +1,87 @@
+/*************************************************************************
+* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+*
+* Copyright 2008 by Sun Microsystems, Inc.
+*
+* OpenOffice.org - a multi-platform office productivity suite
+*
+* $RCSfile: DocumentEvent.idl,v $
+*
+* $Revision: 1.4.2.2 $
+*
+* 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 __com_sun_star_document_DocumentEvent_idl__
+#define __com_sun_star_document_DocumentEvent_idl__
+
+#ifndef __com_sun_star_lang_EventObject_idl__
+#include <com/sun/star/lang/EventObject.idl>
+#endif
+#ifndef __com_sun_star_frame_XController2_idl__
+#include <com/sun/star/frame/XController2.idl>
+#endif
+
+//=============================================================================
+
+module com { module sun { module star { module document {
+
+//=============================================================================
+
+/** describes an event happening in an <type>OfficeDocument</type>
+
+ <p>The <member scope="com::sun::star::lang">EventObject::Source</member> member
+ of the base type refers to the document which broadcasts the event.</p>
+
+ <p>This type is the successor of the EventObject type, which should not be used
+ anymore.</p>
+
+ @see XDocumentEventBroadcaster
+ */
+struct DocumentEvent : ::com::sun::star::lang::EventObject
+{
+ /** specifies the name of the event.
+
+ <p>It's the responsibility of the component supporting the <type>XDocumentEventBroadcaster</type>
+ interface to specify which events it supports.</p>
+ */
+ string EventName;
+
+ /** denotes the view respectively controller which the event applies to.
+
+ <p>Might be <NULL/> if the event is not related to a concrete view of
+ the document.</p>
+ */
+ ::com::sun::star::frame::XController2
+ ViewController;
+
+ /** contains supplemental information about the even which is being notified
+
+ <p>The semantics of this additional information needs to be specified by the broadcaster
+ of the event.</p>
+ */
+ any Supplement;
+};
+
+//=============================================================================
+
+}; }; }; };
+
+//=============================================================================
+
+#endif
diff --git a/offapi/com/sun/star/document/EventObject.idl b/offapi/com/sun/star/document/EventObject.idl
index aae494fb2c12..39aeac0e42e6 100644
--- a/offapi/com/sun/star/document/EventObject.idl
+++ b/offapi/com/sun/star/document/EventObject.idl
@@ -7,7 +7,7 @@
* OpenOffice.org - a multi-platform office productivity suite
*
* $RCSfile: EventObject.idl,v $
- * $Revision: 1.7 $
+ * $Revision: 1.7.12.1 $
*
* This file is part of OpenOffice.org.
*
@@ -43,6 +43,9 @@ module com { module sun { module star { module document {
@see XEventListener
@see XEventBroadcaster
+
+ @deprecated
+ @see DocumentEvent
*/
published struct EventObject: com::sun::star::lang::EventObject
{
diff --git a/offapi/com/sun/star/document/OfficeDocument.idl b/offapi/com/sun/star/document/OfficeDocument.idl
index c0c2f32d1760..b4a7d10ea7e5 100644
--- a/offapi/com/sun/star/document/OfficeDocument.idl
+++ b/offapi/com/sun/star/document/OfficeDocument.idl
@@ -7,7 +7,7 @@
* OpenOffice.org - a multi-platform office productivity suite
*
* $RCSfile: OfficeDocument.idl,v $
- * $Revision: 1.17 $
+ * $Revision: 1.17.12.2 $
*
* This file is part of OpenOffice.org.
*
@@ -66,12 +66,18 @@
#include <com/sun/star/document/XViewDataSupplier.idl>
#endif
+#ifndef __com_sun_star_document_XDocumentEventBroadcaster_idl__
+#include <com/sun/star/document/XDocumentEventBroadcaster.idl>
+#endif
+
+#ifndef __com_sun_star_document_XEmbeddedScripts_idl__
+#include <com/sun/star/document/XEmbeddedScripts.idl>
+#endif
+
//=============================================================================
module com { module sun { module star { module document {
-published interface XEmbeddedScripts;
-
//=============================================================================
/** abstract service which specifies a storable and printable document
@@ -132,10 +138,16 @@ published service OfficeDocument
interface com::sun::star::view::XPrintable;
//-------------------------------------------------------------------------
+ /** is an old and deprecated version of the <type>XDocumentEventBroadcaster</type> interface
+ @deprecated
+ */
+ [optional] interface XEventBroadcaster;
+
+ //-------------------------------------------------------------------------
/** makes it possible to register listeners which are called whenever
a document event occurs
*/
- [optional] interface XEventBroadcaster;
+ [optional] interface XDocumentEventBroadcaster;
//-------------------------------------------------------------------------
/** access to bound event handlers
diff --git a/offapi/com/sun/star/document/XDocumentEventBroadcaster.idl b/offapi/com/sun/star/document/XDocumentEventBroadcaster.idl
new file mode 100644
index 000000000000..596adf722ea8
--- /dev/null
+++ b/offapi/com/sun/star/document/XDocumentEventBroadcaster.idl
@@ -0,0 +1,127 @@
+/*************************************************************************
+* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+*
+* Copyright 2008 by Sun Microsystems, Inc.
+*
+* OpenOffice.org - a multi-platform office productivity suite
+*
+* $RCSfile: XDocumentEventBroadcaster.idl,v $
+*
+* $Revision: 1.5.2.4 $
+*
+* 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 __com_sun_star_document_XDocumentEventBroadcaster_idl__
+#define __com_sun_star_document_XDocumentEventBroadcaster_idl__
+
+#ifndef __com_sun_star_frame_XController2_idl__
+#include <com/sun/star/frame/XController2.idl>
+#endif
+
+#ifndef __com_sun_star_document_DocumentEvent_idl__
+#include <com/sun/star/document/DocumentEvent.idl>
+#endif
+
+#ifndef __com_sun_star_lang_IllegalArgumentException_idl__
+#include <com/sun/star/lang/IllegalArgumentException.idl>
+#endif
+
+#ifndef __com_sun_star_lang_NoSupportException_idl__
+#include <com/sun/star/lang/NoSupportException.idl>
+#endif
+
+//=============================================================================
+
+module com { module sun { module star { module document {
+
+interface XDocumentEventListener;
+
+//=============================================================================
+
+/** allows to be notified of events happening in an <type>OfficeDocument</type>, and to cause notification
+ of such events.
+
+ <p>This interface is the successor of the XEventBroadcaster interface, which should not be used
+ anymore.</p>
+
+ @see DocumentEvent
+*/
+interface XDocumentEventBroadcaster
+{
+ /** registers a listener which is notified about document events
+
+ @param _Listener
+ the listener to register. The behaviour of the method is undefined this listener
+ is <NULL/>.
+ */
+ void addDocumentEventListener( [in] XDocumentEventListener _Listener );
+
+ /** revokes a listener which has previously been registered to be notified about document events.
+
+ @param _Listener
+ the listener to revoke. The behaviour of the method is undefined this listener
+ is <NULL/>.
+ */
+ void removeDocumentEventListener( [in] XDocumentEventListener _Listener );
+
+ /** causes the broadcaster to notify all registered listeners of the given event
+
+ <p>The method will create a <type>DocumentEvent</type> instance with the given parameters,
+ and fill in the <code>Source</code> member (denoting the broadcaster) as appropriate.</p>
+
+ <p>Whether the actual notification happens synchronously or asynchronously is up to the
+ implementator of this method. However, implementations are encouraged to specify this, for the
+ list of supported event types, in their service contract.</p>
+
+ <p>Implementations might also decide to limit the list of allowed events (means event names) at
+ their own discretion. Again, in this case they're encouraged to document this in their service
+ contract.</p>
+
+ @param _EventName
+ the name of the event to be notified.
+ @param _ViewController
+ the view/controller which the event applies to. May be <NULL/>
+ @param _Supplement
+ supplemental information related to the event.
+
+ @throws ::com::sun::star::lang::IllegalArgumentException
+ if <arg>_EventName</arg> is empty, or if <arg>_EventName</arg> is not supported by the
+ document implementation.
+
+ @throws ::com::sun::star::lang::NoSupportException
+ if the broadcaster implementation does not supported broadcasting events induced externally.
+ This is usually used for components which multiplex events from multiple sources, and thus would
+ be unable to fill in the <code>Source</code> member of the <type>DocumentEvent</type> instance.
+ */
+ void notifyDocumentEvent(
+ [in] string _EventName,
+ [in] ::com::sun::star::frame::XController2 _ViewController,
+ [in] any _Supplement
+ )
+ raises ( ::com::sun::star::lang::IllegalArgumentException,
+ ::com::sun::star::lang::NoSupportException );
+};
+
+//=============================================================================
+
+}; }; }; };
+
+//=============================================================================
+
+#endif
diff --git a/offapi/com/sun/star/document/XDocumentEventListener.idl b/offapi/com/sun/star/document/XDocumentEventListener.idl
new file mode 100644
index 000000000000..345e320cecae
--- /dev/null
+++ b/offapi/com/sun/star/document/XDocumentEventListener.idl
@@ -0,0 +1,67 @@
+/*************************************************************************
+* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+*
+* Copyright 2008 by Sun Microsystems, Inc.
+*
+* OpenOffice.org - a multi-platform office productivity suite
+*
+* $RCSfile: XDocumentEventListener.idl,v $
+*
+* $Revision: 1.5.2.2 $
+*
+* 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 __com_sun_star_document_XDocumentEventListener_idl__
+#define __com_sun_star_document_XDocumentEventListener_idl__
+
+#ifndef __com_sun_star_lang_XEventListener_idl__
+#include <com/sun/star/lang/XEventListener.idl>
+#endif
+
+#ifndef __com_sun_star_document_DocumentEvent_idl__
+#include <com/sun/star/document/DocumentEvent.idl>
+#endif
+
+//=============================================================================
+
+module com { module sun { module star { module document {
+
+//=============================================================================
+
+/** allows to be notified of events happening in an <type>OfficeDocument</type>
+
+ <p>This interface is the successor of the XEventListener interface, which should not be used
+ anymore.</p>
+
+ @see XDocumentEventBroadcaster
+ */
+interface XDocumentEventListener : ::com::sun::star::lang::XEventListener
+{
+ /** is called whenever a document event occured
+ */
+ void documentEventOccured( [in] DocumentEvent Event );
+};
+
+//=============================================================================
+
+}; }; }; };
+
+//=============================================================================
+
+#endif
diff --git a/offapi/com/sun/star/document/XEventBroadcaster.idl b/offapi/com/sun/star/document/XEventBroadcaster.idl
index 8c996f36f8d5..6c938d10e91b 100644
--- a/offapi/com/sun/star/document/XEventBroadcaster.idl
+++ b/offapi/com/sun/star/document/XEventBroadcaster.idl
@@ -7,7 +7,7 @@
* OpenOffice.org - a multi-platform office productivity suite
*
* $RCSfile: XEventBroadcaster.idl,v $
- * $Revision: 1.7 $
+ * $Revision: 1.7.12.1 $
*
* This file is part of OpenOffice.org.
*
@@ -45,6 +45,9 @@ module com { module sun { module star { module document {
//=============================================================================
/** makes it possible to register listeners which are called whenever
a document event (see <type>EventObject</type>) occurs
+
+ @deprecated
+ @see XDocumentEventBroadcaster
*/
published interface XEventBroadcaster: com::sun::star::uno::XInterface
{
diff --git a/offapi/com/sun/star/document/XEventListener.idl b/offapi/com/sun/star/document/XEventListener.idl
index b98fc7f4be6c..668e73774ba2 100644
--- a/offapi/com/sun/star/document/XEventListener.idl
+++ b/offapi/com/sun/star/document/XEventListener.idl
@@ -7,7 +7,7 @@
* OpenOffice.org - a multi-platform office productivity suite
*
* $RCSfile: XEventListener.idl,v $
- * $Revision: 1.9 $
+ * $Revision: 1.9.12.1 $
*
* This file is part of OpenOffice.org.
*
@@ -46,9 +46,10 @@ module com { module sun { module star { module document {
/** makes it possible to register listeners, which are called whenever
a document or document content event occurs
- <p>
- Such events will be broadcasted by a <type>XEventBroadcaster</type>.
- </p>
+ <p>Such events will be broadcasted by a <type>XEventBroadcaster</type>.</p>
+
+ @deprecated
+ @see XDocumentEventListener
*/
published interface XEventListener: com::sun::star::lang::XEventListener
{
diff --git a/offapi/com/sun/star/document/makefile.mk b/offapi/com/sun/star/document/makefile.mk
index 1c9813d43b75..c9003302c5a9 100644
--- a/offapi/com/sun/star/document/makefile.mk
+++ b/offapi/com/sun/star/document/makefile.mk
@@ -8,7 +8,7 @@
#
# $RCSfile: makefile.mk,v $
#
-# $Revision: 1.47 $
+# $Revision: 1.46.12.2 $
#
# This file is part of OpenOffice.org.
#
@@ -44,15 +44,16 @@ PACKAGE=com$/sun$/star$/document
IDLFILES=\
AmbigousFilterRequest.idl\
BrokenPackageRequest.idl\
- CorruptedFilterConfigurationException.idl\
+ CorruptedFilterConfigurationException.idl\
+ DocumentEvent.idl\
DocumentInfo.idl\
- DocumentProperties.idl\
+ DocumentProperties.idl\
EventDescriptor.idl\
EventObject.idl\
Events.idl\
ExportFilter.idl\
ExtendedTypeDetection.idl\
- ExtendedTypeDetectionFactory.idl\
+ ExtendedTypeDetectionFactory.idl\
FilterAdapter.idl\
FilterFactory.idl\
FilterOptionsRequest.idl\
@@ -74,6 +75,8 @@ IDLFILES=\
UpdateDocMode.idl\
XActionLockable.idl\
XBinaryStreamResolver.idl\
+ XDocumentEventBroadcaster.idl\
+ XDocumentEventListener.idl\
XDocumentInfo.idl\
XDocumentInfoSupplier.idl\
XDocumentInsertable.idl\
diff --git a/offapi/com/sun/star/script/provider/ScriptFrameworkErrorType.idl b/offapi/com/sun/star/script/provider/ScriptFrameworkErrorType.idl
index 935a568fe1a4..50455dbaa784 100644
--- a/offapi/com/sun/star/script/provider/ScriptFrameworkErrorType.idl
+++ b/offapi/com/sun/star/script/provider/ScriptFrameworkErrorType.idl
@@ -7,7 +7,7 @@
* OpenOffice.org - a multi-platform office productivity suite
*
* $RCSfile: ScriptFrameworkErrorType.idl,v $
- * $Revision: 1.4 $
+ * $Revision: 1.4.12.1 $
*
* This file is part of OpenOffice.org.
*
@@ -45,9 +45,18 @@ constants ScriptFrameworkErrorType
/** Unknown
*/
const long UNKNOWN = 0;
+
/** ProviderNotSupported
*/
const long NOTSUPPORTED = 1;
+
+ /** the requested method, and/or with the requested signature, does not exist
+ */
+ const long NO_SUCH_SCRIPT = 2;
+
+ /** the requested method, with the requested signature, does not exist
+ */
+ const long MALFORMED_URL = 3;
};
//===========================================================================
diff --git a/offapi/com/sun/star/sdb/OfficeDatabaseDocument.idl b/offapi/com/sun/star/sdb/OfficeDatabaseDocument.idl
index 221d4cbcd988..548bf08ced49 100644
--- a/offapi/com/sun/star/sdb/OfficeDatabaseDocument.idl
+++ b/offapi/com/sun/star/sdb/OfficeDatabaseDocument.idl
@@ -7,7 +7,7 @@
* OpenOffice.org - a multi-platform office productivity suite
*
* $RCSfile: OfficeDatabaseDocument.idl,v $
- * $Revision: 1.7 $
+ * $Revision: 1.7.12.2 $
*
* This file is part of OpenOffice.org.
*
@@ -30,12 +30,21 @@
#ifndef __com_sun_star_sdb_OfficeDatabaseDocument_idl__
#define __com_sun_star_sdb_OfficeDatabaseDocument_idl__
-#ifndef __com_sun_star_script_provider_XScriptProviderSupplier_idl__
-#include <com/sun/star/script/provider/XScriptProviderSupplier.idl>
+#ifndef __com_sun_star_document_OfficeDocument_idl__
+#include <com/sun/star/document/OfficeDocument.idl>
#endif
#ifndef __com_sun_star_sdb_XOfficeDatabaseDocument_idl__
#include <com/sun/star/sdb/XOfficeDatabaseDocument.idl>
#endif
+#ifndef __com_sun_star_document_XDocumentEventBroadcaster_idl__
+#include <com/sun/star/document/XDocumentEventBroadcaster.idl>
+#endif
+#ifndef __com_sun_star_script_provider_XScriptProviderSupplier_idl__
+#include <com/sun/star/script/provider/XScriptProviderSupplier.idl>
+#endif
+#ifndef __com_sun_star_frame_XLoadable_idl__
+#include <com/sun/star/frame/XLoadable.idl>
+#endif
#ifndef __com_sun_star_util_XCloseable_idl__
#include <com/sun/star/util/XCloseable.idl>
#endif
@@ -55,31 +64,161 @@ module com { module sun { module star { module sdb {
<li>All properties of the service <type>DataSource</type></li>
</ul></p>
- <p>The component does not support the <type scope="com::sun::star::view">XPrintable</type> interface. This
- interface is required by the base service (<type scope="com::sun::star::document">OfficeDocument</type>),
- but that's considered a documentation error.</p>
-
@see com::sun::star::sdb::XOfficeDatabaseDocument
@see com::sun::star::document::OfficeDocument
@since OOo 2.0.0
*/
service OfficeDatabaseDocument
{
+ /** specifies basic functionality of a document in OpenOffice.org
+
+ <p>Note that a database document actually does not support the <type scope="com::sun::star::view">XPrintable</type> interface.
+ The non-optional requirement of this interface in the <type scope="com::sun::star::document">OfficeDocument</type>
+ service is considered a documentation error.</p>
+ */
service com::sun::star::document::OfficeDocument;
interface XOfficeDatabaseDocument;
/** allows access to the Basic macros and dialogs possibly embedded in the document
- @since OOo 3.0
+ @since OOo 3.1
*/
interface ::com::sun::star::document::XEmbeddedScripts;
/** supplies a script provider which can be used to execute macros and scripts
embedded in the document
- @since OOo 3.0
+ @since OOo 3.1
*/
interface ::com::sun::star::script::provider::XScriptProviderSupplier;
+ /** allows to initialize the the document, either from scratch, or from a stored
+ database document.
+
+ <p>A newly instantiated database document cannot be operated until it is fully
+ initialized. There are three possible means to do this initialization:
+ <ul><li>calling <code>XLoadable::initNew</code></li>
+ <li>calling <code>XLoadable::load</code></li>
+ <li>calling <code>XStorable::storeAsURL</code></li>
+ </ul>
+ The third option was added for compatibility reasons, since a <type>DatabaseDocument</type>
+ in earlier versions of OpenOffice.org did not support the <code>XLoadable</code> interface,
+ so the usual way of creating a document from scratch was to create it, set properties as
+ needed, and store it.</p>
+
+ @since OOo 3.1
+ */
+ interface ::com::sun::star::frame::XLoadable;
+
+ /** allows to register for notifications happening in the document
+
+ <p>The following events are broadcasted by a database document
+ <table border="1" frame="all">
+ <thead>
+ <tr><td><strong>Event Name</strong></td>
+ <td><strong>broadcasted when</strong></td>
+ <td align="center"><strong>broadcasted synchronously</strong></td>
+ </tr>
+ </thead>
+ <tbody>
+ <tr><td valign="top"><em>OnCreate</em></td>
+ <td>the document has been newly created. This does not imply that the document has
+ been loaded into a frame, it just means the initialization has been finished.</td>
+ <td align="center">yes</td>
+ </tr>
+ <tr><td valign="top"><em>OnLoadFinished</em></td>
+ <td>the document has been completely loaded. This does not imply that the document
+ has been loaded into a frame, it just means the load process has been finished.</td>
+ <td align="center">yes</td>
+ </tr>
+ <tr><td valign="top"><em>OnNew</em></td>
+ <td>the document has been initialized from scratch, including plugging it into a frame.</td>
+ <td align="center">no</td>
+ </tr>
+ <tr><td valign="top"><em>OnLoad</em></td>
+ <td>the document has been completely loaded, including plugging it into a frame.</td>
+ <td align="center">no</td>
+ </tr>
+ <tr><td valign="top"><em>OnSave</em></td>
+ <td>the document is about to be saved.</td>
+ <td align="center">yes</td>
+ </tr>
+ <tr><td valign="top"><em>OnSaveDone</em></td>
+ <td>saving the document succeeeded.</td>
+ <td align="center">no</td>
+ </tr>
+ <tr><td valign="top"><em>OnSaveFailed</em></td>
+ <td>saving the document failed.</td>
+ <td align="center">no</td>
+ </tr>
+ <tr><td valign="top"><em>OnSaveAs</em></td>
+ <td>the document is about to be saved under a new name.</td>
+ <td align="center">yes</td>
+ </tr>
+ <tr><td valign="top"><em>OnSaveAsDone</em></td>
+ <td>saving the document under a new name succeeeded.</td>
+ <td align="center">no</td>
+ </tr>
+ <tr><td valign="top"><em>OnSaveAsFailed</em></td>
+ <td>saving the document under a new name failed.</td>
+ <td align="center">no</td>
+ </tr>
+ <tr><td valign="top"><em>OnSaveTo</em></td>
+ <td>the document is about to be saved to a location different from its
+ current location, but without adjusting the current location.</td>
+ <td align="center">yes</td>
+ </tr>
+ <tr><td valign="top"><em>OnSaveToDone</em></td>
+ <td>saving the document to a different location succeeeded.</td>
+ <td align="center">no</td>
+ </tr>
+ <tr><td valign="top"><em>OnSaveToFailed</em></td>
+ <td>saving the document to a different location failed.</td>
+ <td align="center">no</td>
+ </tr>
+ <tr><td valign="top"><em>OnPrepareUnload</em></td>
+ <td>the document is about to be closed.</td>
+ <td align="center">yes</td>
+ </tr>
+ <tr><td valign="top"><em>OnUnload</em></td>
+ <td>the document is being closed.</td>
+ <td align="center">yes</td>
+ </tr>
+ <tr><td valign="top"><em>OnFocus</em></td>
+ <td>a view to the document obtained the focus.</td>
+ <td align="center">no</td>
+ </tr>
+ <tr><td valign="top"><em>OnUnfocus</em></td>
+ <td>a view to the document lost the focus.</td>
+ <td align="center">no</td>
+ </tr>
+ <tr><td valign="top"><em>OnModifyChanged</em></td>
+ <td>the <quot>modified</quot> state of the document changed.</td>
+ <td align="center">no</td>
+ </tr>
+ <tr><td valign="top"><em>OnViewCreated</em></td>
+ <td>a view to the document has been created, and attached to the document.</td>
+ <td align="center">no</td>
+ </tr>
+ <tr><td valign="top"><em>OnPrepareViewClosing</em></td>
+ <td>a view to the document is about to be closed.</td>
+ <td align="center">yes</td>
+ </tr>
+ <tr><td valign="top"><em>OnViewClosed</em></td>
+ <td>a view to the document has been closed.</td>
+ <td align="center">no</td>
+ </tr>
+ <tr><td valign="top"><em>OnTitleChanged</em></td>
+ <td>the title of the document changed.</td>
+ <td align="center">no</td>
+ </tr>
+ </tbody>
+ </table>
+ </p>
+
+ @since OOo 3.1
+ */
+ interface ::com::sun::star::document::XDocumentEventBroadcaster;
+
/** implements life time control
<p>Whoever retrieves a <type>OfficeDatabaseDocument</type> should be aware of
diff --git a/offapi/com/sun/star/sdb/XOfficeDatabaseDocument.idl b/offapi/com/sun/star/sdb/XOfficeDatabaseDocument.idl
index 539d8f4c9d62..7093c0a03244 100644
--- a/offapi/com/sun/star/sdb/XOfficeDatabaseDocument.idl
+++ b/offapi/com/sun/star/sdb/XOfficeDatabaseDocument.idl
@@ -7,7 +7,7 @@
* OpenOffice.org - a multi-platform office productivity suite
*
* $RCSfile: XOfficeDatabaseDocument.idl,v $
- * $Revision: 1.4 $
+ * $Revision: 1.4.12.1 $
*
* This file is part of OpenOffice.org.
*
@@ -39,12 +39,10 @@
#ifndef __com_sun_star_sdbc_XDataSource_idl__
#include <com/sun/star/sdbc/XDataSource.idl>
#endif
-#ifndef __com_sun_star_document_OfficeDocument_idl__
-#include <com/sun/star/document/OfficeDocument.idl>
-#endif
#ifndef __com_sun_star_document_XDocumentSubStorageSupplier_idl__
#include <com/sun/star/document/XDocumentSubStorageSupplier.idl>
#endif
+
//=============================================================================
module com { module sun { module star { module sdb {