<html> <head> <title>Service FormComponents</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="FormComponents-xref.html" class="navimain">Use</a></td> <td class="navimain"><a href="http://wiki.services.openoffice.org/wiki/Documentation/DevGuide/Forms/FormComponents_Service" 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">Included Services</td> <td class="navisub"><a href="#ExportedInterfaces" class="navisub">Exported Interfaces</a></td> <td class="navisub">Properties' Summary</td> <td class="navisub">Properties' 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">form</a> :: </p> </td> </tr> <tr> <td class="title">service FormComponents</td> </tr> <tr> <td><dl> <dt><b>Description</b></dt> <dd>specifies the capabilities of a collection of <a href="FormComponent.html">FormComponent</a>s. </dd> <dd><p>The collection must provide the possibility of adding and removing components by name and by index. The name of a component is not necessarily unique, so the collection must be able to handle duplicate entry names.</p> </dd> <dt><b>See also</b></dt> <dd><a href="FormComponent.html">FormComponent</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/Forms/FormComponents_Service">Forms - FormComponents Service</a></dd> </dl> </td> </tr> </table> <hr> <a name="ExportedInterfaces"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle"> <tr> <td class="subtitle" colspan="2">Exported Interfaces</td> </tr> <tr> <td class="imsum_left">::com::sun::star::<a href="../container/module-ix.html">container</a>::<a href="../container/XContainer.html">XContainer</a></td> <td class="imsum_right"><dl> <dt><b>Description</b></dt> <dd>allows to register listeners to be notified of changes in the container. </dd> </dl> </td> </tr> <tr> <td class="imsum_left">::com::sun::star::<a href="../container/module-ix.html">container</a>::<a href="../container/XNameContainer.html">XNameContainer</a></td> <td class="imsum_right"><dl> <dt><b>Description</b></dt> <dd>allows to add/remove elements by name. </dd> </dl> </td> </tr> <tr> <td class="imsum_left">::com::sun::star::<a href="../container/module-ix.html">container</a>::<a href="../container/XIndexContainer.html">XIndexContainer</a></td> <td class="imsum_right"><dl> <dt><b>Description</b></dt> <dd>gives access to the elements by index. </dd> </dl> </td> </tr> <tr> <td class="imsum_left">::com::sun::star::<a href="../container/module-ix.html">container</a>::<a href="../container/XEnumerationAccess.html">XEnumerationAccess</a></td> <td class="imsum_right"><dl> <dt><b>Description</b></dt> <dd>creates an enumeration of the elements. </dd> </dl> </td> </tr> <tr> <td class="imsum_left">::com::sun::star::<a href="../script/module-ix.html">script</a>::<a href="../script/XEventAttacherManager.html">XEventAttacherManager</a></td> <td class="imsum_right"><dl> <dt><b>Description</b></dt> <dd>This interface has to be implemented to supply the scripting environment for the contained components. </dd> <dd><p>The interface allows managing of scripts associated with dependent components, accessed by index. However, as a client of the <a href="FormComponents.html">FormComponents</a> service, there's no need to bother with the container aspect of the ::com::sun::star::<a href="../script/module-ix.html">script</a>::<a href="../script/XEventAttacherManager.html">XEventAttacherManager</a> directly. A <a href="FormComponents.html">FormComponents</a> container will automatically synchronize the elements you put into it with the scripting information obtained at the ::com::sun::star::<a href="../script/module-ix.html">script</a>::<a href="../script/XEventAttacherManager.html">XEventAttacherManager</a> interface.</p> <p>For instance, at any time you can obtain the events associated with the <code>n</code><super>th</super> element in the form components by calling ::com::sun::star::<a href="../script/module-ix.html">script</a>::<a href="../script/XEventAttacherManager.html">XEventAttacherManager</a>::<a href="../script/XEventAttacherManager.html#getScriptEvents">getScriptEvents</a> with paramter <code>n</code>. In particular, this invariant is always met, even after you inserted/removed elements into/from the container.</p> </dd> </dl> </td> </tr> </table> <br> <a href="#_top_">Top of Page</a><hr size="3"><p class="copyright" align="center">Copyright © 2008 Sun Microsystems, Inc.</p> </div> <!-- id="adc-idlref" --> </body> </html>