udkapi/com/sun/star/script/XScriptEventsAttacher.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
  22  module com {  module sun {  module star {  module script {
  23
  24
  25 /**
  26     This interface can be used to attach script events to a number of
  27     objects that give access to the definition of events that should
  28     be attached to them, e.g., by supporting XEventsSupplier
  29 */
  30 published interface XScriptEventsAttacher: com::sun::star::uno::XInterface
  31 {
  32     /**
  33         Attaches the events defined by XScriptEventsSupplier to the
  34         corresponding object implementing XScriptEventsSupplier.
  35
  36         @param Objects
  37                             Sequence of all objects. Usually the objects should directly
  38                             support XScriptEventsAttacher to define the events
  39                             but this is not strictly required. It's also possible that
  40                             the object implementing XScriptEventsAttacher
  41                             knows how to get the necessary information for the objects.
  42         @param xListener
  43                             All events (if defined by XScriptEventsSupplier) that are fired
  44                             by one of the objects are mapped into a ScriptEvent
  45                             and passed to the methods of this XScriptListener.
  46         @param Helper
  47                             Helper object for the implementation. This value will be
  48                             passed to the XScriptListener as Helper property in the
  49                             ScriptEvent.
  50     */
  51     void attachEvents(  [in] sequence< com::sun::star::uno::XInterface > Objects,
  52                         [in] com::sun::star::script::XScriptListener xListener,
  53                         [in] any Helper )
  54             raises( com::sun::star::lang::IllegalArgumentException,
  55                     com::sun::star::beans::IntrospectionException,
  56                     com::sun::star::script::CannotCreateAdapterException,
  57                     com::sun::star::lang::ServiceNotRegisteredException );
  58
  59 };
  60
  61
  62 }; }; }; };
  63
  64 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */