1*cdf0e10cSrcweir/************************************************************************* 2*cdf0e10cSrcweir * 3*cdf0e10cSrcweir * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4*cdf0e10cSrcweir * 5*cdf0e10cSrcweir * Copyright 2000, 2010 Oracle and/or its affiliates. 6*cdf0e10cSrcweir * 7*cdf0e10cSrcweir * OpenOffice.org - a multi-platform office productivity suite 8*cdf0e10cSrcweir * 9*cdf0e10cSrcweir * This file is part of OpenOffice.org. 10*cdf0e10cSrcweir * 11*cdf0e10cSrcweir * OpenOffice.org is free software: you can redistribute it and/or modify 12*cdf0e10cSrcweir * it under the terms of the GNU Lesser General Public License version 3 13*cdf0e10cSrcweir * only, as published by the Free Software Foundation. 14*cdf0e10cSrcweir * 15*cdf0e10cSrcweir * OpenOffice.org is distributed in the hope that it will be useful, 16*cdf0e10cSrcweir * but WITHOUT ANY WARRANTY; without even the implied warranty of 17*cdf0e10cSrcweir * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 18*cdf0e10cSrcweir * GNU Lesser General Public License version 3 for more details 19*cdf0e10cSrcweir * (a copy is included in the LICENSE file that accompanied this code). 20*cdf0e10cSrcweir * 21*cdf0e10cSrcweir * You should have received a copy of the GNU Lesser General Public License 22*cdf0e10cSrcweir * version 3 along with OpenOffice.org. If not, see 23*cdf0e10cSrcweir * <http://www.openoffice.org/license.html> 24*cdf0e10cSrcweir * for a copy of the LGPLv3 License. 25*cdf0e10cSrcweir * 26*cdf0e10cSrcweir ************************************************************************/ 27*cdf0e10cSrcweir 28*cdf0e10cSrcweir#ifndef __com_sun_star_sheet_DataPilotFieldGroups_idl__ 29*cdf0e10cSrcweir#define __com_sun_star_sheet_DataPilotFieldGroups_idl__ 30*cdf0e10cSrcweir 31*cdf0e10cSrcweir#ifndef __com_sun_star_container_XNameContainer_idl__ 32*cdf0e10cSrcweir#include <com/sun/star/container/XNameContainer.idl> 33*cdf0e10cSrcweir#endif 34*cdf0e10cSrcweir#ifndef __com_sun_star_container_XEnumerationAccess_idl__ 35*cdf0e10cSrcweir#include <com/sun/star/container/XEnumerationAccess.idl> 36*cdf0e10cSrcweir#endif 37*cdf0e10cSrcweir#ifndef __com_sun_star_container_XIndexAccess_idl__ 38*cdf0e10cSrcweir#include <com/sun/star/container/XIndexAccess.idl> 39*cdf0e10cSrcweir#endif 40*cdf0e10cSrcweir 41*cdf0e10cSrcweir//============================================================================= 42*cdf0e10cSrcweir 43*cdf0e10cSrcweirmodule com { module sun { module star { module sheet { 44*cdf0e10cSrcweir 45*cdf0e10cSrcweir//============================================================================= 46*cdf0e10cSrcweir 47*cdf0e10cSrcweir/** represents a collection of groups in a data pilot field. 48*cdf0e10cSrcweir 49*cdf0e10cSrcweir <p>The members of this collection are instances of <type>DataPilotFieldGroup</type> 50*cdf0e10cSrcweir containing the names of all items in the group.</p> 51*cdf0e10cSrcweir 52*cdf0e10cSrcweir @see DataPilotField 53*cdf0e10cSrcweir @see DataPilotFieldGroup 54*cdf0e10cSrcweir @see DataPilotFieldGroupInfo 55*cdf0e10cSrcweir */ 56*cdf0e10cSrcweirpublished service DataPilotFieldGroups 57*cdf0e10cSrcweir{ 58*cdf0e10cSrcweir //------------------------------------------------------------------------- 59*cdf0e10cSrcweir 60*cdf0e10cSrcweir /** provides access to the data pilot field groups in the collection via 61*cdf0e10cSrcweir index. 62*cdf0e10cSrcweir */ 63*cdf0e10cSrcweir interface com::sun::star::container::XIndexAccess; 64*cdf0e10cSrcweir 65*cdf0e10cSrcweir //------------------------------------------------------------------------- 66*cdf0e10cSrcweir 67*cdf0e10cSrcweir /** creates an enumeration of all data pilot field groups. 68*cdf0e10cSrcweir 69*cdf0e10cSrcweir @see DataPilotFieldGroupsEnumeration 70*cdf0e10cSrcweir */ 71*cdf0e10cSrcweir interface com::sun::star::container::XEnumerationAccess; 72*cdf0e10cSrcweir 73*cdf0e10cSrcweir //------------------------------------------------------------------------- 74*cdf0e10cSrcweir 75*cdf0e10cSrcweir /** provides access to the data pilot field groups in the collection via 76*cdf0e10cSrcweir name. 77*cdf0e10cSrcweir */ 78*cdf0e10cSrcweir interface com::sun::star::container::XNameAccess; 79*cdf0e10cSrcweir 80*cdf0e10cSrcweir //------------------------------------------------------------------------- 81*cdf0e10cSrcweir 82*cdf0e10cSrcweir /** provides read/write access to the data pilot field groups in the 83*cdf0e10cSrcweir collection via name. 84*cdf0e10cSrcweir 85*cdf0e10cSrcweir <p>The <type scope="com::sun::star::container">XNameContainer</type> 86*cdf0e10cSrcweir and <type scope="com::sun::star::container">XNameReplace</type> 87*cdf0e10cSrcweir interfaces can be used to manage the item groups. It is possible to 88*cdf0e10cSrcweir insert, remove, and replace item groups.</p> 89*cdf0e10cSrcweir 90*cdf0e10cSrcweir <p>The method <member scope="com::sun::star::container"> 91*cdf0e10cSrcweir XNameReplace::replaceByName</member> can be used to replace the item 92*cdf0e10cSrcweir names in an existing group with a new collection of item names. An 93*cdf0e10cSrcweir implementation should support the following data types: 94*cdf0e10cSrcweir 95*cdf0e10cSrcweir <ul> 96*cdf0e10cSrcweir <li>an empty <atom>any</atom> to remove all items and leave the 97*cdf0e10cSrcweir group empty. The group can be filled later with new item names.</li> 98*cdf0e10cSrcweir <li>a <atom dim="[]">string</atom> containing all item names that will 99*cdf0e10cSrcweir be part of the group.</li> 100*cdf0e10cSrcweir <li>an object supporting <type scope="com::sun::star::container"> 101*cdf0e10cSrcweir XIndexAccess</type> containing elements that provide an item name per 102*cdf0e10cSrcweir element via the interface <type scope="com::sun::star::container"> 103*cdf0e10cSrcweir XNamed</type>, for example an instance of <type>DataPilotFieldGroup 104*cdf0e10cSrcweir </type>.</li> 105*cdf0e10cSrcweir </ul></p> 106*cdf0e10cSrcweir 107*cdf0e10cSrcweir <p>The method <member scope="com::sun::star::container"> 108*cdf0e10cSrcweir XNameContainer::insertByName</member> can be used to insert a new 109*cdf0e10cSrcweir field group with the passed collection of item names. An 110*cdf0e10cSrcweir implementation should support the same data types as described above 111*cdf0e10cSrcweir for the method <member scope="com::sun::star::container"> 112*cdf0e10cSrcweir XNameReplace::replaceByName</member>.</p> 113*cdf0e10cSrcweir 114*cdf0e10cSrcweir <p>The method <member scope="com::sun::star::container"> 115*cdf0e10cSrcweir XNameContainer::removeByName</member> can be used to remove an 116*cdf0e10cSrcweir existing field group.</p> 117*cdf0e10cSrcweir */ 118*cdf0e10cSrcweir [optional] interface com::sun::star::container::XNameContainer; 119*cdf0e10cSrcweir 120*cdf0e10cSrcweir}; 121*cdf0e10cSrcweir 122*cdf0e10cSrcweir//============================================================================= 123*cdf0e10cSrcweir 124*cdf0e10cSrcweir}; }; }; }; 125*cdf0e10cSrcweir 126*cdf0e10cSrcweir#endif 127*cdf0e10cSrcweir 128