KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > apache > jetspeed > portal > PortletControl


1 /*
2  * Copyright 2000-2001,2004 The Apache Software Foundation.
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  * http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */

16
17 package org.apache.jetspeed.portal;
18
19 /**
20  * The PortletControl acts both as a decoration around a Portlet or PortletSet
21  * and also as the window manager for the enclosed Portlet(Set).
22  * As such it controls the operation that may be performed on this portlet
23  * and whether the portlet content should be displayed or not.
24  * PortletControl also delegates all Portlet and PortletSet methods to its
25  * inner object and can thus be transparently cascaded or substituted to
26  * a simple portlet wherever in a PSML object tree.
27  *
28  * @author <a HREF="mailto:raphael@apache.org">RaphaŽl Luta</a>
29  * @version $Id: PortletControl.java,v 1.24 2004/02/23 04:05:35 jford Exp $
30  */

31 public interface PortletControl extends Portlet, PortletSet
32 {
33
34     public String JavaDoc COLOR = "#CCCCCC";
35     public String JavaDoc BACKGROUND_COLOR = "#FFFFFF";
36     public String JavaDoc TITLE_COLOR = "#DDDDDD";
37     public String JavaDoc WIDTH = "100%";
38
39     /**
40      * @return the PortletControl specific configuration
41      */

42     public PortletControlConfig getConfig();
43
44     /**
45      * Sets the PortletControl specific configuration
46      * @param conf the new PortletControl configuration
47      */

48     public void setConfig(PortletControlConfig conf);
49
50     /**
51      * Sets the portlet to be managed by this control
52      *
53      * @param portlet the new portlet to be managed by the control
54      */

55     public void setPortlet(Portlet portlet);
56
57     /**
58      * Retrieves the portlet managed by this control
59      * @return the portlet object managed or null
60      */

61     public Portlet getPortlet();
62
63     /**
64      * Initializes the control and associates it with a portlet
65      *
66      * @param portlet the portlet to be managed by this control
67      */

68     public void init( Portlet portlet );
69
70     /**
71      * Returns the color to use for displaying the portlet text
72      *
73      * This method is deprecated and is only useful for ECS
74      * based Control implementation
75      * @deprecated
76      * @return the text color value in HTML format (#RRGGBB)
77      */

78     public String JavaDoc getColor();
79
80     /**
81      * Sets the color to use for displaying the portlet text
82      *
83      * This method is deprecated and is only useful for ECS
84      * based Control implementation
85      * @deprecated
86      * @param color the text color value in HTML format (#RRGGBB)
87      */

88     public void setColor(String JavaDoc color);
89
90     /**
91      * Returns the color to use for displaying the portlet background
92      *
93      * This method is deprecated and is only useful for ECS
94      * based Control implementation
95      * @deprecated
96      * @return the text color value in HTML format (#RRGGBB)
97      */

98     public String JavaDoc getBackgroundColor();
99
100     /**
101      * Sets the color to use for displaying the portlet background
102      *
103      * This method is deprecated and is only useful for ECS
104      * based Control implementation
105      * @deprecated
106      * @param backgroundColor the background color value in HTML format (#RRGGBB)
107      */

108     public void setBackgroundColor(String JavaDoc backgroundColor);
109
110     /**
111      * Returns the color to use for displaying the portlet title
112      *
113      * This method is deprecated and is only useful for ECS
114      * based Control implementation
115      * @deprecated
116      * @return the text color value in HTML format (#RRGGBB)
117      */

118     public String JavaDoc getTitleColor();
119
120     /**
121      * Sets the color to use for displaying the portlet title
122      *
123      * This method is deprecated and is only useful for ECS
124      * based Control implementation
125      * @deprecated
126      * @param titleColor the title color value in HTML format (#RRGGBB)
127      */

128     public void setTitleColor(String JavaDoc titleColor);
129
130     /**
131      * Returns the width of the managed portlet relative to the size of
132      * portlet control.
133      * This method is deprecated and is only useful for ECS
134      * based Control implementation
135      * @deprecated
136      * @return the size value. May be expressed in percentages (eg, "80%")
137      */

138     public String JavaDoc getWidth();
139
140     /**
141      * Sets the width of the managed portlet relative to the size of
142      * portlet control.
143      *
144      * This method is deprecated and is only useful for ECS
145      * based Control implementation
146      * @deprecated
147      * @param width the width of portlet. Must be a positive, non nul integer
148      */

149     public void setWidth(int width);
150
151     /**
152      * Sets the width of the managed portlet relative to the size of
153      * portlet control.
154      *
155      * This method is deprecated and is only useful for ECS
156      * based Control implementation
157      * @deprecated
158      * @param width the width of portlet. Must be parseable as a positive, non
159      * nul integer or a percentage
160      */

161     public void setWidth(String JavaDoc width);
162 }
163
Popular Tags