Package com.vaadin.client
Interface ComponentConnector
-
- All Superinterfaces:
Connector,HasWidget,Serializable,ServerConnector
- All Known Subinterfaces:
DirectionalManagedLayout,HasErrorIndicator,HasRequiredIndicator,ManagedLayout,SimpleManagedLayout,ValueChangeHandler.Owner
- All Known Implementing Classes:
AbsoluteLayoutConnector,AbstractColorPickerConnector,AbstractComponentConnector,AbstractComponentContainerConnector,AbstractDateFieldConnector,AbstractFieldConnector,AbstractFocusableListingConnector,AbstractHasComponentsConnector,AbstractInlineDateFieldConnector,AbstractLayoutConnector,AbstractListingConnector,AbstractMultiSelectConnector,AbstractOrderedLayoutConnector,AbstractSingleComponentContainerConnector,AbstractSingleSelectConnector,AbstractSplitPanelConnector,AbstractTextFieldConnector,AbstractTextualDateConnector,AccordionConnector,AudioConnector,BrowserFrameConnector,ButtonConnector,CheckBoxConnector,CheckBoxGroupConnector,ColorPickerAreaConnector,ColorPickerConnector,ColorPickerGradientConnector,ColorPickerGridConnector,ComboBoxConnector,CompositeConnector,CssLayoutConnector,CustomComponentConnector,CustomFieldConnector,CustomLayoutConnector,DateFieldConnector,DateTimeFieldConnector,DragAndDropWrapperConnector,EmbeddedConnector,FormLayoutConnector,GridConnector,GridLayoutConnector,HorizontalLayoutConnector,HorizontalSplitPanelConnector,ImageConnector,InlineDateFieldConnector,InlineDateTimeFieldConnector,JavaScriptComponentConnector,LabelConnector,LegacyConnector,LinkConnector,ListSelectConnector,LoginFormConnector,MediaBaseConnector,MenuBarConnector,NativeButtonConnector,NativeSelectConnector,PanelConnector,PasswordFieldConnector,PopupDateFieldConnector,PopupDateTimeFieldConnector,PopupViewConnector,ProgressBarConnector,RadioButtonGroupConnector,RichTextAreaConnector,SliderConnector,TabsheetBaseConnector,TabsheetConnector,TextAreaConnector,TextFieldConnector,TextualDateConnector,TreeGridConnector,TwinColSelectConnector,UIConnector,UnknownComponentConnector,UploadConnector,VerticalLayoutConnector,VerticalSplitPanelConnector,VideoConnector,WindowConnector
public interface ComponentConnector extends HasWidget
An interface used by client-side widgets or paintable parts to receive updates from the corresponding server-side components in the form ofUIDL. Updates can be sent back to the server using theApplicationConnection#updateVariable()methods.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description booleandelegateCaptionHandling()Return true if parent handles caption, false if the paintable handles the caption itself.voidflush()Called for the active (focused) connector when a situation occurs that the focused connector might have buffered changes which need to be processed before other activity takes place.LayoutManagergetLayoutManager()AbstractComponentStategetState()Gets the current shared state of the connector.TooltipInfogetTooltipInfo(com.google.gwt.dom.client.Element element)Gets the tooltip info for the given element.booleanhasTooltip()Check whether there might be a tooltip for this component.booleanisRelativeHeight()Returnstrueif the height of this paintable is currently relative.booleanisRelativeWidth()Returnstrueif the width of this paintable is currently relative.booleanisUndefinedHeight()Returnstrueif the height of this paintable is currently undefined.booleanisUndefinedWidth()Returnstrueif the width of this paintable is currently undefined.voidsetWidgetEnabled(boolean widgetEnabled)Sets the enabled state of the widget associated to this connector.-
Methods inherited from interface com.vaadin.shared.Connector
getConnectorId
-
Methods inherited from interface com.vaadin.client.ServerConnector
addStateChangeHandler, addStateChangeHandler, doInit, fireEvent, getChildren, getConnection, getParent, getRpcImplementations, getTag, hasEventListener, isEnabled, onUnregister, removeStateChangeHandler, removeStateChangeHandler, setChildren, setParent, setTag, updateEnabledState
-
-
-
-
Method Detail
-
getState
AbstractComponentState getState()
Description copied from interface:ServerConnectorGets the current shared state of the connector. Note that state is considered an internal part of the connector. You should not rely on the state object outside of the connector who owns it. If you depend on the state of other connectors you should use their public API instead of their state object directly.- Specified by:
getStatein interfaceServerConnector- Returns:
- state The shared state object. Can be any sub type of
SharedState. Never null.
-
getLayoutManager
LayoutManager getLayoutManager()
-
isUndefinedWidth
boolean isUndefinedWidth()
Returnstrueif the width of this paintable is currently undefined. If the width is undefined, the actual width of the paintable is defined by its contents.- Returns:
trueif the width is undefined, elsefalse
-
isUndefinedHeight
boolean isUndefinedHeight()
Returnstrueif the height of this paintable is currently undefined. If the height is undefined, the actual height of the paintable is defined by its contents.- Returns:
trueif the height is undefined, elsefalse
-
isRelativeWidth
boolean isRelativeWidth()
Returnstrueif 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.- Returns:
trueif the width is undefined, elsefalse
-
isRelativeHeight
boolean isRelativeHeight()
Returnstrueif 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.- Returns:
trueif the width is undefined, elsefalse
-
delegateCaptionHandling
boolean delegateCaptionHandling()
Return true if parent handles caption, false if the paintable handles the caption itself.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
- Returns:
- true if caption handling is delegated to the parent, false if parent should not be allowed to render caption
-
setWidgetEnabled
void setWidgetEnabled(boolean widgetEnabled)
Sets the enabled state of the widget associated to this connector.- Parameters:
widgetEnabled- true if the widget should be enabled, false otherwise
-
getTooltipInfo
TooltipInfo getTooltipInfo(com.google.gwt.dom.client.Element element)
Gets the tooltip info for the given element.When overriding this method,
hasTooltip()should also be overridden to returntruein all situations where this method might return a non-empty result.- Parameters:
element- The element to lookup a tooltip for- Returns:
- The tooltip for the element or null if no tooltip is defined for this element.
-
hasTooltip
boolean hasTooltip()
Check whether there might be a tooltip for this component. The framework will only add event listeners for automatically handling tooltips (usinggetTooltipInfo(Element)) if this method returns true.This is only done to optimize performance, so in cases where the status is not known, it's safer to return
trueso that there will be a tooltip handler even though it might not be needed in all cases.- Returns:
trueif some part of the component might have a tooltip, otherwisefalse
-
flush
void flush()
Called for the active (focused) connector when a situation occurs that the focused connector might have buffered changes which need to be processed before other activity takes place.This is currently called when the user changes the fragment using the back/forward button in the browser and allows the focused field to submit its value to the server before the fragment change event takes place.
-
-