diff options
-rw-r--r-- | offapi/com/sun/star/frame/ProtocolHandler.idl | 41 |
1 files changed, 19 insertions, 22 deletions
diff --git a/offapi/com/sun/star/frame/ProtocolHandler.idl b/offapi/com/sun/star/frame/ProtocolHandler.idl index dcb3d22d8417..0183703fa098 100644 --- a/offapi/com/sun/star/frame/ProtocolHandler.idl +++ b/offapi/com/sun/star/frame/ProtocolHandler.idl @@ -2,9 +2,9 @@ * * $RCSfile: ProtocolHandler.idl,v $ * - * $Revision: 1.4 $ + * $Revision: 1.5 $ * - * last change: $Author: as $ $Date: 2002-09-04 10:05:47 $ + * last change: $Author: as $ $Date: 2002-09-04 11:53:26 $ * * The Contents of this file are made available subject to the terms of * either of the following licenses @@ -86,6 +86,23 @@ defintion and implementation. The generic dispatch provider will use <protocol scheme> to detect right handler only. </p> + + <p> + Sometimes it can be usefull for a handler object, to know something about the + environment, in which it runs - especily the frame. For this case the generic + code, which search and instanciate the protocol handler, will call createInstanceWithArguments() + at the uno factory to create the service. It depends then from the handler implementation, how it get these data. + Following parameters are passed to the service: + <ul> + <li>sequence< any >[0] => the frame for which this ProtocolHandler was created [com.sun.star.frame.XFrame]</li> + </ul> + </p> + + <p> + Please note: if this mechanism is used it seams not usefull (nor possible) to implement a ProtocolHandler + as a singleton. Otherwhise the implementation can't distinguish between different environments + and her corresponding dispatch requests. + </p> */ service ProtocolHandler { @@ -99,26 +116,6 @@ service ProtocolHandler </p> */ interface XDispatchProvider; - - //------------------------------------------------------------------------- - /** used to set the environment on this handler - - <p> - Sometimes it can be usefull for a dispatch object, to know something about the - environment, in which it runs - especily the frame. Then this optional interface - has to be implemented. Following parameters are passed due to this interface inside the given array of any values: - <ul> - <li>sequence< any >[0] => the frame for which this ProtocolHandler was created [com.sun.star.frame.XFrame]</li> - </ul> - </p> - - <p> - Please note: if this mechanism is used it seams not usefull (nor possible) to implement a ProtocolHandler - as a singleton. Otherwhise the implementation can't distinguish between different environments - and her corresponding dispatch requests. - </p> - */ - [optional] interface com::sun::star::lang::XInitialization; }; //============================================================================= |