<html> <head> <title>Service SimpleSetUpdate</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="SimpleSetUpdate-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 SimpleSetUpdate</td> </tr> <tr> <td><dl> <dt><b>Description</b></dt> <dd>provides write access to a dynamic, homogeneous, non-hierarchical set of values or objects. </dd> <dd><p>Allows adding and removing elements. Helps create new elements to be added. </p> <p>This service extends <a href="SimpleSetAccess.html">SimpleSetAccess</a> to support modifying the container. Any child objects shall in turn support modifying access. </p> </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="SimpleSetAccess.html">SimpleSetAccess</a></td> <td class="imsum_right"><p>is the basic service providing read access to a (not necessarily hierarchical) <em>set</em>. </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/XNameContainer.html">XNameContainer</a></td> <td class="imsum_right"><p>allows inserting, removing, and replacing elements. (<a href="#XNameContainer">details</a>)</p> </td> </tr> <tr> <td class="imsum_left">::com::sun::star::<a href="../lang/module-ix.html">lang</a>::<a href="../lang/XSingleServiceFactory.html">XSingleServiceFactory</a></td> <td class="imsum_right"><p>allows creating an object that can be inserted into this set. [conditional] (<a href="#XSingleServiceFactory">details</a>)</p> </td> </tr> <tr> <td class="imsum_left">::com::sun::star::<a href="../lang/module-ix.html">lang</a>::<a href="../lang/XMultiServiceFactory.html">XMultiServiceFactory</a></td> <td class="imsum_right"><p>allows creating various objects that can be inserted into this set. [optional] (<a href="#XMultiServiceFactory">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="SimpleSetAccess" class="membertitle"><a href="SimpleSetAccess.html">SimpleSetAccess</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 providing read access to a (not necessarily hierarchical) <em>set</em>. </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="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 inserting, removing, and replacing elements. </dd> <dd><p>This interface extends the interface ::com::sun::star::<a href="../container/module-ix.html">container</a>::<a href="../container/XNameAccess.html">XNameAccess</a> supported by service <a href="SimpleSetAccess.html">SimpleSetAccess</a> to allow modifying the container. </p> <p>If available, changes can be observed by registering a listener with interface ::com::sun::star::<a href="../container/module-ix.html">container</a>::<a href="../container/XContainer.html">XContainer</a>. </p> <p>If the elements of this set are of simple type (the type returned by ::com::sun::star::<a href="../container/module-ix.html">container</a>::<a href="../container/XElementAccess.html">XElementAccess</a>::<a href="../container/XElementAccess.html#getElementType">getElementType()</a> is not an interface type), then values of that type can directly be passed to ::com::sun::star::<a href="../container/module-ix.html">container</a>::<a href="../container/XNameContainer.html">XNameContainer</a>::<a href="../container/XNameContainer.html#insertByName">insertByName()</a> and ::com::sun::star::<a href="../container/module-ix.html">container</a>::<a href="../container/XNameContainer.html">XNameContainer</a>::<a href="../container/XNameContainer.html#replaceByName">replaceByName()</a>. </p> <p>Otherwise new elements have to be constructed to match the type prescribed by the element template of this set. Such elements can be created using interfaces ::com::sun::star::<a href="../lang/module-ix.html">lang</a>::<a href="../lang/XSingleServiceFactory.html">XSingleServiceFactory</a> and, if supported, ::com::sun::star::<a href="../lang/module-ix.html">lang</a>::<a href="../lang/XMultiServiceFactory.html">XMultiServiceFactory</a>. </p> <p>Objects to be inserted must not be contained in any set at the time of insertion. ::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> must return <b>NULL</b>. If a name had been assigned to the object prior to insertion (using ::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> or by other means), this name is ignored and will be lost. After insertion the name of the object is the name that was used as argument to ::com::sun::star::<a href="../container/module-ix.html">container</a>::<a href="../container/XNameContainer.html">XNameContainer</a>::<a href="../container/XNameContainer.html#insertByName">insertByName()</a> or ::com::sun::star::<a href="../container/module-ix.html">container</a>::<a href="../container/XNameContainer.html">XNameContainer</a>::<a href="../container/XNameContainer.html#replaceByName">replaceByName()</a>. </p> <p>Objects that are removed using ::com::sun::star::<a href="../container/module-ix.html">container</a>::<a href="../container/XNameContainer.html">XNameContainer</a>::<a href="../container/XNameContainer.html#removeByName">removeByName()</a> or replaced using ::com::sun::star::<a href="../container/module-ix.html">container</a>::<a href="../container/XNameContainer.html">XNameContainer</a>::<a href="../container/XNameContainer.html#replaceByName">replaceByName()</a> remain valid and can be reinserted into a set supporting the same template and even under a different name. </p> <p>An implementation need not support insertion of objects that were not obtained in one of the ways described above. If it does, the implementation must reject elements that do not have the correct structure as described by the template. </p> </dd> </dl> </td> </tr> </table> </td> </tr> <tr/> <tr> <td class="imdetail"><a name="XSingleServiceFactory" class="membertitle">::com::sun::star::<a href="../lang/module-ix.html">lang</a>::<a href="../lang/XSingleServiceFactory.html">XSingleServiceFactory</a></a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center"> <tr> <td><dl> <dt><b>Usage Restrictions</b></dt> <dd><i>optional</i></dd> <dt><b>Description</b></dt> <dd>allows creating an object that can be inserted into this set. [conditional] </dd> <dd><p>This interface shall be implemented by an implementation, if and only if the element type of the set, as returned by ::com::sun::star::<a href="../container/module-ix.html">container</a>::<a href="../container/XElementAccess.html">XElementAccess</a>::<a href="../container/XElementAccess.html#getElementType">getElementType()</a>, is an object type, such as an interface. </p> <p>Using ::com::sun::star::<a href="../lang/module-ix.html">lang</a>::<a href="../lang/XSingleServiceFactory.html">XSingleServiceFactory</a>::<a href="../lang/XSingleServiceFactory.html#createInstance">createInstance()</a> an instance of the element template of this set is created. If the set supports multiple templates or variations of the basic template, a default variant of the basic template is instantiated. If an implementation supports variations, they may be specified by passing arguments to ::com::sun::star::<a href="../lang/module-ix.html">lang</a>::<a href="../lang/XSingleServiceFactory.html">XSingleServiceFactory</a>::<a href="../lang/XSingleServiceFactory.html#createInstanceWithArguments">createInstanceWithArguments()</a>. There are no predefined arguments for all versions of this service. </p> <p>The object created is not contained in the set and does not have a name yet. It may subsequently be inserted into the set and named using ::com::sun::star::<a href="../container/module-ix.html">container</a>::<a href="../container/XNameContainer.html">XNameContainer</a>::<a href="../container/XNameContainer.html#insertByName">insertByName()</a> or ::com::sun::star::<a href="../container/module-ix.html">container</a>::<a href="../container/XNameContainer.html">XNameContainer</a>::<a href="../container/XNameContainer.html#replaceByName">replaceByName()</a>. </p> </dd> </dl> </td> </tr> </table> </td> </tr> <tr/> <tr> <td class="imdetail"><a name="XMultiServiceFactory" class="membertitle">::com::sun::star::<a href="../lang/module-ix.html">lang</a>::<a href="../lang/XMultiServiceFactory.html">XMultiServiceFactory</a></a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center"> <tr> <td><dl> <dt><b>Usage Restrictions</b></dt> <dd><i>optional</i></dd> <dt><b>Description</b></dt> <dd>allows creating various objects that can be inserted into this set. [optional] </dd> <dd><p>This interface may be implemented by an implementation of service SetUpdate to support creating elements from other than the basic element template. An example of this would be an implementation that supports inheritance, allowing the use of templates derived from the basic template by extension. </p> <p>This interface may only be implemented if the element type of the set (as returned by ::com::sun::star::<a href="../container/module-ix.html">container</a>::<a href="../container/XElementAccess.html">XElementAccess</a>::<a href="../container/XElementAccess.html#getElementType">getElementType()</a>) is an object type, such as an interface. An implementation should also implement interface <a href="XTemplateContainer.html">XTemplateContainer</a> which is optional in this service. </p> <p>The service identifier argument passed to ::com::sun::star::<a href="../lang/module-ix.html">lang</a>::<a href="../lang/XMultiServiceFactory.html">XMultiServiceFactory</a>::<a href="../lang/XMultiServiceFactory.html#createInstance">createInstance()</a> or ::com::sun::star::<a href="../lang/module-ix.html">lang</a>::<a href="../lang/XMultiServiceFactory.html">XMultiServiceFactory</a>::<a href="../lang/XMultiServiceFactory.html#createInstanceWithArguments">createInstanceWithArguments()</a> names the template to be instantiated or otherwise identifies the structure to be built. The implementation must at least support using the template name obtained from <a href="XTemplateContainer.html">XTemplateContainer</a>::<a href="XTemplateContainer.html#getElementTemplateName">getElementTemplateName()</a> as a service identifier, in which case the result shall be the same as if the corresponding member of ::com::sun::star::<a href="../lang/module-ix.html">lang</a>::<a href="../lang/XSingleServiceFactory.html">XSingleServiceFactory</a> had been called. </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>
distrib
>
Mandriva
>
current
>
i586
>
media
>
main-updates
>
by-pkgid
>
fc480f9d5aabed8eeaffe8ad3401a94c
>
files
>
1937
