<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">Services' Summary</td> <td class="navisub"><a href="#InterfacesSummary" class="navisub">Interfaces' Summary</a></td> <td class="navisub">Properties' Summary</td> <td class="navisub">Services' Details</td> <td class="navisub"><a href="#InterfacesDetails" class="navisub">Interfaces' Details</a></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="InterfacesSummary"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle"> <tr> <td class="subtitle" colspan="2">Exported Interfaces - Summary</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"><p>allows to register listeners to be notified of changes in the container. </p> </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"><p>allows to add/remove elements by name. </p> </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"><p>gives access to the elements by index. </p> </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"><p>creates an enumeration of the elements. </p> </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"><p>This interface has to be implemented to supply the scripting environment for the contained components. (<a href="#XEventAttacherManager">details</a>)</p> </td> </tr> </table> <a name="InterfacesDetails"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle"> <tr> <td class="subtitle" colspan="2">Exported Interfaces - Details</td> </tr> <tr/> <tr> <td class="imdetail"><a name="XContainer" class="membertitle">::com::sun::star::<a href="../container/module-ix.html">container</a>::<a href="../container/XContainer.html">XContainer</a></a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center"> <tr> <td><dl> <dt><b>Description</b></dt> <dd>allows to register listeners to be notified of changes in the container. </dd> </dl> </td> </tr> </table> </td> </tr> <tr/> <tr> <td class="imdetail"><a name="XNameContainer" class="membertitle">::com::sun::star::<a href="../container/module-ix.html">container</a>::<a href="../container/XNameContainer.html">XNameContainer</a></a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center"> <tr> <td><dl> <dt><b>Description</b></dt> <dd>allows to add/remove elements by name. </dd> </dl> </td> </tr> </table> </td> </tr> <tr/> <tr> <td class="imdetail"><a name="XIndexContainer" class="membertitle">::com::sun::star::<a href="../container/module-ix.html">container</a>::<a href="../container/XIndexContainer.html">XIndexContainer</a></a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center"> <tr> <td><dl> <dt><b>Description</b></dt> <dd>gives access to the elements by index. </dd> </dl> </td> </tr> </table> </td> </tr> <tr/> <tr> <td class="imdetail"><a name="XEnumerationAccess" class="membertitle">::com::sun::star::<a href="../container/module-ix.html">container</a>::<a href="../container/XEnumerationAccess.html">XEnumerationAccess</a></a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center"> <tr> <td><dl> <dt><b>Description</b></dt> <dd>creates an enumeration of the elements. </dd> </dl> </td> </tr> </table> </td> </tr> <tr/> <tr> <td class="imdetail"><a name="XEventAttacherManager" class="membertitle">::com::sun::star::<a href="../script/module-ix.html">script</a>::<a href="../script/XEventAttacherManager.html">XEventAttacherManager</a></a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center"> <tr> <td><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> </td> </tr> </table> <br> <a href="#_top_">Top of Page</a><hr size="3"><p class="copyright" align="center">Copyright © 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>