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
  20
  21  module com {  module sun {  module star {  module reflection {
  22
  23
  24 /** Factory interface to produce proxy objects.
  25
  26     @deprecated
  27     Aggregation will no longer be supported as a high-level concept of UNO.
  28     You may still have the option to implement a UNO object consisting of
  29     several single objects in your specific programming language, though this
  30     depends on your programming language.
  31     Thus this interface is deprecated, too.
  32 */
  33 published interface XProxyFactory: com::sun::star::uno::XInterface
  34 {
  35     /** This method creates a new proxy object that acts on behalf of the given
  36         target object.<br>
  37         The proxy delegates calls to the given target object.
  38         In addition, it is aggregatable, thus it is possible to
  39         intercept calls on the proxy's interfaces.
  40
  41         @attention
  42         The proxy object is UNO conform, but does NOT provide original target
  43         interfaces on queryInterface() calls.  This may lead to problems
  44         regarding object identity, e.g. when dealing with listener proxies.
  45
  46         @param xTarget
  47                target object
  48         @return
  49                 proxy object
  50     */
  51     com::sun::star::uno::XAggregation createProxy(
  52         [in] com::sun::star::uno::XInterface xTarget );
  53 };
  54
  55
  56 }; }; }; };
  57
  58 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */