udkapi/com/sun/star/reflection/XProxyFactory.idl

   1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
   2 /*
   3  * This file is part of the LibreOffice project.
   4  *
   5  * This Source Code Form is subject to the terms of the Mozilla Public
   6  * License, v. 2.0. If a copy of the MPL was not distributed with this
   7  * file, You can obtain one at http://mozilla.org/MPL/2.0/.
   8  *
   9  * This file incorporates work covered by the following license notice:
  10  *
  11  *   Licensed to the Apache Software Foundation (ASF) under one or more
  12  *   contributor license agreements. See the NOTICE file distributed
  13  *   with this work for additional information regarding copyright
  14  *   ownership. The ASF licenses this file to you under the Apache
  15  *   License, Version 2.0 (the "License"); you may not use this file
  16  *   except in compliance with the License. You may obtain a copy of
  17  *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
  18  */
  19 #ifndef __com_sun_star_reflection_XProxyFactory_idl__
  20 #define __com_sun_star_reflection_XProxyFactory_idl__
  21
  22 #include <com/sun/star/uno/XInterface.idl>
  23 #include <com/sun/star/uno/XAggregation.idl>
  24
  25
  26  module com {  module sun {  module star {  module reflection {
  27
  28
  29 /** Factory interface to produce proxy objects.
  30
  31     @deprecated
  32     Aggregation will no longer be supported as a high-level concept of UNO.
  33     You may still have the option to implement an UNO object consisting of
  34     several single objects in your specific programming language, though this
  35     depends on your programming language.
  36     Thus this interface is deprecated, too.
  37 */
  38 published interface XProxyFactory: com::sun::star::uno::XInterface
  39 {
  40     /** This method creates a new proxy object that acts on behalf of the given
  41         target object.<br>
  42         The proxy delegates calls to the given target object.
  43         In addition, it is aggregatable, thus it is possible to
  44         intercept calls on the proxy's interfaces.
  45
  46         @attention
  47         The proxy object is UNO conform, but does NOT provide original target
  48         interfaces on queryInterface() calls.  This may lead to problems
  49         regarding object identity, e.g. when dealing with listener proxies.
  50
  51         @param xTarget
  52                target object
  53         @return
  54                 proxy object
  55     */
  56     com::sun::star::uno::XAggregation createProxy(
  57         [in] com::sun::star::uno::XInterface xTarget );
  58 };
  59
  60
  61 }; }; }; };
  62
  63 #endif
  64
  65 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */