<html> <head> <title>Service GroupAccess</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="GroupAccess-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 GroupAccess</td> </tr> <tr> <td><dl> <dt><b>Description</b></dt> <dd>provides access to a predefined heterogeneous group of values and nested trees as part of a hierarchy. </dd> <dd><p>Provides access to, and information about, its children and descendants viewed either as properties or as contained elements. </p> <p><em>Groups</em> are static collections within the hierarchy.</p> <p>The number and names of contained elements are fixed in advance and each child may have a different type. </p> <p>This service subsumes two alternate ways of accessing child and descendent elements. These strongly overlap, supporting the basic identity <code>xGroup.getPropertyValue( aName ) == xGroup.getByName( aName )</code>. </p> </dd> <dt><b>See also</b></dt> <dd><a href="GroupElement.html">GroupElement</a><br> Child objects of this service generally implement service GroupElement. </dd> <dt><b>See also</b></dt> <dd><a href="SetAccess.html">SetAccess</a><br> A complementary service providing for dynamic homogeneous sets of elements. </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="HierarchyAccess.html">HierarchyAccess</a></td> <td class="imsum_right"><p>is the basic service for accessing child and descendent nodes using a view of the tree as a container of values and structuring elements. </p> </td> </tr> <tr> <td class="imsum_left"><a href="PropertyHierarchy.html">PropertyHierarchy</a></td> <td class="imsum_right"><p>is the basic service for accessing child and descendent nodes using a view of the tree as a hierarchy of properties and subproperties. (<a href="#PropertyHierarchy">details</a>)</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="../beans/module-ix.html">beans</a>::<a href="../beans/XPropertyState.html">XPropertyState</a></td> <td class="imsum_right"><p>provides access to the state of child elements of an implementation. [optional] (<a href="#XPropertyState">details</a>)</p> </td> </tr> <tr> <td class="imsum_left">::com::sun::star::<a href="../beans/module-ix.html">beans</a>::<a href="../beans/XMultiPropertyStates.html">XMultiPropertyStates</a></td> <td class="imsum_right"><p>provides access to the states of multiple child elements of an implementation. [optional] (<a href="#XMultiPropertyStates">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="HierarchyAccess" class="membertitle"><a href="HierarchyAccess.html">HierarchyAccess</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 child and descendent nodes using a view of the tree as a container of values and structuring elements. </dd> </dl> </td> </tr> </table> </td> </tr> <tr/> <tr> <td class="imdetail"><a name="PropertyHierarchy" class="membertitle"><a href="PropertyHierarchy.html">PropertyHierarchy</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 child and descendent nodes using a view of the tree as a hierarchy of properties and subproperties. </dd> <dd><p>This view is meaningful only for a static fragment of the hierarchy Objects' properties may change, but not which properties they have. Therefore, dynamic elements of the hierarchy (see <a href="SetAccess.html">SetAccess</a>) do not implement service <a href="PropertyHierarchy.html">PropertyHierarchy</a>. </p> <p>If such elements occur as properties or subproperties of an implementation, it is not specified whether direct subproperty access using ::com::sun::star::<a href="../beans/module-ix.html">beans</a>::<a href="../beans/XHierarchicalPropertySet.html">XHierarchicalPropertySet</a> or ::com::sun::star::<a href="../beans/module-ix.html">beans</a>::<a href="../beans/XMultiHierarchicalPropertySet.html">XMultiHierarchicalPropertySet</a> can be used to access descendants of such elements. </p> <p>Similarly, information about such descendants may not be available from the ::com::sun::star::<a href="../beans/module-ix.html">beans</a>::<a href="../beans/XHierarchicalPropertySetInfo.html">XHierarchicalPropertySetInfo</a> the implementation provides. </p> <p>If an implementation is part of a <em>read-only</em> view of the hierarchy, all properties and subproperties will be reported as having attribute <b>PropertyAttribute::READONLY</b> set, and attempts to change property values will fail. </p> </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="XPropertyState" class="membertitle">::com::sun::star::<a href="../beans/module-ix.html">beans</a>::<a href="../beans/XPropertyState.html">XPropertyState</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>provides access to the state of child elements of an implementation. [optional] </dd> <dd><p>This interface should be present, if the hierarchy supports default values for simple (non-object) properties and the group contains such properties. </p> <p>For properties that are objects themselves, the semantic documented for service <a href="HierarchyAccess.html">HierarchyAccess</a> applies. </p> </dd> </dl> </td> </tr> </table> </td> </tr> <tr/> <tr> <td class="imdetail"><a name="XMultiPropertyStates" class="membertitle">::com::sun::star::<a href="../beans/module-ix.html">beans</a>::<a href="../beans/XMultiPropertyStates.html">XMultiPropertyStates</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>provides access to the states of multiple child elements of an implementation. [optional] </dd> <dd><p>This interface should be present, if the hierarchy supports default values for simple (non-object) properties and the group contains such properties. </p> <p>For properties that are objects themselves, the semantic documented for service <a href="HierarchyAccess.html">HierarchyAccess</a> applies. </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>