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
|
/*
@VaadinApache2LicenseForJavaFiles@
*/
package com.vaadin.terminal.gwt.client;
import com.google.gwt.user.client.ui.Widget;
/**
* An interface used by client-side widgets or paintable parts to receive
* updates from the corresponding server-side components in the form of
* {@link UIDL}.
*
* Updates can be sent back to the server using the
* {@link ApplicationConnection#updateVariable()} methods.
*/
public interface ComponentConnector extends ServerConnector {
/*
* (non-Javadoc)
*
* @see com.vaadin.terminal.gwt.client.VPaintable#getState()
*/
public ComponentState getState();
/**
* Returns the widget for this {@link ComponentConnector}
*/
public Widget getWidget();
public LayoutManager getLayoutManager();
/**
* Returns <code>true</code> if the width of this paintable is currently
* undefined. If the width is undefined, the actual width of the paintable
* is defined by its contents.
*
* @return <code>true</code> if the width is undefined, else
* <code>false</code>
*/
public boolean isUndefinedWidth();
/**
* Returns <code>true</code> if the height of this paintable is currently
* undefined. If the height is undefined, the actual height of the paintable
* is defined by its contents.
*
* @return <code>true</code> if the height is undefined, else
* <code>false</code>
*/
public boolean isUndefinedHeight();
/**
* Returns <code>true</code> if the width of this paintable is currently
* relative. If the width is relative, the actual width of the paintable is
* a percentage of the size allocated to it by its parent.
*
* @return <code>true</code> if the width is undefined, else
* <code>false</code>
*/
public boolean isRelativeWidth();
/**
* Returns <code>true</code> if the height of this paintable is currently
* relative. If the height is relative, the actual height of the paintable
* is a percentage of the size allocated to it by its parent.
*
* @return <code>true</code> if the width is undefined, else
* <code>false</code>
*/
public boolean isRelativeHeight();
/**
* Returns the parent of this connector. Can be null for only the root
* connector.
*
* @return The parent of this connector, as set by
* {@link #setParent(ComponentContainerConnector)}.
*/
public ComponentContainerConnector getParent();
/**
* Sets the parent for this connector. This method should only be called by
* the framework to ensure that the connector hierarchy on the client side
* and the server side are in sync.
* <p>
* Note that calling this method does not fire a
* {@link ConnectorHierarchyChangeEvent}. The event is fired only when the
* whole hierarchy has been updated.
*
* @param parent
* The new parent of the connector
*/
public void setParent(ComponentContainerConnector parent);
/**
* Checks if the connector is read only.
*
* @deprecated This belongs in AbstractFieldConnector, see #8514
* @return true
*/
@Deprecated
public boolean isReadOnly();
public boolean hasEventListener(String eventIdentifier);
/**
* Return true if parent handles caption, false if the paintable handles the
* caption itself.
*
* <p>
* This should always return true and all components should let the parent
* handle the caption and use other attributes for internal texts in the
* component
* </p>
*
* @return true if caption handling is delegated to the parent, false if
* parent should not be allowed to render caption
*/
public boolean delegateCaptionHandling();
/**
* Sets the enabled state of the widget associated to this connector.
*
* @param widgetEnabled
* true if the widget should be enabled, false otherwise
*/
public void setWidgetEnabled(boolean widgetEnabled);
}
|
