Sophie

Sophie

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

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

<html>
<head>
<title>Interface XImplementationLoader</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="XImplementationLoader-xref.html" class="navimain">Use</a></td>
<td class="navimain"><a href="http://wiki.services.openoffice.org/wiki/Documentation/DevGuide/AdvUNO/Implementation_Loader" class="navimain">Devguide</a></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">loader</a> :: </p>
</td>
</tr>
<tr>
<td class="title">interface XImplementationLoader</td>
</tr>
<tr>
<td/></tr>
<tr>
<td><dl>
<dt><b>Description</b></dt>
<dd>handles activation (loading) of a UNO component.
 </dd>
<dt><b>See also</b></dt>
<dd>::com::sun::star::<a href="../registry/module-ix.html">registry</a>::<a href="../registry/XImplementationRegistration.html">XImplementationRegistration</a></dd>
</dl>
<a name="devmanual"> </a><dl>
<dt><b>Developers Guide</b></dt>
<dd><a href="http://wiki.services.openoffice.org/wiki/Documentation/DevGuide/AdvUNO/Implementation_Loader">AdvUNO - Implementation Loader</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="#activate">activate</a></td>
<td class="imsum_right">activates a concrete implementation within a component.
 &nbsp;</td>
</tr>
<tr>
<td class="imsum_left"><a href="#writeRegistryInfo">writeRegistryInfo</a></td>
<td class="imsum_right">writes a list of all implementations hosted by this component into a registry key.
 &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="activate" class="membertitle">activate</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">::com::sun::star::<a href="../uno/module-ix.html">uno</a>::<a href="../uno/XInterface.html">XInterface</a></td>
</tr>
<tr>
<td valign="top"><b>activate</b>(</td>
<td valign="top">[in] string</td>
<td valign="bottom">&nbsp;implementationName,</td>
</tr>
<tr>
<td/><td valign="top">[in] string</td>
<td valign="bottom">&nbsp;implementationLoaderUrl,</td>
</tr>
<tr>
<td/><td valign="top">[in] string</td>
<td valign="bottom">&nbsp;locationUrl,</td>
</tr>
<tr>
<td/><td valign="top">[in] ::com::sun::star::<a href="../registry/module-ix.html">registry</a>::<a href="../registry/XRegistryKey.html">XRegistryKey</a></td>
<td valign="bottom">&nbsp;xKey )</td>
</tr>
<tr>
<td valign="top" align="right">raises( </td>
<td valign="top" colspan="2"><a href="CannotActivateFactoryException.html">CannotActivateFactoryException</a> );</td>
</tr>
</table>
<hr>
<dl>
<dt><b>Description</b></dt>
<dd>activates a concrete implementation within a component.
 </dd>
<dt><b>Parameter implementationName</b></dt>
<dd>The name of the implementation,
 which shall be instantiated. The method
 <a href="XImplementationLoader.html">XImplementationLoader</a>::<a href="XImplementationLoader.html#writeRegistryInfo">writeRegistryInfo</a>
 writes a list of implementation names hosted by this component.
 </dd>
<dt><b>Parameter implementationLoaderUrl</b></dt>
<dd>specification bug, ignore this parameter, please
 pass an empty string.
 </dd>
<dt><b>Parameter locationUrl</b></dt>
<dd>Points to the location of the file containing
 the component (for instance a .jar-file or a shared library).
 This parameter
 should be in an URL format (= protocol:protocol-dependent-part).
 In case the string contains no
 leading "protocol:", the implementation in general assumes,
 that it is a relative file url. <p>Special loaders may define
 their own protocol (for instance an executable loader may need
 more than only one file url).
 
 </dd>
<dt><b>Parameter xKey</b></dt>
<dd>A registry which may be used to read static data previously
 written via <method>XImplementationLoader::writeRegistryInfo()</method>.
 The use of this parameter is deprecated.
 
 </dd>
<dt><b>Returns</b></dt>
<dd>returns a factory interface, which allows to create an instance of
 the concrete implementation. In general, the object supports a
 ::com::sun::star::<a href="../lang/module-ix.html">lang</a>::<a href="../lang/XSingleComponentFactory.html">XSingleComponentFactory</a>
 and the ::com::sun::star::<a href="../lang/module-ix.html">lang</a>::<a href="../lang/XServiceInfo.html">XServiceInfo</a> interface. The
 XServiceInfo interface informs about the capabilities of the
 service implementation, not the factory itself. 
 </dd>
</dl>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td class="imdetail"><a name="writeRegistryInfo" class="membertitle">writeRegistryInfo</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">boolean</td>
</tr>
<tr>
<td valign="top"><b>writeRegistryInfo</b>(</td>
<td valign="top">[in] ::com::sun::star::<a href="../registry/module-ix.html">registry</a>::<a href="../registry/XRegistryKey.html">XRegistryKey</a></td>
<td valign="bottom">&nbsp;xKey,</td>
</tr>
<tr>
<td/><td valign="top">[in] string</td>
<td valign="bottom">&nbsp;implementationLoaderUrl,</td>
</tr>
<tr>
<td/><td valign="top">[in] string</td>
<td valign="bottom">&nbsp;locationUrl )</td>
</tr>
<tr>
<td valign="top" align="right">raises( </td>
<td valign="top" colspan="2">::com::sun::star::<a href="../registry/module-ix.html">registry</a>::<a href="../registry/CannotRegisterImplementationException.html">CannotRegisterImplementationException</a> );</td>
</tr>
</table>
<hr>
<dl>
<dt><b>Description</b></dt>
<dd>writes a list of all implementations hosted by this component into a registry key.
 </dd>
<dd><p>This method is called during registering a component.
 </dd>
<dt><b>Parameter xKey</b></dt>
<dd>The registry key, which shall be used to write for each
 implementation the implementation name plus a list of supported
 services.
 </dd>
<dt><b>Parameter implementationLoaderUrl</b></dt>
<dd>specification bug, ignore this parameter, please
 pass an empty string.
 </dd>
<dt><b>Parameter locationUrl</b></dt>
<dd>Points to the location of the file containing
 the component (for instance a .jar-file or a shared library).
 This parameter
 should be in an URL format (= protocol:protocol-dependent-part).
 In case the string contains no
 leading &quot;protocol:&quot;, the implementation in general assumes,
 that it is a relative file url. <p>Special loaders may define
 their own protocol (for instance an executable loader may need
 more than only one file url).
 </dd>
<dt><b>See also</b></dt>
<dd>::com::sun::star::<a href="../registry/module-ix.html">registry</a>::<a href="../registry/XImplementationRegistration.html">XImplementationRegistration</a></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>