<html> <head> <title>Service SetElement</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="SetElement-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="#ServicesSummary" class="navisub">Services' Summary</a></td> <td class="navisub"><a href="#InterfacesSummary" class="navisub">Interfaces' Summary</a></td> <td class="navisub">Properties' Summary</td> <td class="navisub"><a href="#ServicesDetails" class="navisub">Services' Details</a></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">configuration</a> :: </p> </td> </tr> <tr> <td class="title">service SetElement</td> </tr> <tr> <td><dl> <dt><b>Description</b></dt> <dd>provides information about a dynamic element that can be inserted into a homogeneous set of elements within a hierarchy. </dd> <dd><p>Provides information about the element. Provides access to its containing set object. Allows controlling the lifetime of the element. </p> <p>Set elements may be added to and removed from the hierarchy at runtime. They bear user-defined names. They may exist independently, outside any container. </p> <p>New set element instances generally are created through members of ::com::sun::star::<a href="../lang/module-ix.html">lang</a>::<a href="../lang/XSingleServiceFactory.html">XSingleServiceFactory</a> or, if supported, ::com::sun::star::<a href="../lang/module-ix.html">lang</a>::<a href="../lang/XMultiServiceFactory.html">XMultiServiceFactory</a> on an implementation of <a href="SetUpdate.html">SetUpdate</a>. Initially, they are not contained in a set object and have no meaningful name. </p> <p>While an instance is not contained in a set object, it is owned by the client and can be disposed by calling ::com::sun::star::<a href="../lang/module-ix.html">lang</a>::<a href="../lang/XComponent.html">XComponent</a>::<a href="../lang/XComponent.html#dispose">dispose()</a>. The name of the object can freely be changed in that situation though without persistent effect. </p> <p>When the instance is inserted into a set (this includes replacing an existing element), ownership is transferred to the container. While it is contained in the container, clients must not dispose the object. When inserted, the name of the object is fixed and is used to identify it within the container. An implementation may support ::com::sun::star::<a href="../container/module-ix.html">container</a>::<a href="../container/XNamed.html">XNamed</a>::<a href="../container/XNamed.html#setName">setName()</a> even in this case. If it does, changing the name has the same effect of removing the object (under the old name) and then reinserting it into the same container (using the new name). </p> <p>When an instance is removed from a set (this includes being replaced by a new element), ownership is transferred to the client again. It can then be disposed or reinserted into a container. An instance can only be inserted into a container, if it was obtained from the same hierarchy. </p> <p>When a set element is removed from its set from outside the hierarchy, the container disposes of the object. This occurrence can be detected by registering a ::com::sun::star::<a href="../lang/module-ix.html">lang</a>::<a href="../lang/XEventListener.html">XEventListener</a> with the object. </p> <p>If an implementation is part of a <em>read-only</em> view of the hierarchy, changing the name or parent is not supported (the object can't be removed from its container anyway). </p> </dd> <dt><b>See also</b></dt> <dd><a href="SetAccess.html">SetAccess</a><br> Parent objects of this service generally implement service SetAccess. </dd> <dt><b>See also</b></dt> <dd><a href="GroupElement.html">GroupElement</a><br> A complementary service for elements of a static heterogeneous collection. </dd> <dt><b>See also</b></dt> <dd><a href="AccessRootElement.html">AccessRootElement</a><br> A complementary service for the root element of a hierarchy. </dd> </dl> </td> </tr> </table> <hr> <a name="ServicesSummary"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle"> <tr> <td class="subtitle" colspan="2">Included Services - Summary</td> </tr> <tr> <td class="imsum_left"><a href="HierarchyElement.html">HierarchyElement</a></td> <td class="imsum_right"><p>is the basic service for accessing information about an element in the hierarchy. </p> </td> </tr> </table> <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/XChild.html">XChild</a></td> <td class="imsum_right"><p>provides access to the containing set object. (<a href="#XChild">details</a>)</p> </td> </tr> <tr> <td class="imsum_left">::com::sun::star::<a href="../lang/module-ix.html">lang</a>::<a href="../lang/XComponent.html">XComponent</a></td> <td class="imsum_right"><p>allows controlling or observing the lifetime of the object. (<a href="#XComponent">details</a>)</p> </td> </tr> <tr> <td class="imsum_left"><a href="XTemplateInstance.html">XTemplateInstance</a></td> <td class="imsum_right"><p>provides information about the type of the element. (<a href="#XTemplateInstance">details</a>)</p> </td> </tr> </table> <a name="ServicesDetails"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle"> <tr> <td class="subtitle" colspan="2">Included Services - Details</td> </tr> <tr/> <tr> <td class="imdetail"><a name="HierarchyElement" class="membertitle"><a href="HierarchyElement.html">HierarchyElement</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>is the basic service for accessing information about an element in the hierarchy. </dd> </dl> </td> </tr> </table> </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="XChild" class="membertitle">::com::sun::star::<a href="../container/module-ix.html">container</a>::<a href="../container/XChild.html">XChild</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>provides access to the containing set object. </dd> <dd><p>In this service, this interface is mandatory</p> <p>::com::sun::star::<a href="../container/module-ix.html">container</a>::<a href="../container/XChild.html">XChild</a>::<a href="../container/XChild.html#getParent">getParent()</a> returns <b>NULL</b>, if the object is currently not contained in a container. </p> <p>An implementation may also support ::com::sun::star::<a href="../container/module-ix.html">container</a>::<a href="../container/XChild.html">XChild</a>::<a href="../container/XChild.html#setParent">setParent()</a>. If it does, changing the parent has the effect of first removing the object from its old parent (if any) and then inserting it into the new parent (unless that is <b>NULL</b>) under the same name. The new parent must be part of the same hierarchy as the old one. The name of the object must have been set before. </p> </dd> </dl> </td> </tr> </table> </td> </tr> <tr/> <tr> <td class="imdetail"><a name="XComponent" class="membertitle">::com::sun::star::<a href="../lang/module-ix.html">lang</a>::<a href="../lang/XComponent.html">XComponent</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 controlling or observing the lifetime of the object. </dd> <dd><p>Clients may dispose of the object using ::com::sun::star::<a href="../lang/module-ix.html">lang</a>::<a href="../lang/XComponent.html">XComponent</a>::<a href="../lang/XComponent.html#dispose">dispose()</a>, only if the object is currently not contained in a container ( ::com::sun::star::<a href="../container/module-ix.html">container</a>::<a href="../container/XChild.html">XChild</a>::<a href="../container/XChild.html#getParent">getParent()</a> returns <b>NULL</b>). </p> <p>Clients may register an ::com::sun::star::<a href="../lang/module-ix.html">lang</a>::<a href="../lang/XEventListener.html">XEventListener</a> to be notified, if the object is removed from its container by an outside source. </p> </dd> </dl> </td> </tr> </table> </td> </tr> <tr/> <tr> <td class="imdetail"><a name="XTemplateInstance" class="membertitle"><a href="XTemplateInstance.html">XTemplateInstance</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>provides information about the type of the element. </dd> <dd><p>Set elements have a predetermined structure (their <em>type</em>), that is described by and can be generated from a <em>template</em>. </p> <p>If the object was created using interface ::com::sun::star::<a href="../lang/module-ix.html">lang</a>::<a href="../lang/XSingleServiceFactory.html">XSingleServiceFactory</a> on an implementation of <a href="SetUpdate.html">SetUpdate</a>, this interface describes the same template as interface <a href="XTemplateContainer.html">XTemplateContainer</a> on that <a href="SetUpdate.html">SetUpdate</a>. </p> <p>If the object was created using interface ::com::sun::star::<a href="../lang/module-ix.html">lang</a>::<a href="../lang/XMultiServiceFactory.html">XMultiServiceFactory</a> on an implementation of <a href="SetUpdate.html">SetUpdate</a>, this interface describes the template whose name was used as a service identifier for the factory method. </p> <p>Otherwise, the semantics of the information provided about the template depends on the implementation. </p> @ see com::sun::star::configuration::XTemplateContainer </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>