offapi/com/sun/star/sdbcx/Container.idl

   1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
   2 /*************************************************************************
   3  *
   4  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   5  *
   6  * Copyright 2000, 2010 Oracle and/or its affiliates.
   7  *
   8  * OpenOffice.org - a multi-platform office productivity suite
   9  *
  10  * This file is part of OpenOffice.org.
  11  *
  12  * OpenOffice.org is free software: you can redistribute it and/or modify
  13  * it under the terms of the GNU Lesser General Public License version 3
  14  * only, as published by the Free Software Foundation.
  15  *
  16  * OpenOffice.org is distributed in the hope that it will be useful,
  17  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  18  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  19  * GNU Lesser General Public License version 3 for more details
  20  * (a copy is included in the LICENSE file that accompanied this code).
  21  *
  22  * You should have received a copy of the GNU Lesser General Public License
  23  * version 3 along with OpenOffice.org.  If not, see
  24  * <http://www.openoffice.org/license.html>
  25  * for a copy of the LGPLv3 License.
  26  *
  27  ************************************************************************/
  28 #ifndef __com_sun_star_sdbcx_Container_idl__
  29 #define __com_sun_star_sdbcx_Container_idl__
  30
  31  module com {  module sun {  module star {  module container {
  32  published interface XNameAccess;
  33  published interface XIndexAccess;
  34  published interface XEnumerationAccess;
  35 };};};};
  36
  37  module com {  module sun {  module star {  module util {
  38  published interface XRefreshable;
  39 };};};};
  40
  41  module com {  module sun {  module star {  module sdbcx {
  42
  43  published interface XDataDescriptorFactory;
  44  published interface XAppend;
  45  published interface XDrop;
  46
  47
  48 /** describes every container which is used for data definition. Each
  49     container must support access to its elements by the element's name or
  50     by the element's position.
  51
  52     <p>
  53     Simple enumeration must be supported as well.
  54     </p>
  55     <p>
  56     To reflect the changes with the underlying database, a refresh mechanism
  57     needs to be supported.
  58     </p>
  59     <p>
  60     A container may support the possibility to add new elements or to drop
  61     existing elements. Additions are always done by descriptors which define the
  62     properties of the new element.
  63     </p>
  64  */
  65 published service Container
  66 {
  67     // gives access to the elements by name.
  68     interface com::sun::star::container::XNameAccess;
  69
  70     // gives access to the elements by index.
  71     interface com::sun::star::container::XIndexAccess;
  72
  73     // used to create an enumeration of the elements.
  74     interface com::sun::star::container::XEnumerationAccess;
  75
  76
  77     /** is optional for implementation. Used to reflect changes.
  78      */
  79     [optional] interface com::sun::star::util::XRefreshable;
  80
  81     /** optional for implementation. Allows to create descriptor elements which then could be used to append new elements.
  82      */
  83     [optional] interface XDataDescriptorFactory;
  84
  85     /** optional for implementation, provides the possibility of adding
  86                 a new element to the container.
  87      */
  88     [optional] interface XAppend;
  89
  90     /** optional for implementation, provides the possibility of dropping
  91                 an element from the container.
  92      */
  93     [optional] interface XDrop;
  94 };
  95
  96 //=============================================================================
  97
  98 }; }; }; };
  99
 100 /*===========================================================================
 101 ===========================================================================*/
 102 #endif
 103
 104 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */