Update ooo320-m1
[ooovba.git] / offapi / com / sun / star / plugin / XPluginContext.idl
blobe6b34ebbb0461f33b418848578056644297de07b
1 /*************************************************************************
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
5 * Copyright 2008 by Sun Microsystems, Inc.
7 * OpenOffice.org - a multi-platform office productivity suite
9 * $RCSfile: XPluginContext.idl,v $
10 * $Revision: 1.9 $
12 * This file is part of OpenOffice.org.
14 * OpenOffice.org is free software: you can redistribute it and/or modify
15 * it under the terms of the GNU Lesser General Public License version 3
16 * only, as published by the Free Software Foundation.
18 * OpenOffice.org is distributed in the hope that it will be useful,
19 * but WITHOUT ANY WARRANTY; without even the implied warranty of
20 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21 * GNU Lesser General Public License version 3 for more details
22 * (a copy is included in the LICENSE file that accompanied this code).
24 * You should have received a copy of the GNU Lesser General Public License
25 * version 3 along with OpenOffice.org. If not, see
26 * <http://www.openoffice.org/license.html>
27 * for a copy of the LGPLv3 License.
29 ************************************************************************/
30 #ifndef __com_sun_star_plugin_XPluginContext_idl__
31 #define __com_sun_star_plugin_XPluginContext_idl__
33 #ifndef __com_sun_star_uno_XInterface_idl__
34 #include <com/sun/star/uno/XInterface.idl>
35 #endif
37 #ifndef __com_sun_star_plugin_XPlugin_idl__
38 #include <com/sun/star/plugin/XPlugin.idl>
39 #endif
41 #ifndef __com_sun_star_plugin_PluginVariable_idl__
42 #include <com/sun/star/plugin/PluginVariable.idl>
43 #endif
45 #ifndef __com_sun_star_plugin_PluginException_idl__
46 #include <com/sun/star/plugin/PluginException.idl>
47 #endif
49 #ifndef __com_sun_star_lang_XEventListener_idl__
50 #include <com/sun/star/lang/XEventListener.idl>
51 #endif
53 #ifndef __com_sun_star_io_XActiveDataSource_idl__
54 #include <com/sun/star/io/XActiveDataSource.idl>
55 #endif
58 //=============================================================================
60 module com { module sun { module star { module plugin {
62 //=============================================================================
64 /** Interface receiving calls from a plugin library.
65 A default context can be created using the <type>PluginManager</type>.
67 published interface XPluginContext: com::sun::star::uno::XInterface
69 /** Requests global application parameters like display connection
70 on UNIX systems.
72 @param xPlugin
73 plugin
74 @param aVariable
75 variable
76 @return value
78 string getValue( [in] com::sun::star::plugin::XPlugin xPlugin,
79 [in] com::sun::star::plugin::PluginVariable aVariable )
80 raises( com::sun::star::plugin::PluginException );
82 /** Requests a notification of completion of the operation on an URL.
84 @param plugin
85 plugin
86 @param url
87 url
88 @param target
89 target frame
90 @param listener
91 event listener
93 void getURLNotify( [in] com::sun::star::plugin::XPlugin plugin,
94 [in] string url,
95 [in] string target,
96 [in] com::sun::star::lang::XEventListener listener )
97 raises( com::sun::star::plugin::PluginException );
99 /** Requests an URL to be loaded into the frame target.
101 @param plugin
102 plugin
103 @param url
105 @param target
106 target frame
108 void getURL( [in] com::sun::star::plugin::XPlugin plugin,
109 [in] string url,
110 [in] string target )
111 raises( com::sun::star::plugin::PluginException );
113 /** Posts data from a buffer or file to an URL and receives a
114 notification upon completion.
116 @param plugin
117 plugin
118 @param url
120 @param target
121 target frame
122 @param buf
123 data
124 @param file
125 whether data is from file
126 @param listener
127 event listener
129 void postURLNotify( [in] com::sun::star::plugin::XPlugin plugin,
130 [in] string url,
131 [in] string target,
132 [in] sequence<byte> buf,
133 [in] boolean file,
134 [in] com::sun::star::lang::XEventListener listener )
135 raises( com::sun::star::plugin::PluginException );
137 /** Posts data from a buffer or file to an URL.
139 @param plugin
140 plugin
141 @param url
143 @param target
144 target frame
145 @param buf
146 data
147 @param file
148 whether data is from file
150 void postURL( [in] com::sun::star::plugin::XPlugin plugin,
151 [in] string url,
152 [in] string target,
153 [in] sequence<byte> buf,
154 [in] boolean file )
155 raises( com::sun::star::plugin::PluginException );
157 /** Requests a new stream that is created by the plugin and consumed
158 by the browser.
160 @param plugin
161 plugin
162 @param mimetype
163 mime type
164 @param target
165 target frame
166 @param aSource
167 data source
169 void newStream( [in] com::sun::star::plugin::XPlugin plugin,
170 [in] string mimetype,
171 [in] string target,
172 [in] com::sun::star::io::XActiveDataSource aSource )
173 raises( com::sun::star::plugin::PluginException );
175 /** Displays a message in the browser status line.
177 @param plugin
178 plugin
179 @param message
180 message
182 void displayStatusText( [in] com::sun::star::plugin::XPlugin plugin,
183 [in] string message )
184 raises( com::sun::star::plugin::PluginException );
186 /** Returns an application dependent identification string.
187 This is the same string that is transmitted by a browser to an http server.
189 @param plugin
190 plugin
191 @return id
193 string getUserAgent( [in] com::sun::star::plugin::XPlugin plugin )
194 raises( com::sun::star::plugin::PluginException );
197 //=============================================================================
199 }; }; }; };
201 #endif