xref: /AOO41X/main/bean/com/sun/star/comp/beans/OfficeConnection.java (revision d4cc1e8c350bb591a80bbabe126ff6af34c125a2)
1*d4cc1e8cSAndrew Rist /**************************************************************
2cdf0e10cSrcweir  *
3*d4cc1e8cSAndrew Rist  * Licensed to the Apache Software Foundation (ASF) under one
4*d4cc1e8cSAndrew Rist  * or more contributor license agreements.  See the NOTICE file
5*d4cc1e8cSAndrew Rist  * distributed with this work for additional information
6*d4cc1e8cSAndrew Rist  * regarding copyright ownership.  The ASF licenses this file
7*d4cc1e8cSAndrew Rist  * to you under the Apache License, Version 2.0 (the
8*d4cc1e8cSAndrew Rist  * "License"); you may not use this file except in compliance
9*d4cc1e8cSAndrew Rist  * with the License.  You may obtain a copy of the License at
10cdf0e10cSrcweir  *
11*d4cc1e8cSAndrew Rist  *   http://www.apache.org/licenses/LICENSE-2.0
12cdf0e10cSrcweir  *
13*d4cc1e8cSAndrew Rist  * Unless required by applicable law or agreed to in writing,
14*d4cc1e8cSAndrew Rist  * software distributed under the License is distributed on an
15*d4cc1e8cSAndrew Rist  * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
16*d4cc1e8cSAndrew Rist  * KIND, either express or implied.  See the License for the
17*d4cc1e8cSAndrew Rist  * specific language governing permissions and limitations
18*d4cc1e8cSAndrew Rist  * under the License.
19cdf0e10cSrcweir  *
20*d4cc1e8cSAndrew Rist  *************************************************************/
21*d4cc1e8cSAndrew Rist 
22*d4cc1e8cSAndrew Rist 
23cdf0e10cSrcweir 
24cdf0e10cSrcweir package com.sun.star.comp.beans;
25cdf0e10cSrcweir 
26cdf0e10cSrcweir import java.awt.Container;
27cdf0e10cSrcweir 
28cdf0e10cSrcweir import com.sun.star.lang.XComponent;
29cdf0e10cSrcweir import com.sun.star.uno.XComponentContext;
30cdf0e10cSrcweir 
31cdf0e10cSrcweir /**
32cdf0e10cSrcweir  * This abstract class reprecents a connection to the office
33cdf0e10cSrcweir  * application.
34cdf0e10cSrcweir 
35cdf0e10cSrcweir     @deprecated
36cdf0e10cSrcweir  */
37cdf0e10cSrcweir public interface OfficeConnection
38cdf0e10cSrcweir 	extends XComponent
39cdf0e10cSrcweir {
40cdf0e10cSrcweir 	/**
41cdf0e10cSrcweir 	 * Sets a connection URL.
42cdf0e10cSrcweir 	 *
43cdf0e10cSrcweir 	 * @param url This is UNO URL which describes the type of a connection.
44cdf0e10cSrcweir 	 */
setUnoUrl(String url)45cdf0e10cSrcweir 	void setUnoUrl(String url)
46cdf0e10cSrcweir 		throws java.net.MalformedURLException;
47cdf0e10cSrcweir 
48cdf0e10cSrcweir 	/**
49cdf0e10cSrcweir 	 * Sets an AWT container catory.
50cdf0e10cSrcweir 	 *
51cdf0e10cSrcweir 	 * @param containerFactory This is a application provided AWT container
52cdf0e10cSrcweir 	 *	factory.
53cdf0e10cSrcweir 	 */
setContainerFactory(ContainerFactory containerFactory)54cdf0e10cSrcweir 	void setContainerFactory(ContainerFactory containerFactory);
55cdf0e10cSrcweir 
56cdf0e10cSrcweir 	/**
57cdf0e10cSrcweir 	 * Retrives the UNO component context.
58cdf0e10cSrcweir 	 * Establishes a connection if necessary and initialises the
59cdf0e10cSrcweir 	 * UNO service manager if it has not already been initialised.
60cdf0e10cSrcweir 	 *
61cdf0e10cSrcweir 	 * @return The office UNO component context.
62cdf0e10cSrcweir 	 */
getComponentContext()63cdf0e10cSrcweir 	XComponentContext getComponentContext();
64cdf0e10cSrcweir 
65cdf0e10cSrcweir 	/**
66cdf0e10cSrcweir 	 * Creates an office window.
67cdf0e10cSrcweir 	 * The window is either a sub-class of java.awt.Canvas (local) or
68cdf0e10cSrcweir 	 * java.awt.Container (RVP).
69cdf0e10cSrcweir 	 *
70cdf0e10cSrcweir 	 * This method does not add add the office window to its container.
71cdf0e10cSrcweir 	 *
72cdf0e10cSrcweir 	 * @param container This is an AWT container.
73cdf0e10cSrcweir 	 * @return The office window instance.
74cdf0e10cSrcweir 	 */
createOfficeWindow(Container container)75cdf0e10cSrcweir 	OfficeWindow createOfficeWindow(Container container);
76cdf0e10cSrcweir }
77