<html> <head> <title>Service ConfigurationUpdateAccess</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="ConfigurationUpdateAccess-xref.html" class="navimain">Use</a></td> <td class="navimain"><a href="#devmanual" 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"><a href="#ServicesSummary" class="navisub">Services' Summary</a></td> <td class="navisub">Interfaces' Summary</td> <td class="navisub">Properties' Summary</td> <td class="navisub"><a href="#ServicesDetails" class="navisub">Services' Details</a></td> <td class="navisub">Interfaces' Details</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 ConfigurationUpdateAccess</td> </tr> <tr> <td><dl> <dt><b>Description</b></dt> <dd>provides modifying access to a fragment of the configuration hierarchy. </dd> <dd><p>Extends <a href="ConfigurationAccess.html">ConfigurationAccess</a> to support modifying values or inserting and removing elements. </p> <p>Descendants of this service also implement this service unless they are marked <em>read-only</em> (which is indicated by attribute <b>PropertyAttribute::READONLY</b>), in which case they only need implement <a href="ConfigurationAccess.html">ConfigurationAccess</a>. </p> <p>The classification of implementations that is described for <a href="ConfigurationAccess.html">ConfigurationAccess</a> applies to implementations of this service as well. Therefore an implementation will support one of several alternate services describing its <em>Container</em> role and one of several alternate services describing its <em>Element</em> role. These services are extensions of the respective services documented for <a href="ConfigurationAccess.html">ConfigurationAccess</a>. </p> <ul> <li><em>Container</em> role: A <em>group</em> permits changing child values. A <em>set</em> permits inserting and removing contained elements. </li> <li><em>Element</em> role: The root element of a modifiable tree provides extended functionality to control processing of changes for the entire tree (fragment) by supporting ::com::sun::star::<a href="../util/module-ix.html">util</a>::<a href="../util/XChangesBatch.html">XChangesBatch</a>. For elements of a <em>set</em> or a <em>group</em> no additional interfaces are supported. </li> </ul> </dd> <dt><b>See also</b></dt> <dd><a href="ConfigurationProvider.html">ConfigurationProvider</a><br> Root instances of this service can be requested from a <a href="ConfigurationProvider.html">ConfigurationProvider</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/WritingUNO/Disable_Commands#Disabling_Commands_at_Runtime">WritingUNO - Disable Commands - Disabling Commands at Runtime</a></dd> <dd><a href="http://wiki.services.openoffice.org/wiki/Documentation/DevGuide/Config/Object_Model">Config - Object Model</a></dd> <dd><a href="http://wiki.services.openoffice.org/wiki/Documentation/DevGuide/Config/Updating_Configuration_Data">Config - Updating Configuration Data</a></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="ConfigurationAccess.html">ConfigurationAccess</a></td> <td class="imsum_right"><p>is the basic service providing read access to an element of the configuration hierarchy and its child and descendent elements. (<a href="#ConfigurationAccess">details</a>)</p> </td> </tr> <tr> <td class="imsum_left"><a href="SetUpdate.html">SetUpdate</a></td> <td class="imsum_right"><p>specializes <a href="SetAccess.html">SetAccess</a> to support modifying the element. (<a href="#SetUpdate">details</a>)</p> </td> </tr> <tr> <td class="imsum_left"><a href="GroupUpdate.html">GroupUpdate</a></td> <td class="imsum_right"><p>specializes <a href="GroupAccess.html">GroupAccess</a> to support modifying contained data. (<a href="#GroupUpdate">details</a>)</p> </td> </tr> <tr> <td class="imsum_left"><a href="UpdateRootElement.html">UpdateRootElement</a></td> <td class="imsum_right"><p>specializes <a href="AccessRootElement.html">AccessRootElement</a> to support transaction-like control over a batch of changes accumulated within the tree fragment. (<a href="#UpdateRootElement">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="ConfigurationAccess" class="membertitle"><a href="ConfigurationAccess.html">ConfigurationAccess</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 an element of the configuration hierarchy and its child and descendent elements. </dd> <dd><p>The <a href="HierarchyAccess.html">HierarchyAccess</a> specialization implemented will be further specialized to support modifying access. Implementations shall therefore implement one of <a href="SetUpdate.html">SetUpdate</a> or <a href="GroupUpdate.html">GroupUpdate</a> depending on the <em>Container</em> role. </p> <p>If the <a href="HierarchyElement.html">HierarchyElement</a> specialization that is implemented is <a href="AccessRootElement.html">AccessRootElement</a>, the implementation must support the extended functionality of <a href="UpdateRootElement.html">UpdateRootElement</a>. Otherwise, there are no new requirements mandated by the <em>Element</em> role. </p> </dd> </dl> </td> </tr> </table> </td> </tr> <tr/> <tr> <td class="imdetail"><a name="SetUpdate" class="membertitle"><a href="SetUpdate.html">SetUpdate</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>specializes <a href="SetAccess.html">SetAccess</a> to support modifying the element. </dd> <dd><p>Implemented, if this element is a <em>Set</em>. Otherwise service <a href="GroupUpdate.html">GroupUpdate</a> is provided. </p> </dd> </dl> </td> </tr> </table> </td> </tr> <tr/> <tr> <td class="imdetail"><a name="GroupUpdate" class="membertitle"><a href="GroupUpdate.html">GroupUpdate</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>specializes <a href="GroupAccess.html">GroupAccess</a> to support modifying contained data. </dd> <dd><p>Implemented, if this element is a <em>Group</em>. Otherwise service <a href="SetUpdate.html">SetUpdate</a> is provided. </p> </dd> </dl> </td> </tr> </table> </td> </tr> <tr/> <tr> <td class="imdetail"><a name="UpdateRootElement" class="membertitle"><a href="UpdateRootElement.html">UpdateRootElement</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>specializes <a href="AccessRootElement.html">AccessRootElement</a> to support transaction-like control over a batch of changes accumulated within the tree fragment. </dd> <dd><p>Implemented, if this element is the <em>Root</em> of the whole hierarchy. Otherwise either <a href="SetElement.html">SetElement</a> or <a href="GroupElement.html">GroupElement</a> is provided. </p> </dd> <dt><b>See also</b></dt> <dd><a href="ConfigurationProvider.html">ConfigurationProvider</a><br> Instances obtained from a <a href="ConfigurationProvider.html">ConfigurationProvider</a> will implement this version of <a href="HierarchyElement.html">HierarchyElement</a>. </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 © 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>
