<html> <head> <title>Interface XResourceFactory</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="XResourceFactory-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">drawing</a> :: <a href="module-ix.html" class="namechain">framework</a> :: </p> </td> </tr> <tr> <td class="title"><table class="title-table" width="99%"> <tr> <td width="25%" class="title2">unpublished </td> <td width="50%" class="title">interface XResourceFactory</td> <td width="*"/></tr> </table> </td> </tr> <tr> <td/></tr> <tr> <td><dl> <dt><b>Usage Restrictions</b></dt> <dd><i>not published</i></dd> <dt><b>Description</b></dt> <dd>Factory and possibly cache for creating and releasing resources. </dd> <dd><p>A resource factory is created and used by the <a href="XConfigurationController.html">XConfigurationController</a> object.</p> <p>A factory may want to implement a cache to reuse previously released resources.</p> </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="#createResource">createResource</a></td> <td class="imsum_right">Create a resource for the given <a href="XResourceId.html">XResourceId</a> object. </td> </tr> <tr> <td class="imsum_left"><a href="#releaseResource">releaseResource</a></td> <td class="imsum_right">Call this method to tell a factory that the given resource is no longer in use. The factory can decide whether to destroy the resource or to keep it in a cache in order to reuse it later. </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="createResource" class="membertitle">createResource</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"><a href="XResource.html">XResource</a></td> </tr> <tr> <td valign="top"><b>createResource</b>(</td> <td valign="top">[in] <a href="XResourceId.html">XResourceId</a></td> <td valign="bottom"> xResourceId )</td> </tr> <tr> <td valign="top" align="right">raises( </td> <td valign="top" colspan="2">::com::sun::star::<a href="../../lang/module-ix.html">lang</a>::<a href="../../lang/IllegalArgumentException.html">IllegalArgumentException</a>,<br> ::com::sun::star::<a href="../../lang/module-ix.html">lang</a>::<a href="../../lang/WrappedTargetException.html">WrappedTargetException</a> );</td> </tr> </table> <hr> <dl> <dt><b>Description</b></dt> <dd>Create a resource for the given <a href="XResourceId.html">XResourceId</a> object. </dd> <dt><b>Parameter xResourceId</b></dt> <dd>The resource URL of this id specifies the type of resource to create. The anchor can be used to obtain the associated object from the configuration controller. For example, when a view is created, then the new object can be initialized with the pane that is its anchor. <p>Valid values are those for which the factory has previously been registered at the <a href="XConfigurationController.html">XConfigurationController</a></p>. </dd> <dt><b>Returns</b></dt> <dd>Returns a resource object that has been just created or was taken from a cache. When the requested resource can not be created then an empty reference is returned. A later call may be successful. This, for example, can be the case with SFX based side panes. They are not available right after the creation of a new application frame. </dd> <dt><b>Throws</b></dt> <dd>InvalidArgumentException when the given URL is not supported by the factory. </dd> </dl> </td> </tr> </table> </td> </tr> <tr> <td class="imdetail"><a name="releaseResource" class="membertitle">releaseResource</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">void</td> </tr> <tr> <td valign="top"><b>releaseResource</b>(</td> <td valign="top">[in] <a href="XResource.html">XResource</a></td> <td valign="bottom"> xResource );</td> </tr> </table> <hr> <dl> <dt><b>Description</b></dt> <dd>Call this method to tell a factory that the given resource is no longer in use. The factory can decide whether to destroy the resource or to keep it in a cache in order to reuse it later. </dd> <dt><b>Parameter xResource</b></dt> <dd>The given resource has to be one created by the same factory. </dd> <dt><b>Throws</b></dt> <dd>InvalidArgumentException when the given pane was not created by the same factory. </dd> </dl> </td> </tr> </table> </td> </tr> </table> <a href="#_top_">Top of Page</a><hr size="3"><p class="copyright" align="center">Copyright © 2000, 2012 LibreOffice contributors and/or their affiliates. All rights reserved.</p><p class="copyright" align="center">LibreOffice was created by The Document Foundation, based on OpenOffice.org, which is Copyright 2000, 2010 Oracle and/or its affiliates.</p><p class="copyright" align="center">The Document Foundation acknowledges all community members, please find more info <a href="http://www.libreoffice.org/about-us/credits/" target="_blank">at our website</a>.<p> </p><p class="copyright" align="center"><a href="http://www.libreoffice.org/privacy" target="_blank">Privacy Policy</a> | <a href="http://www.libreoffice.org/imprint" target="_blank">Impressum (Legal Info)</a> | Copyright information: The source code of LibreOffice is licensed under the GNU Lesser General Public License (<a href="http://www.libreoffice.org/download/license/" target="_blank">LGPLv3</a>). "LibreOffice" and "The Document Foundation" are registered trademarks of their corresponding registered owners or are in actual use as trademarks in one or more countries. Their respective logos and icons are also subject to international copyright laws. Use thereof is explained in our <a href="http://wiki.documentfoundation.org/TradeMark_Policy" target="_blank">trademark policy</a>.</p> </div> <!-- id="adc-idlref" --> </body> </html>