blob: 5fc14f65ebd95a6e04c6de371404b04b4e473182 (
plain)
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
|
/*************************************************************************
*
* 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 __com_sun_star_document_XTypeDetection_idl__
#define __com_sun_star_document_XTypeDetection_idl__
#ifndef __com_sun_star_uno_XInterface_idl__
#include <com/sun/star/uno/XInterface.idl>
#endif
#ifndef __com_sun_star_beans_PropertyValue_idl__
#include <com/sun/star/beans/PropertyValue.idl>
#endif
//============================================================================
module com { module sun { module star { module document {
//============================================================================
/** support "flat" and "deep" type detection of a given document
<p>
A "flat" detection means specifying the document format by using
the URL and some configuration data only. That will perform but produce
may invalid results if e.g., the extension of the document is wrong.
A "deep" detection means looking into the document stream to be right
which format it supports. Of course that includes a "flat" detection before.
The combination of both ones should produce stable results everytime.
</p>
@see TypeDetection
*/
published interface XTypeDetection: com::sun::star::uno::XInterface
{
//-------------------------------------------------------------------------
/** make a "flat" detection by using the URL of the document
<p>
It use given URL in combination with the internal configuration of well known
types only to specify the format of given document.
</p>
@param URL
specify the document by name
@returns
an internal type name which represent the detected format
<br>
or an empty value for unknown ones
*/
string queryTypeByURL( [in] string URL );
//-------------------------------------------------------------------------
/** make a "deep" detection or optional a "flat" detection by using a
<type>MediaDescriptor</type>
<p>
Instead of <member>XTypeDetection::queryTypeByURL()</member> this function
use a <type>MediaDescriptor</type> to specify the document for detection.
Such descriptor hold different informations about the document.
He will be passed to any part of made detection process and every part
can change it to actualize it.
The property <member>MediaDescriptor::URL</member> should be set on
this descriptor as minimum. It specifies the location of the document.
If this parameter is missing another one is required: <member>MediaDescriptor::InputStream</member>.
This can be usefull to prevent operaton against multiple opening of the stream
and perform the operation. If this stream isn't already included the detection
will open it (if allowed!) and add it to the descriptor so it will be available for
all following parts.
A combination of both parameters can be usefull to perform the operation
and make results more stable; but only one of them is required.
Of course its possible to specify more document properties (e.g.
<member>MediaDescriptor::ReadOnly</member>).
<br>
As an additional feature it's possible to suppress "deep" detection by using argument
<var>AllowDeep</var>.
</p>
@param Descriptor
means the <type>MediaDescriptor</type> which specify the ressource for detection
@param AllowDeep
if it is set to <TRUE/> a "deep" detection will be follow a "flat" detection
<br>
if it is set to <FALSE/> a "flat" detection will be made only
@returns
an internal type name which represent the detected format
<br>
or an empty value for unknown ones
*/
string queryTypeByDescriptor(
[inout] sequence< com::sun::star::beans::PropertyValue > Descriptor,
[in] boolean AllowDeep );
};
//============================================================================
}; }; }; };
#endif
|
