1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
|
/* *************************************************************************
IT Mill Toolkit
Development of Browser User Interfaces Made Easy
Copyright (C) 2000-2006 IT Mill Ltd
*************************************************************************
This product is distributed under commercial license that can be found
from the product package on license.pdf. Use of this product might
require purchasing a commercial license from IT Mill Ltd. For guidelines
on usage, see licensing-guidelines.html
*************************************************************************
For more information, contact:
IT Mill Ltd phone: +358 2 4802 7180
Ruukinkatu 2-4 fax: +358 2 4802 7181
20540, Turku email: info@itmill.com
Finland company www: www.itmill.com
Primary source for information and releases: www.itmill.com
********************************************************************** */
package com.itmill.toolkit.ui;
import com.itmill.toolkit.terminal.PaintException;
import com.itmill.toolkit.terminal.PaintTarget;
import com.itmill.toolkit.terminal.Resource;
/** Link component.
* Link is used to create external or internal URL links.
*
* Internal links can be used to create action items, which
* change the state to application to one of the predefined states.
* For example, a link can be created for existing MenuTree items.
*
* @author IT Mill Ltd.
* @version @VERSION@
* @since 3.0
*/
public class Link extends AbstractComponent {
/* Target window border type constant: No window border */
public static final int TARGET_BORDER_NONE = Window.BORDER_NONE;
/* Target window border type constant: Minimal window border */
public static final int TARGET_BORDER_MINIMAL = Window.BORDER_MINIMAL;
/* Target window border type constant: Default window border */
public static final int TARGET_BORDER_DEFAULT = Window.BORDER_DEFAULT;
private Resource resource = null;
private Window window = null;
private String targetName;
private int targetBorder = TARGET_BORDER_DEFAULT;
private int targetWidth = -1;
private int targetHeight = -1;
/** Creates a new link. */
public Link() {
}
/** Creates a new link to a window. */
public Link(Window window) {
// Set the link caption to match window caption
setCaption(window.getCaption());
// Set the target
setTargetName(window.getName());
setTargetName(window.getName());
setTargetWidth(window.getWidth());
setTargetHeight(window.getHeight());
setTargetBorder(window.getBorder());
}
/** Creates a new instance of Link */
public Link(String caption, Resource resource) {
setCaption(caption);
this.resource = resource;
}
/** Creates a new instance of Link that opens a new window.
*
*
* @param caption Link text.
* @param targetName The name of the target window where the link
* opens to. Empty name of null implies that
* the target is opened to the window containing the link.
* @param width Width of the target window.
* @param height Height of the target window.
* @param border Borget style of the target window.
*
*/
public Link(
String caption,
Resource resource,
String targetName,
int width,
int height,
int border) {
setCaption(caption);
this.resource = resource;
setTargetName(targetName);
setTargetWidth(width);
setTargetHeight(height);
setTargetBorder(border);
}
/** Get component UIDL tag.
* @return Component UIDL tag as string.
*/
public String getTag() {
return "link";
}
/** Paint the content of this component.
* @param event PaintEvent.
* @throws PaintException The paint operation failed.
*/
public void paintContent(PaintTarget target) throws PaintException {
if (window != null)
target.addAttribute("src", window.getURL().toString());
else if (resource != null)
target.addAttribute("src", resource);
else
return;
// Target window name
String name = getTargetName();
if (name != null && name.length()>0)
target.addAttribute("name", name);
// Target window size
if (getTargetWidth() >= 0)
target.addAttribute("width", getTargetWidth());
if (getTargetHeight() >= 0)
target.addAttribute("height", getTargetHeight());
// Target window border
switch (getTargetBorder()) {
case TARGET_BORDER_MINIMAL :
target.addAttribute("border", "minimal");
break;
case TARGET_BORDER_NONE :
target.addAttribute("border", "none");
break;
}
}
/** Returns the target window border.
* @return int
*/
public int getTargetBorder() {
return targetBorder;
}
/** Returns the target window height or -1 if not set.
* @return int
*/
public int getTargetHeight() {
return targetHeight < 0 ? -1 : targetHeight;
}
/** Returns the target window name. Empty name of null implies that
* the target is opened to the window containing the link.
* @return String
*/
public String getTargetName() {
return targetName;
}
/** Returns the target window width or -1 if not set.
* @return int
*/
public int getTargetWidth() {
return targetWidth < 0 ? -1 : targetWidth;
}
/** Sets the border of the target window.
* @param targetBorder The targetBorder to set
*/
public void setTargetBorder(int targetBorder) {
if (targetBorder == TARGET_BORDER_DEFAULT
|| targetBorder == TARGET_BORDER_MINIMAL
|| targetBorder == TARGET_BORDER_NONE) {
this.targetBorder = targetBorder;
requestRepaint();
}
}
/** Sets the target window height.
* @param targetHeight The targetHeight to set
*/
public void setTargetHeight(int targetHeight) {
this.targetHeight = targetHeight;
requestRepaint();
}
/** Sets the target window name.
* @param targetName The targetName to set
*/
public void setTargetName(String targetName) {
this.targetName = targetName;
requestRepaint();
}
/** Sets the target window width.
* @param targetWidth The targetWidth to set
*/
public void setTargetWidth(int targetWidth) {
this.targetWidth = targetWidth;
requestRepaint();
}
/** Returns the resource this link opens.
* @return Resource
*/
public Resource getResource() {
return resource;
}
/** Returns the window this link opens.
* @return Window
*/
public Window getWindow() {
return window;
}
/** Sets the resource this link opens.
* @param resource The resource to set
*/
public void setResource(Resource resource) {
this.resource = resource;
if (resource != null) {
window = null;
}
requestRepaint();
}
/** Sets the window this link opens.
* @param window The window to set
*/
public void setWindow(Window window) {
this.window = window;
if (window != null) {
this.resource = null;
}
requestRepaint();
}
}
|
