Sophie

Sophie

distrib > Mandriva > current > i586 > media > main-updates > by-pkgid > fc480f9d5aabed8eeaffe8ad3401a94c > files > 2493

openoffice.org-devel-doc-3.2.1-0.3mdv2010.2.i586.rpm

<html>
<head>
<title>Interface XTypeDetection</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" type="text/css" href="../../../../idl.css">
</head>
<body>
<div id="adc-idlref">

<a name="_top_"> </a><table class="navimain" border="0" cellpadding="3">
<tr>
<td class="navimain"><a href="../module-ix.html" class="navimain">Overview</a></td>
<td class="navimain"><a href="module-ix.html" class="navimain">Module</a></td>
<td class="navimain"><a href="XTypeDetection-xref.html" class="navimain">Use</a></td>
<td class="navimainnone">Devguide</td>
<td class="navimain"><a href="../../../../index-files/index-1.html" class="navimain">Index</a></td>
</tr>
</table>
<table class="navisub" border="0" cellpadding="0">
<tr>
<td class="navisub"><a href="#MethodsSummary" class="navisub">Methods' Summary</a></td>
<td class="navisub">Attributes' Summary</td>
<td class="navisub"><a href="#MethodsDetails" class="navisub">Methods' Details</a></td>
<td class="navisub">Attributes' Details</td>
</tr>
</table>
<hr>
<table border="0" width="100%" cellpadding="5" cellspacing="3" class="title-table" style="margin-bottom:6pt;">
<tr>
<td><p class="namechain"><a href="../../../../module-ix.html" class="namechain">::</a> <a href="../../../module-ix.html" class="namechain">com</a> :: <a href="../../module-ix.html" class="namechain">sun</a> :: <a href="../module-ix.html" class="namechain">star</a> :: <a href="module-ix.html" class="namechain">document</a> :: </p>
</td>
</tr>
<tr>
<td class="title">interface XTypeDetection</td>
</tr>
<tr>
<td/></tr>
<tr>
<td><dl>
<dt><b>Description</b></dt>
<dd>support "flat" and "deep" type detection of a given document

 </dd>
<dd><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>

 </dd>
<dt><b>See also</b></dt>
<dd><a href="TypeDetection.html">TypeDetection</a></dd>
</dl>
</td>
</tr>
</table>
<hr>
<a name="MethodsSummary"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle">
<tr>
<td class="subtitle" colspan="2">Methods' Summary</td>
</tr>
<tr>
<td class="imsum_left"><a href="#queryTypeByURL">queryTypeByURL</a></td>
<td class="imsum_right">make a "flat" detection by using the URL of the document

 &nbsp;</td>
</tr>
<tr>
<td class="imsum_left"><a href="#queryTypeByDescriptor">queryTypeByDescriptor</a></td>
<td class="imsum_right">make a "deep" detection or optional a "flat" detection by using a
 <a href="MediaDescriptor.html">MediaDescriptor</a>

 &nbsp;</td>
</tr>
</table>
<a name="MethodsDetails"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle">
<tr>
<td class="subtitle">Methods' Details</td>
</tr>
<tr>
<td class="imdetail"><a name="queryTypeByURL" class="membertitle">queryTypeByURL</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-method" bgcolor="#ffffff" align="center">
<tr>
<td><table class="table-in-method" border="0">
<tr>
<td valign="top" colspan="3">string</td>
</tr>
<tr>
<td valign="top"><b>queryTypeByURL</b>(</td>
<td valign="top">[in] string</td>
<td valign="bottom">&nbsp;URL );</td>
</tr>
</table>
<hr>
<dl>
<dt><b>Description</b></dt>
<dd>make a "flat" detection by using the URL of the document

 </dd>
<dd><p>
 It use given URL in combination with the internal configuration of well known
 types only to specify the format of given document.
 </p>

 </dd>
<dt><b>Parameter URL</b></dt>
<dd>specify the document by name

 </dd>
<dt><b>Returns</b></dt>
<dd>an internal type name which represent the detected format
 <br>
 or an empty value for unknown ones
 </dd>
</dl>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td class="imdetail"><a name="queryTypeByDescriptor" class="membertitle">queryTypeByDescriptor</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-method" bgcolor="#ffffff" align="center">
<tr>
<td><table class="table-in-method" border="0">
<tr>
<td valign="top" colspan="3">string</td>
</tr>
<tr>
<td valign="top"><b>queryTypeByDescriptor</b>(</td>
<td valign="top">[inout] sequence&lt; ::com::sun::star::<a href="../beans/module-ix.html">beans</a>::<a href="../beans/PropertyValue.html">PropertyValue</a> &gt;</td>
<td valign="bottom">&nbsp;Descriptor,</td>
</tr>
<tr>
<td/><td valign="top">[in] boolean</td>
<td valign="bottom">&nbsp;AllowDeep );</td>
</tr>
</table>
<hr>
<dl>
<dt><b>Description</b></dt>
<dd>make a "deep" detection or optional a "flat" detection by using a
 <a href="MediaDescriptor.html">MediaDescriptor</a>

 </dd>
<dd><p>
 Instead of <a href="XTypeDetection.html">XTypeDetection</a>::<a href="XTypeDetection.html#queryTypeByURL">queryTypeByURL()</a> this function
 use a <a href="MediaDescriptor.html">MediaDescriptor</a> 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 <a href="MediaDescriptor.html">MediaDescriptor</a>::<a href="MediaDescriptor.html#URL">URL</a> should be set on
 this descriptor as minimum. It specifies the location of the document.
 If this parameter is missing another one is required: <a href="MediaDescriptor.html">MediaDescriptor</a>::<a href="MediaDescriptor.html#InputStream">InputStream</a>.
 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.
 <a href="MediaDescriptor.html">MediaDescriptor</a>::<a href="MediaDescriptor.html#ReadOnly">ReadOnly</a>).
 <br>
 As an additional feature it's possible to suppress "deep" detection by using argument
 <var>AllowDeep</var>.
 </p>

 </dd>
<dt><b>Parameter Descriptor</b></dt>
<dd>means the <a href="MediaDescriptor.html">MediaDescriptor</a> which specify the ressource for detection

 </dd>
<dt><b>Parameter AllowDeep</b></dt>
<dd>if it is set to <b>true</b> a "deep" detection will be follow a "flat" detection
 <br>
 if it is set to <b>false</b> a "flat" detection will be made only

 </dd>
<dt><b>Returns</b></dt>
<dd>an internal type name which represent the detected format
 <br>
 or an empty value for unknown ones
 </dd>
</dl>
</td>
</tr>
</table>
</td>
</tr>
</table>
<a href="#_top_">Top of Page</a><hr size="3"><p class="copyright" align="center">Copyright &copy; 2011, Oracle and/or its affiliates. All rights reserved. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.</p>

</div> <!-- id="adc-idlref" -->
</body>

</html>