Deprecated API

Contents
Deprecated Interfaces
com.vaadin.ui.FieldFactory
          FieldFactory was split into two lighter interfaces in 6.0 Use FormFieldFactory or TableFieldFactory or both instead. 
com.vaadin.event.ItemClickEvent.ItemClickSource
          Use ItemClickEvent.ItemClickNotifier instead. ItemClickSource was deprecated in version 6.5. 
 

Deprecated Classes
com.vaadin.ui.AlignmentUtils
          AlignmentUtils has been replaced by Alignment. 
com.vaadin.ui.BaseFieldFactory
          use DefaultFieldFactory or own implementations on FormFieldFactory or TableFieldFactory instead. 
com.vaadin.terminal.gwt.client.ClientExceptionHandler
           
com.vaadin.ui.ExpandLayout
          Deprecated in favor of the new OrderedLayout 
com.vaadin.terminal.gwt.client.ui.MenuBar
            
com.vaadin.terminal.gwt.client.ui.MenuItem
            
com.vaadin.ui.OrderedLayout
          Replaced by VerticalLayout/HorizontalLayout. For type checking please not that VerticalLayout/HorizontalLayout do not extend OrderedLayout but AbstractOrderedLayout (which also OrderedLayout extends). 
com.vaadin.data.util.QueryContainer
          will be removed in the future, use the SQLContainer add-on 
com.vaadin.ui.SplitPanel
          in 6.5. Use HorizontalSplitPanel or VerticalSplitPanel instead. 
com.vaadin.terminal.gwt.client.UIDL.XML
          should not be used anymore 
 

Deprecated Fields
com.vaadin.ui.Layout.AlignmentHandler.ALIGNMENT_BOTTOM
          Use of Alignment class and its constants 
com.vaadin.ui.Layout.AlignmentHandler.ALIGNMENT_HORIZONTAL_CENTER
          Use of Alignment class and its constants 
com.vaadin.ui.Layout.AlignmentHandler.ALIGNMENT_LEFT
          Use of Alignment class and its constants 
com.vaadin.ui.Layout.AlignmentHandler.ALIGNMENT_RIGHT
          Use of Alignment class and its constants 
com.vaadin.ui.Layout.AlignmentHandler.ALIGNMENT_TOP
          Use of Alignment class and its constants 
com.vaadin.ui.Layout.AlignmentHandler.ALIGNMENT_VERTICAL_CENTER
          Use of Alignment class and its constants 
com.vaadin.ui.themes.Reindeer.BUTTON_PRIMARY
          Use Reindeer.BUTTON_DEFAULT instead 
com.vaadin.ui.Label.CONTENT_UIDL
          Use CONTENT_XML instead. 
com.vaadin.ui.themes.Reindeer.LABEL_LIGHT
          Use Reindeer.LABEL_SMALL instead. 
com.vaadin.ui.themes.BaseTheme.PANEL_LIGHT
          Base theme does not implement this style, but it is defined here since it has been a part of the framework before multiple themes were available. Use the constant provided by the theme you're using instead, e.g. Reindeer.PANEL_LIGHT or Runo.PANEL_LIGHT. 
com.vaadin.ui.Panel.STYLE_LIGHT
          this style is no longer part of the core framework and this component, even though most built-in themes implement this style. Use the constant specified in the theme class file that you're using, if it provides one, e.g. Reindeer.PANEL_LIGHT or Runo.PANEL_LIGHT . 
com.vaadin.ui.Button.STYLE_LINK
          use BaseTheme.BUTTON_LINK instead. 
com.vaadin.ui.Slider.STYLE_SCROLLBAR
           
com.vaadin.ui.themes.Reindeer.TABSHEET_BAR
          Use Reindeer.TABSHEET_SMALL instead. 
com.vaadin.terminal.gwt.client.ApplicationConnection.UIDL_SECURITY_HEADER
          use UIDL_SECURITY_TOKEN_ID instead 
 

Deprecated Methods
com.vaadin.data.util.IndexedContainer.clone()
          cloning support might be removed from IndexedContainer in the future 
com.vaadin.ui.AbstractField.constructField(Class)
          use e.g. DefaultFieldFactory.createFieldByPropertyType(Class) instead 
com.vaadin.terminal.gwt.server.AbstractApplicationServlet.createCommunicationManager(Application)
          Instead of overriding this method, override WebApplicationContext implementation via AbstractApplicationServlet.getApplicationContext(HttpSession) method and in that customized implementation return your CommunicationManager in WebApplicationContext.getApplicationManager(Application, AbstractApplicationServlet) method. 
com.vaadin.terminal.gwt.client.ClientExceptionHandler.displayError(String)
           
com.vaadin.terminal.gwt.client.ClientExceptionHandler.displayError(String, Throwable)
           
com.vaadin.service.ApplicationContext.generateApplicationResourceURL(ApplicationResource, String)
          this method is intended for terminal implementation only and is subject to change/removal from the interface (to AbstractCommunicationManager) 
com.vaadin.terminal.gwt.client.UIDL.getChildrenAsXML()
            
com.vaadin.ui.MenuBar.getCollapse()
            
com.vaadin.ui.Select.getColumns()
          see setter function 
com.vaadin.ui.CustomComponent.getComponentType()
          not more useful as the whole tag system has been removed 
com.vaadin.terminal.gwt.client.ApplicationConnection.getConsole()
          Developers should use VConsole since 6.4.5 
com.vaadin.data.util.sqlcontainer.query.FreeformQueryDelegate.getContainsRowQueryString(Object...)
          Implement FreeformStatementDelegate instead of FreeformQueryDelegate 
com.vaadin.data.util.sqlcontainer.query.FreeformQueryDelegate.getCountQuery()
          Implement FreeformStatementDelegate instead of FreeformQueryDelegate 
com.vaadin.ui.Table.getFieldFactory()
          use Table.getTableFieldFactory() instead 
com.vaadin.ui.Form.getFieldFactory()
          Use Form.getFormFieldFactory() instead. Set the FormFieldFactory using Form.setFormFieldFactory(FormFieldFactory). 
com.vaadin.ui.RichTextArea.getFormat()
          replaced by PropertyFormatter 
com.vaadin.ui.AbstractTextField.getFormat()
          replaced by PropertyFormatter 
com.vaadin.ui.RichTextArea.getFormattedValue()
            
com.vaadin.ui.AbstractTextField.getFormattedValue()
            
com.vaadin.ui.Slider.getHandleSize()
          The size is dictated by the current theme. 
com.vaadin.terminal.gwt.client.ui.dd.DDUtil.getHorizontalDropLocation(Element, int, double)
          use the version with the actual event 
com.vaadin.ui.Panel.getLayout()
          A Panel can now contain a ComponentContainer which is not necessarily a Layout. Use Panel.getContent() instead. 
com.vaadin.ui.Window.Notification.getMessage()
          Use Window.Notification.getDescription() instead. 
com.vaadin.ui.PopupView.getPopupVisibility()
          Use PopupView.isPopupVisible() instead. 
com.vaadin.ui.Upload.getProgressListener()
          Replaced with addListener/removeListener 
com.vaadin.data.util.sqlcontainer.query.FreeformQueryDelegate.getQueryString(int, int)
          Implement FreeformStatementDelegate instead of FreeformQueryDelegate 
com.vaadin.Application.getRelativeLocation(ApplicationResource)
          this method is intended to be used by the terminal only. It may be removed or moved in the future. 
com.vaadin.ui.TextField.getRows()
          Starting from 6.5 use TextArea for a multi-line text input. 
com.vaadin.ui.Panel.getScrollOffsetX()
          use Panel.getScrollLeft() instead 
com.vaadin.ui.Panel.getScrollOffsetY()
          use Panel.getScrollTop() instead 
com.vaadin.ui.Slider.getSize()
          use standard getWidth/getHeight instead 
com.vaadin.ui.AbstractComponent.getStyle()
          Use getStyleName() instead; renamed for consistency and to indicate that "style" should not be used to switch client side implementation, only to style the component. 
com.vaadin.ui.MenuBar.getSubmenuIcon()
            
com.vaadin.ui.TabSheet.getTabCaption(Component)
          Use TabSheet.getTab(Component) and TabSheet.Tab.getCaption() instead. 
com.vaadin.ui.TabSheet.getTabIcon(Component)
          Use TabSheet.getTab(Component) and TabSheet.Tab.getIcon() instead. 
com.vaadin.service.ApplicationContext.getURLKey(URL, String)
          this method is intended for terminal implementation only and is subject to change/removal from the interface (to AbstractCommunicationManager) 
com.vaadin.terminal.gwt.client.ui.dd.DDUtil.getVerticalDropLocation(Element, int, double)
          use the version with the actual event instead of detected clientY value 
com.vaadin.ui.GridLayout.Area.getX1()
          Use GridLayout.Area.getColumn1() instead. 
com.vaadin.ui.GridLayout.Area.getX2()
          Use GridLayout.Area.getColumn2() instead. 
com.vaadin.ui.GridLayout.Area.getY1()
          Use GridLayout.Area.getRow1() instead. 
com.vaadin.ui.GridLayout.Area.getY2()
          Use GridLayout.Area.getRow2() instead. 
com.vaadin.Application.handleURI(URL, String)
          this method is called be the terminal implementation only and might be removed or moved in the future. Instead of overriding this method, add your URIHandler to a top level Window (eg. getMainWindow().addUriHanler(handler) instead. 
com.vaadin.ui.DragAndDropWrapper.WrapperTargetDetails.horizontalDropLocation()
          use DragAndDropWrapper.WrapperTargetDetails.getHorizontalDropLocation() instead 
com.vaadin.service.ApplicationContext.isApplicationResourceURL(URL, String)
          this method is intended for terminal implementation only and is subject to change/removal from the interface (to AbstractCommunicationManager) 
com.vaadin.terminal.gwt.client.ApplicationConnection.isDebugMode()
          use ApplicationConfiguration isDebugMode instead. 
com.vaadin.terminal.gwt.client.Util.isFF2()
          use BrowserInfo class instead 
com.vaadin.terminal.gwt.client.Util.isIE()
          use BrowserInfo class instead 
com.vaadin.terminal.gwt.client.Util.isIE6()
          use BrowserInfo class instead 
com.vaadin.terminal.gwt.client.Util.isIE7()
          use BrowserInfo class instead 
com.vaadin.ui.Select.isMultiSelect()
          use ListSelect, OptionGroup or TwinColSelect instead 
com.vaadin.data.validator.StringLengthValidator.isNullAllowed()
           
com.vaadin.ui.Table.isPageBufferingEnabled()
          functionality is not needed in ajax rendering model 
com.vaadin.ui.TextField.isSecret()
          Starting from 6.5 use PasswordField instead for secret text input. 
com.vaadin.ui.Layout.SpacingHandler.isSpacingEnabled()
          Use Layout.SpacingHandler.isSpacing() instead. 
com.vaadin.ui.GridLayout.isSpacingEnabled()
           
com.vaadin.ui.AbstractOrderedLayout.isSpacingEnabled()
           
com.vaadin.ui.Button.isSwitchMode()
          the CheckBox component should be used instead of Button in switch mode 
com.vaadin.ui.TextField.isWordwrap()
          Starting from 6.5 use TextArea for a multi-line text input. 
com.vaadin.terminal.PaintTarget.paintReference(Paintable, String)
          use PaintTarget.addAttribute(String, Paintable) or PaintTarget.addVariable(VariableOwner, String, Paintable) instead 
com.vaadin.terminal.gwt.server.JsonPaintTarget.paintReference(Paintable, String)
           
com.vaadin.ui.Table.refreshCurrentPage()
          should not need to be used 
com.vaadin.data.util.AbstractInMemoryContainer.setAllItemIds(List)
           
com.vaadin.ui.MenuBar.setCollapse(boolean)
          (since 6.2, will be removed in 7.0) Collapsing is always enabled if the MenuBar has a specified width. 
com.vaadin.ui.Select.setColumns(int)
            
com.vaadin.ui.Layout.AlignmentHandler.setComponentAlignment(Component, int, int)
          Use Layout.AlignmentHandler.setComponentAlignment(Component, Alignment) instead 
com.vaadin.ui.GridLayout.setComponentAlignment(Component, String)
          Replaced by GridLayout.setComponentAlignment(Component, Alignment) 
com.vaadin.ui.AbstractOrderedLayout.setComponentAlignment(Component, String)
          Replaced by AbstractOrderedLayout.setComponentAlignment(Component, Alignment) 
com.vaadin.ui.CustomComponent.setComponentType(String)
          not more useful as the whole tag system has been removed 
com.vaadin.terminal.gwt.client.ui.dd.VHtml5DragEvent.setDragEffect(String)
          As of Vaadin 6.8, replaced by VHtml5DragEvent.setDropEffect(String). 
com.vaadin.ui.Table.setFieldFactory(FieldFactory)
          use Table.setTableFieldFactory(TableFieldFactory) instead 
com.vaadin.ui.Form.setFieldFactory(FieldFactory)
          use Form.setFormFieldFactory(FormFieldFactory) instead 
com.vaadin.data.util.AbstractInMemoryContainer.setFilteredItemIds(List)
           
com.vaadin.ui.RichTextArea.setFormat(Format)
          replaced by PropertyFormatter 
com.vaadin.ui.AbstractTextField.setFormat(Format)
          replaced by PropertyFormatter 
com.vaadin.ui.Slider.setHandleSize(int)
          The size is dictated by the current theme. 
com.vaadin.terminal.Sizeable.setHeight(float)
          Consider using Sizeable.setHeight(String) or Sizeable.setHeight(float, int) instead. This method works, but is error-prone since the unit must be set separately (and components might have different default unit). 
com.vaadin.ui.AbstractComponent.setHeight(float)
           
com.vaadin.terminal.Sizeable.setHeightUnits(int)
          Consider setting height and unit simultaneously using Sizeable.setHeight(String) or Sizeable.setHeight(float, int), which is less error-prone. 
com.vaadin.ui.AbstractComponent.setHeightUnits(int)
           
com.vaadin.ui.Panel.setLayout(Layout)
          A Panel can now contain a ComponentContainer which is not necessarily a Layout. Use Panel.setContent(ComponentContainer) instead. 
com.vaadin.ui.Window.Notification.setMessage(String)
          Use Window.Notification.setDescription(String) instead. 
com.vaadin.ui.Select.setMultiSelect(boolean)
          use ListSelect, OptionGroup or TwinColSelect instead 
com.vaadin.data.validator.StringLengthValidator.setNullAllowed(boolean)
           
com.vaadin.ui.OrderedLayout.setOrientation(int)
          Use VerticalLayout/HorizontalLayout or define orientation in constructor instead 
com.vaadin.ui.Table.setPageBufferingEnabled(boolean)
          functionality is not needed in ajax rendering model 
com.vaadin.ui.PopupView.setPopupVisibility(boolean)
          Use #setPopupVisible() instead. 
com.vaadin.ui.Upload.setProgressListener(Upload.ProgressListener)
          Use addListener(ProgressListener) instead. 
com.vaadin.ui.TextField.setRows(int)
          Starting from 6.5 use TextArea for a multi-line text input. 
com.vaadin.ui.Panel.setScrollOffsetX(int)
          use setScrollLeft() method instead 
com.vaadin.ui.Panel.setScrollOffsetY(int)
          use setScrollTop() method instead 
com.vaadin.ui.TextField.setSecret(boolean)
          Starting from 6.5 use PasswordField instead for secret text input. 
com.vaadin.ui.Slider.setSize(int)
          use standard setWidth/setHeight instead 
com.vaadin.ui.AbstractComponent.setStyle(String)
          Use setStyleName() instead; renamed for consistency and to indicate that "style" should not be used to switch client side implementation, only to style the component. 
com.vaadin.ui.CustomLayout.setStyle(String)
          Use CustomLayout.setTemplateName(String) instead 
com.vaadin.ui.MenuBar.setSubmenuIcon(Resource)
          (since 6.2, will be removed in 7.0) Icon is set in theme, no need to worry about the visual representation here. 
com.vaadin.ui.CheckBox.setSwitchMode(boolean)
           
com.vaadin.ui.Button.setSwitchMode(boolean)
          the CheckBox component should be used instead of Button in switch mode 
com.vaadin.ui.TabSheet.setTabCaption(Component, String)
          Use TabSheet.getTab(Component) and TabSheet.Tab.setCaption(String) instead. 
com.vaadin.ui.TabSheet.setTabIcon(Component, Resource)
          Use TabSheet.getTab(Component) and TabSheet.Tab.setIcon(Resource) instead. 
com.vaadin.terminal.Sizeable.setWidth(float)
          Consider using Sizeable.setWidth(String) instead. This method works, but is error-prone since the unit must be set separately (and components might have different default unit). 
com.vaadin.ui.AbstractComponent.setWidth(float)
           
com.vaadin.terminal.Sizeable.setWidthUnits(int)
          Consider setting width and unit simultaneously using Sizeable.setWidth(String) or Sizeable.setWidth(float, int), which is less error-prone. 
com.vaadin.ui.AbstractComponent.setWidthUnits(int)
           
com.vaadin.ui.TextField.setWordwrap(boolean)
          Starting from 6.5 use TextArea for a multi-line text input. 
com.vaadin.terminal.gwt.client.ApplicationConnection.showCommunicationError(String)
          Use the method with errorCode instead 
com.vaadin.terminal.gwt.client.ui.VOverlay.updateShadowSizeAndPosition()
          Call VOverlay.positionOrSizeUpdated() instead. 
com.vaadin.ui.DragAndDropWrapper.WrapperTargetDetails.verticalDropLocation()
          use DragAndDropWrapper.WrapperTargetDetails.getVerticalDropLocation() instead 
com.vaadin.terminal.gwt.client.ui.VView.windowSizeMaybeChanged(int, int)
          use VView.performSizeCheck() 
 

Deprecated Constructors
com.vaadin.data.util.BeanItemContainer(Collection)
          use BeanItemContainer.BeanItemContainer(Class, Collection) instead 
com.vaadin.ui.Button(String, boolean)
          use CheckBox instead of Button in "switchmode" 
com.vaadin.ui.Button(String, Property)
          use CheckBox instead of Button in "switchmode" 
com.vaadin.data.util.sqlcontainer.ColumnProperty(String, boolean, boolean, boolean, Object, Class)
            
com.vaadin.terminal.gwt.server.CommunicationManager(Application, AbstractApplicationServlet)
          use CommunicationManager.CommunicationManager(Application) instead 
com.vaadin.data.util.sqlcontainer.query.FreeformQuery(String, List, JDBCConnectionPool)
          @see FreeformQuery.FreeformQuery(String, JDBCConnectionPool, String...) 
com.vaadin.ui.NativeButton(String, boolean)
          use the CheckBox component instead 
com.vaadin.ui.NativeButton(String, Property)
          use the CheckBox component instead 
com.vaadin.ui.OrderedLayout()
          Use VerticalLayout instead. 
com.vaadin.ui.OrderedLayout(int)
          Use VerticalLayout/HorizontalLayout instead. 
com.vaadin.terminal.gwt.client.ui.TouchScrollDelegate.TouchScrollHandler(Widget, Element...)
          Use GWT.create(Class) and TouchScrollDelegate.TouchScrollHandler.init(Widget, Element...) instead of this constructor to enable overriding. 
com.vaadin.terminal.gwt.client.ui.VMenuBar.CustomMenuItem(String, Command)
          use the default constructor and VMenuBar.CustomMenuItem.setHTML(String) and VMenuBar.CustomMenuItem.setCommand(Command) instead 
com.vaadin.terminal.gwt.client.ui.VNotification(int)
          Use static VNotification.createNotification(int) instead to enable GWT deferred binding. 
com.vaadin.terminal.gwt.client.ui.VNotification(int, int, int)
          Use static #createNotification(int, int, int) instead to enable GWT deferred binding.