offapi/com/sun/star/frame/SynchronousFrameLoader.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 frame {
  22
  23 /** derivations of this abstract service are used to load components
  24     into Frames of the environment
  25
  26     <p>
  27     Concrete implementations of this service register, for example,
  28     for file name extensions or MIME types to load appropriate
  29     components. The components loaded are at least Controller.
  30     Instead of service FrameLoader this one use synchronous
  31     processes to load the component.
  32     </p>
  33
  34     @see FrameLoader
  35  */
  36 published service SynchronousFrameLoader
  37 {
  38     /** support synchronous loading of component
  39      */
  40     interface XSynchronousFrameLoader;
  41
  42     /** support initialization of loader with its own configuration!
  43
  44         <p>
  45         Concrete implementations should use it to get her own configuration data
  46         directly after creation by the FrameLoaderFactory.
  47         Otherwise they must use normal configuration API to do so.
  48         </p>
  49      */
  50     [optional] interface com::sun::star::lang::XInitialization;
  51
  52     /** provides access to the internal name of this frame loader
  53
  54         <p>
  55         The internal name is a part of his configuration and will be passed by
  56         the FrameLoaderFactory after creation
  57         if optional interface com::sun::star::lang::XInitialization
  58         is supported. Value of function com::sun::star::container::XNamed::getName() can be
  59         used on service FrameLoaderFactory to get further information about this loader.
  60         Setting of this name by calling com::sun::star::container::XNamed::setName() must be
  61         forwarded to same factory service. He should decide, if it's allowed or not.
  62         The reason: prevent code against name ambiguities.
  63         </p>
  64      */
  65      [optional] interface com::sun::star::container::XNamed;
  66 };
  67
  68
  69 }; }; }; };
  70
  71 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */