xref: /AOO41X/main/bean/com/sun/star/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.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  * @deprecated
35cdf0e10cSrcweir  */
36cdf0e10cSrcweir public interface OfficeConnection
37cdf0e10cSrcweir 	extends XComponent
38cdf0e10cSrcweir {
39cdf0e10cSrcweir 	/**
40cdf0e10cSrcweir 	 * Sets a connection URL.
41cdf0e10cSrcweir 	 *
42cdf0e10cSrcweir 	 * @param url This is UNO URL which describes the type of a connection.
43cdf0e10cSrcweir 	 */
setUnoUrl(String url)44cdf0e10cSrcweir 	void setUnoUrl(String url)
45cdf0e10cSrcweir 		throws java.net.MalformedURLException;
46cdf0e10cSrcweir 
47cdf0e10cSrcweir 	/**
48cdf0e10cSrcweir 	 * Sets an AWT container catory.
49cdf0e10cSrcweir 	 *
50cdf0e10cSrcweir 	 * @param containerFactory This is a application provided AWT container
51cdf0e10cSrcweir 	 *	factory.
52cdf0e10cSrcweir 	 */
setContainerFactory(ContainerFactory containerFactory)53cdf0e10cSrcweir 	void setContainerFactory(ContainerFactory containerFactory);
54cdf0e10cSrcweir 
55cdf0e10cSrcweir 	/**
56cdf0e10cSrcweir 	 * Retrives the UNO component context.
57cdf0e10cSrcweir 	 * Establishes a connection if necessary and initialises the
58cdf0e10cSrcweir 	 * UNO service manager if it has not already been initialised.
59cdf0e10cSrcweir 	 *
60cdf0e10cSrcweir 	 * @return The office UNO component context.
61cdf0e10cSrcweir 	 */
getComponentContext()62cdf0e10cSrcweir 	XComponentContext getComponentContext();
63cdf0e10cSrcweir 
64cdf0e10cSrcweir 	/**
65cdf0e10cSrcweir 	 * Creates an office window.
66cdf0e10cSrcweir 	 * The window is either a sub-class of java.awt.Canvas (local) or
67cdf0e10cSrcweir 	 * java.awt.Container (RVP).
68cdf0e10cSrcweir 	 *
69cdf0e10cSrcweir 	 * This method does not add add the office window to its container.
70cdf0e10cSrcweir 	 *
71cdf0e10cSrcweir 	 * @param container This is an AWT container.
72cdf0e10cSrcweir 	 * @return The office window instance.
73cdf0e10cSrcweir 	 */
createOfficeWindow(Container container)74cdf0e10cSrcweir 	OfficeWindow createOfficeWindow(Container container);
75cdf0e10cSrcweir }
76