1/**************************************************************
2 *
3 * Licensed to the Apache Software Foundation (ASF) under one
4 * or more contributor license agreements.  See the NOTICE file
5 * distributed with this work for additional information
6 * regarding copyright ownership.  The ASF licenses this file
7 * to you under the Apache License, Version 2.0 (the
8 * "License"); you may not use this file except in compliance
9 * with the License.  You may obtain a copy of the License at
10 *
11 *   http://www.apache.org/licenses/LICENSE-2.0
12 *
13 * Unless required by applicable law or agreed to in writing,
14 * software distributed under the License is distributed on an
15 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
16 * KIND, either express or implied.  See the License for the
17 * specific language governing permissions and limitations
18 * under the License.
19 *
20 *************************************************************/
21
22
23#ifndef __com_sun_star_document_XStandaloneDocumentInfo_idl__
24#define __com_sun_star_document_XStandaloneDocumentInfo_idl__
25
26#ifndef __com_sun_star_document_XDocumentInfo_idl__
27#include <com/sun/star/document/XDocumentInfo.idl>
28#endif
29
30#ifndef __com_sun_star_io_IOException_idl__
31#include <com/sun/star/io/IOException.idl>
32#endif
33
34//=============================================================================
35
36module com {   module sun {   module star {   module document {
37
38//=============================================================================
39/** makes it possible to load document information from
40	a resource specified by a URL and to store it into a resource also
41    specified by a URL
42
43    <p>
44    Only the document information part of the resource is transferred.
45    Instead of <type>DocumentInfo</type> not the whole document will be opened.
46    Note: Without specifying the source or target of this info (the document)
47    nothing can work and will be handled as void (for reading) or ignored (for writing).
48    After specigiying the source/target by using this interface,
49    the interface <type>XDocumentInfo</type> (which must be implemented on same
50    object then this one!) provides access to the info properties.
51    </p>
52
53    @deprecated     Use <type>XDocumentProperties</type> instead.
54
55    @see DocumentInfo
56    @see StandaloneDocumentInfo
57    @see XDocumentInfo
58 */
59published interface XStandaloneDocumentInfo: XDocumentInfo
60{
61	//-------------------------------------------------------------------------
62    /** loads the document information from a file referred by an URL
63
64        <p>
65        After an unsuccessful call the contents of the document
66        information are undefined (void).
67        This method only works for storage file formats.
68		</p>
69
70        @param URL
71            specifies the source of information
72
73        @throws com::sun::star::io::IOException
74            if storage couldn't be found or opened
75	 */
76    void loadFromURL( [in] string URL )
77        raises( com::sun::star::io::IOException );
78
79	//-------------------------------------------------------------------------
80    /** stores the document information into a file referred by a URL
81
82        <p>
83        Only the document information part of the document is overwritten.
84        This method only works for storage file formats.
85		</p>
86
87        @param URL
88            specifies the target for saving
89
90        @throws com::sun::star::io::IOException
91            if storage couldn't be found or opened
92	 */
93    void storeIntoURL( [in] string URL )
94        raises( com::sun::star::io::IOException );
95};
96
97//=============================================================================
98
99}; }; }; };
100
101#endif
102