1 /*************************************************************************
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
5 * Copyright 2008 by Sun Microsystems, Inc.
7 * OpenOffice.org - a multi-platform office productivity suite
9 * $RCSfile: TransientDocumentsDocumentContent.idl,v $
12 * This file is part of OpenOffice.org.
14 * OpenOffice.org is free software: you can redistribute it and/or modify
15 * it under the terms of the GNU Lesser General Public License version 3
16 * only, as published by the Free Software Foundation.
18 * OpenOffice.org is distributed in the hope that it will be useful,
19 * but WITHOUT ANY WARRANTY; without even the implied warranty of
20 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21 * GNU Lesser General Public License version 3 for more details
22 * (a copy is included in the LICENSE file that accompanied this code).
24 * You should have received a copy of the GNU Lesser General Public License
25 * version 3 along with OpenOffice.org. If not, see
26 * <http://www.openoffice.org/license.html>
27 * for a copy of the LGPLv3 License.
29 ************************************************************************/
30 #ifndef __com_sun_star_ucb_TransientDocumentsDocumentContent_idl__
31 #define __com_sun_star_ucb_TransientDocumentsDocumentContent_idl__
33 #ifndef __com_sun_star_lang_XComponent_idl__
34 #include
<com
/sun
/star
/lang
/XComponent.idl
>
37 #ifndef __com_sun_star_ucb_XContent_idl__
38 #include
<com
/sun
/star
/ucb
/XContent.idl
>
41 #ifndef __com_sun_star_ucb_XCommandProcessor_idl__
42 #include
<com
/sun
/star
/ucb
/XCommandProcessor.idl
>
45 #ifndef __com_sun_star_ucb_XCommandProcessor2_idl__
46 #include
<com
/sun
/star
/ucb
/XCommandProcessor2.idl
>
49 #ifndef __com_sun_star_beans_XPropertiesChangeNotifier_idl__
50 #include
<com
/sun
/star
/beans
/XPropertiesChangeNotifier.idl
>
53 #ifndef __com_sun_star_beans_XPropertyContainer_idl__
54 #include
<com
/sun
/star
/beans
/XPropertyContainer.idl
>
57 #ifndef __com_sun_star_beans_XPropertySetInfoChangeNotifier_idl__
58 #include
<com
/sun
/star
/beans
/XPropertySetInfoChangeNotifier.idl
>
61 #ifndef __com_sun_star_ucb_XCommandInfoChangeNotifier_idl__
62 #include
<com
/sun
/star
/ucb
/XCommandInfoChangeNotifier.idl
>
65 #ifndef __com_sun_star_container_XChild_idl__
66 #include
<com
/sun
/star
/container
/XChild.idl
>
69 #ifndef __com_sun_star_ucb_XContentCreator_idl__
70 #include
<com
/sun
/star
/ucb
/XContentCreator.idl
>
73 //=============================================================================
75 module com
{ module sun
{ module star
{ module ucb
{
77 //=============================================================================
78 /** A TDCP Document represents the root folder of a transient document.
80 <p>It is a container for other TDCP Folders and TDCP Streams. It is always
81 a child of the TDCP Root.
83 @see TransientDocumentsContentProvider
84 @see TransientDocumentsRootContent
85 @see TransientDocumentsFolderContent
86 @see TransientDocumentsStreamContent
90 service TransientDocumentsDocumentContent
92 //-------------------------------------------------------------------------
93 /** This interface is implemented according to the specification of
94 service <type>Content</type>.
96 interface com
::sun
::star
::lang
::XComponent
;
98 //-------------------------------------------------------------------------
99 /** This interface is implemented according to the specification of
100 service <type>Content</type>.
102 interface com
::sun
::star
::ucb
::XContent
;
104 //-------------------------------------------------------------------------
105 /** This interface is implemented according to the specification of
106 service <type>Content</type>.
110 <b>Supported Commands</b>
128 transfer (only transfers TDCP documents, TDCP folders and TDCP streams.
129 It does not handle contents with a URL scheme other than the TDOC URL
134 <b>Supported Properties</b>
137 string ContentType ( read-only, always "application/vnd.sun.star.tdoc-document" )
140 boolean IsDocument ( read-only, always false )
143 boolean IsFolder ( read-only, always true )
146 string Title ( read-only )
152 interface com
::sun
::star
::ucb
::XCommandProcessor
;
154 //-------------------------------------------------------------------------
155 /** is an enhanced version of <type>XCommandProcessor</type> that has an
156 additional method for releasing command identifiers obtained via
157 <member>XCommandProcessor::createCommandIdentifier</member> to avoid
158 resource leaks. For a detailed description of the problem refer to
159 <member>XCommandProcessor2::releaseCommandIdentifier</member>.
161 <p>Where many existing <type>Content</type> implementations do not
162 (yet), every new implementation should support this interface.
164 [optional] interface com
::sun
::star
::ucb
::XCommandProcessor2
;
166 //-------------------------------------------------------------------------
167 /** This interface is implemented according to the specification of
168 service <type>Content</type>.
170 interface com
::sun
::star
::beans
::XPropertiesChangeNotifier
;
172 //-------------------------------------------------------------------------
173 /** This interface is implemented according to the specification of
174 service <type>Content</type>.
176 interface com
::sun
::star
::beans
::XPropertyContainer
;
178 //-------------------------------------------------------------------------
179 /** This interface is implemented according to the specification of
180 service <type>Content</type>.
182 interface com
::sun
::star
::beans
::XPropertySetInfoChangeNotifier
;
184 //-------------------------------------------------------------------------
185 /** This interface is implemented according to the specification of
186 service <type>Content</type>.
188 interface com
::sun
::star
::ucb
::XCommandInfoChangeNotifier
;
190 //-------------------------------------------------------------------------
191 /** This interface is implemented according to the specification of
192 service <type>Content</type>.
194 interface com
::sun
::star
::container
::XChild
;
196 //-------------------------------------------------------------------------
197 /** This interface is implemented according to the specification of
198 service <type>Content</type>.
200 <p>To create a new child of a TDCP Document:
204 Let the parent folder create a new content by calling
205 <member>XContentCreator::createNewContent</member> on it. The content
206 type to use for new folders is "application/vnd.sun.star.tdoc-folder".
207 To create a new stream, use the type string
208 "application/vnd.sun.star.tdoc-stream".
211 Set a title for the new folder/stream. (Let the new child execute the
212 command "setPropertyValues"; pass a non-empty value for the property
216 Let the new child ( not the parent! ) execute the command "insert".
217 This will commit the creation process. For streams, you need to supply
218 the implementation of an
219 <type scope="com::sun::star::io">XInputStream</type> with the command's
220 parameters, that provides access to the stream data.
226 interface com
::sun
::star
::ucb
::XContentCreator
;
229 //=============================================================================