# Deprecated API

## Contents

- Deprecated Interfaces
- Deprecated Classes
- Deprecated Enums
- Deprecated Methods
- Deprecated Constructors

- Deprecated Interfaces
  Interface and Description
  com.smartgwt.client.widgets.calendar.events.EventHoverHTMLHandler Please use setEventHoverHTMLCustomizer instead, this will be removed in a future release.
  com.smartgwt.client.widgets.calendar.events.HasEventHoverHTMLHandlers Please use setEventHoverHTMLCustomizer instead, this will be removed in a future release.

- Deprecated Classes
  Class and Description
  com.smartgwt.client.widgets.calendar.events.EventHoverHTMLEvent Please use setEventHoverHTMLCustomizer instead, this will be removed in a future release.
  com.smartgwt.client.util.Format see `Localized Number Formatting` for details.

- Deprecated Enums
  Enum and Description
  com.smartgwt.client.types.TimeFormatter Use `DateDisplayFormatter` instead

- Deprecated Methods
  Method and Description
  com.smartgwt.client.widgets.calendar.Calendar.addEventHoverHTMLHandler(EventHoverHTMLHandler) Please use setEventHoverHTMLCustomizer instead, this will be removed in a future release.
  com.smartgwt.client.widgets.calendar.events.HasEventHoverHTMLHandlers.addEventHoverHTMLHandler(EventHoverHTMLHandler) Please use setEventHoverHTMLCustomizer instead, this will be removed in a future release.
  com.smartgwt.client.rpc.RPCManager.cancelQueue(String) please use int methods when dealing with transaction number.
  com.smartgwt.client.rpc.RPCManager.clearTransaction(String) please use int methods when dealing with transaction number.
  com.smartgwt.client.widgets.grid.ListGrid.closeRecord(ListGridRecord) use `ListGrid.setCanExpandRecords(Boolean)` with `ListGrid.setExpansionMode(com.smartgwt.client.types.ExpansionMode)`, or override `ListGrid.getExpansionComponent(ListGridRecord)`
  com.smartgwt.client.widgets.drawing.DrawItem.computeAngle(double, double, double, double) `GwtFloatVsDouble`
  com.smartgwt.client.widgets.drawing.DrawPane.createLinearGradient(String, LinearGradient) in favor of `DrawPane.addGradient()`
  com.smartgwt.client.widgets.drawing.DrawPane.createRadialGradient(String, RadialGradient) in favor of `DrawPane.addGradient()`
  com.smartgwt.client.widgets.drawing.DrawPane.createSimpleGradient(String, SimpleGradient) in favor of `DrawPane.addGradient()`
  com.smartgwt.client.widgets.chart.FacetChart.getAutoRotateLabels() As of Smart GWT 9.0 this property is replaced by the property `rotateLabels`. Setting rotateLabels to "auto" is equivalent to setting autoRotateLabels to `true`. Setting rotateLabels to "never" is equivalent to setting autoRotateLabels to `false`.
  com.smartgwt.client.widgets.calendar.Calendar.getCanDeleteEvents() in favor of `canRemoveEvents`
  com.smartgwt.client.widgets.layout.PortalLayout.getCanResizeRows() Use `canResizePortlets` instead.
  com.smartgwt.client.widgets.form.DynamicForm.getCellSpacing() use `DynamicForm.getCellPadding()` instead
  com.smartgwt.client.widgets.chart.FacetChart.getChartHeight(boolean) `GwtFloatVsDouble`
  com.smartgwt.client.widgets.chart.FacetChart.getChartLeft() `GwtFloatVsDouble`
  com.smartgwt.client.widgets.chart.FacetChart.getChartRadius() `GwtFloatVsDouble`
  com.smartgwt.client.widgets.chart.FacetChart.getChartTop() `GwtFloatVsDouble`
  com.smartgwt.client.widgets.chart.FacetChart.getChartWidth(boolean) `GwtFloatVsDouble`
  com.smartgwt.client.rpc.RPCManager.getCurrentTransactionId() please use int methods when dealing with transaction number.
  com.smartgwt.client.data.RequestTransformer.getDefaultTransformResponse(DSRequest) use `RequestTransformer.getDefaultTransformRequest(DSRequest)` instead
  com.smartgwt.client.widgets.drawing.Gauge.getDialRadius() `GwtFloatVsDouble`
  com.smartgwt.client.widgets.form.fields.TimeItem.getDisplayFormat() Use `TimeItem.setTimeFormatter(com.smartgwt.client.types.TimeDisplayFormat)` instead.
  com.smartgwt.client.widgets.drawing.GaugeSector.getEndAngle() `GwtFloatVsDouble`
  com.smartgwt.client.widgets.drawing.DrawSector.getEndAngle() `GwtFloatVsDouble`
  com.smartgwt.client.widgets.RangeSlider.getEndValue() `GwtFloatVsDouble`
  com.smartgwt.client.widgets.events.ChangedEvent.getEndValue() `GwtFloatVsDouble`
  com.smartgwt.client.util.EnumUtil.getEnums(TYPE[], String[]) use {`EnumUtil.getEnums(ValueEnum[], String[], ValueEnum[])` method
  com.smartgwt.client.data.DSRequest.getExportImageQuality() `GwtFloatVsDouble`
  com.smartgwt.client.widgets.form.events.SubmitValuesEvent.getForm() Use `GwtEvent.getSource()` to determine the source of this event (could be a `DynamicForm` or `ValuesManager`
  com.smartgwt.client.widgets.DateChooser.getHeaderHeight() in favor of `navigationLayoutHeight`
  com.smartgwt.client.data.Hilite.getHtmlValue() `htmlValue` is deprecated in favor of `replacementValue`. Note that unlike `replacementValue`, this property does not respect `disabled`, and will be applied even if `disabled` is set to `true`
  com.smartgwt.client.data.DataSourceField.getLenientXPath() No longer needs to be set since the framework now defaults to suppressing errors for null values in the middle of Xpath, and only invalid XPath will cause warning be logged.
  com.smartgwt.client.widgets.Canvas.getMasterElement() In favor or `Canvas.getMasterCanvas()` as of Smart GWT release 9.1
  com.smartgwt.client.widgets.Slider.getMaxValue() `GwtFloatVsDouble`
  com.smartgwt.client.widgets.RangeSlider.getMaxValue() `GwtFloatVsDouble`
  com.smartgwt.client.widgets.form.fields.SliderItem.getMaxValue() `GwtFloatVsDouble`
  com.smartgwt.client.widgets.drawing.Gauge.getMaxValue() `GwtFloatVsDouble`
  com.smartgwt.client.widgets.Slider.getMinValue() `GwtFloatVsDouble`
  com.smartgwt.client.widgets.RangeSlider.getMinValue() `GwtFloatVsDouble`
  com.smartgwt.client.widgets.form.fields.SliderItem.getMinValue() `GwtFloatVsDouble`
  com.smartgwt.client.widgets.drawing.Gauge.getMinValue() `GwtFloatVsDouble`
  com.smartgwt.client.widgets.DateChooser.getNavigationLayoutHeight() in favor of `navigationLayoutHeight`
  com.smartgwt.client.widgets.Canvas.getParentElement() As of Smartclient version 9.1, deprecated in favor of `parentCanvas` and `Canvas.getParentCanvas()`
  com.smartgwt.client.widgets.drawing.DrawItem.getRotation() `GwtFloatVsDouble`
  com.smartgwt.client.widgets.drawing.DrawPane.getRotation() `GwtFloatVsDouble`
  com.smartgwt.client.widgets.drawing.DrawSector.getRotation() `GwtFloatVsDouble`
  com.smartgwt.client.widgets.drawing.DrawLabel.getRotation() `GwtFloatVsDouble`
  com.smartgwt.client.widgets.drawing.Gauge.getSectorValue(int) `GwtFloatVsDouble`
  com.smartgwt.client.widgets.grid.ListGrid.getSelection() use `ListGrid.getSelectedRecords()` instead
  com.smartgwt.client.widgets.grid.ListGrid.getSelection(boolean) use `ListGrid.getSelectedRecords(boolean)` instead
  com.smartgwt.client.widgets.drawing.GaugeSector.getStartAngle() `GwtFloatVsDouble`
  com.smartgwt.client.widgets.drawing.DrawSector.getStartAngle() `GwtFloatVsDouble`
  com.smartgwt.client.widgets.RangeSlider.getStartValue() `GwtFloatVsDouble`
  com.smartgwt.client.widgets.events.ChangedEvent.getStartValue() `GwtFloatVsDouble`
  com.smartgwt.client.widgets.Slider.getStepPercent() `GwtFloatVsDouble`
  com.smartgwt.client.widgets.menu.MenuItem.getSubmenu() use `com.smartgwt.client.widgets.Menu#getSubmenu` instead
  com.smartgwt.client.widgets.grid.ListGridField.getSummaryTitle() Rather than customizing the summaryTitle developers should typically use the `headerTitle` attribute to show a different title in the column header button than the title used elsewhere.
  com.smartgwt.client.widgets.Slider.getValue() `GwtFloatVsDouble`
  com.smartgwt.client.widgets.chart.DrawnValue.getValue() `GwtFloatVsDouble`
  com.smartgwt.client.widgets.drawing.Gauge.getValue() `GwtFloatVsDouble`
  com.smartgwt.client.widgets.drawing.GaugeSector.getValue() `GwtFloatVsDouble`
  com.smartgwt.client.util.EventHandler.getWheelDelta() in favor of `EventHandler.getWheelDeltaY()`
  com.smartgwt.client.util.EventHandler.getWheelDeltaAsDouble() in favor of `EventHandler.getWheelDeltaY()`
  com.smartgwt.client.widgets.chart.MetricSettings.getXCoord(float) `GwtFloatVsDouble`
  com.smartgwt.client.widgets.chart.MetricSettings.getYCoord(float) `GwtFloatVsDouble`
  com.smartgwt.client.widgets.drawing.DrawPane.getZoomLevel() `GwtFloatVsDouble`
  com.smartgwt.client.widgets.calendar.events.EventHoverHTMLHandler.onEventHoverHTML(EventHoverHTMLEvent) Please use setEventHoverHTMLCustomizer instead, this will be removed in a future release.
  com.smartgwt.client.widgets.grid.ListGrid.openRecordDetailGrid(ListGridRecord, DataSource) use `ListGrid.setCanExpandRecords(Boolean)` with `ListGrid.setExpansionMode(com.smartgwt.client.types.ExpansionMode)`, or override `ListGrid.getExpansionComponent(ListGridRecord)`
  com.smartgwt.client.widgets.grid.ListGrid.openRecordEditor(ListGridRecord) use `ListGrid.setCanExpandRecords(Boolean)` with `ListGrid.setExpansionMode(com.smartgwt.client.types.ExpansionMode)`, or override `ListGrid.getExpansionComponent(ListGridRecord)`
  com.smartgwt.client.util.Page.registerKey(KeyIdentifier, KeyCallback) in favor of `Page.registerKey(KeyIdentifier, PageKeyHandler)`
  com.smartgwt.client.util.Page.registerKey(String, KeyCallback) in favor of `Page.registerKey(String, PageKeyHandler)`
  com.smartgwt.client.rpc.RPCManager.resendTransaction(String) please use int methods when dealing with transaction number.
  com.smartgwt.client.widgets.drawing.DrawGroup.scaleBy(float, float) `GwtFloatVsDouble`
  com.smartgwt.client.widgets.drawing.DrawGroup.scaleTo(float, float) `GwtFloatVsDouble`
  com.smartgwt.client.widgets.chart.FacetChart.setAutoRotateLabels(Boolean) As of Smart GWT 9.0 this property is replaced by the property `rotateLabels`. Setting rotateLabels to "auto" is equivalent to setting autoRotateLabels to `true`. Setting rotateLabels to "never" is equivalent to setting autoRotateLabels to `false`.
  com.smartgwt.client.widgets.calendar.Calendar.setCanDeleteEvents(Boolean) in favor of `canRemoveEvents`
  com.smartgwt.client.widgets.layout.PortalLayout.setCanResizeRows(Boolean) Use `canResizePortlets` instead.
  com.smartgwt.client.widgets.form.DynamicForm.setCellSpacing(int) use `DynamicForm.setCellPadding(int)` instead
  com.smartgwt.client.util.DateUtil.setDateInputFormatter(DateInputFormatter) in favor of setDateParser()
  com.smartgwt.client.widgets.drawing.Gauge.setDialRadius(float) `GwtFloatVsDouble`
  com.smartgwt.client.widgets.form.fields.TimeItem.setDisplayFormat(TimeDisplayFormat) Use `TimeItem.getTimeFormatter()` instead.
  com.smartgwt.client.widgets.form.fields.TimeItem.setDisplayFormat(TimeFormatter) Use `TimeItem.setDisplayFormat(TimeDisplayFormat)` instead.
  com.smartgwt.client.data.DataSourceField.setEditorType(FormItem) Renamed to `DataSourceField.setEditorProperties(FormItem)`. You can also consider using `DataSourceField.setEditorType(Class)` or `DataSourceField.setEditorType(String)` instead.
  com.smartgwt.client.data.SimpleType.setEditorType(FormItem) Renamed to `SimpleType.setEditorProperties(FormItem)`. You can also consider using `SimpleType.setEditorType(Class)` or `SimpleType.setEditorType(String)` instead.
  com.smartgwt.client.widgets.form.fields.FormItem.setEditorType(FormItem) Renamed to `FormItem.setEditorProperties(FormItem)`. You can also consider using `FormItem.setEditorType(Class)` or `FormItem.setEditorType(String)` instead.
  com.smartgwt.client.widgets.grid.ListGridField.setEditorType(FormItem) Renamed to `ListGridField.setEditorProperties(FormItem)`. You can also consider using `ListGridField.setEditorType(Class)` or `ListGridField.setEditorType(String)` instead.
  com.smartgwt.client.widgets.drawing.GaugeSector.setEndAngle(float) `GwtFloatVsDouble`
  com.smartgwt.client.widgets.drawing.DrawSector.setEndAngle(float) `GwtFloatVsDouble`
  com.smartgwt.client.widgets.RangeSlider.setEndValue(float) `GwtFloatVsDouble`
  com.smartgwt.client.data.DSRequest.setExportImageQuality(Float) `GwtFloatVsDouble`
  com.smartgwt.client.widgets.grid.ListGrid.setFilterEditorProperties(ListGrid) in favor of `ListGrid.setFilterEditorProperties(RecordEditor)`
  com.smartgwt.client.widgets.grid.ListGridField.setFilterEditorType(FormItem) Renamed to `ListGridField.setFilterEditorProperties(FormItem)`. You can also consider using `ListGridField.setFilterEditorType(Class)` or `ListGridField.setFilterEditorType(String)` instead.
  com.smartgwt.client.widgets.DateChooser.setHeaderHeight(Integer) in favor of `navigationLayoutHeight`
  com.smartgwt.client.data.Hilite.setHtmlValue(String) `htmlValue` is deprecated in favor of `replacementValue`. Note that unlike `replacementValue`, this property does not respect `disabled`, and will be applied even if `disabled` is set to `true`
  com.smartgwt.client.widgets.grid.ListGridField.setImgDir(String) Renamed to `ListGridField.setImageURLPrefix(String)`
  com.smartgwt.client.data.DataSourceField.setLenientXPath(Boolean) No longer needs to be set since the framework now defaults to suppressing errors for null values in the middle of Xpath, and only invalid XPath will cause warning be logged.
  com.smartgwt.client.widgets.Slider.setMaxValue(float) `GwtFloatVsDouble`
  com.smartgwt.client.widgets.RangeSlider.setMaxValue(float) `GwtFloatVsDouble`
  com.smartgwt.client.widgets.form.fields.SliderItem.setMaxValue(float) `GwtFloatVsDouble`
  com.smartgwt.client.widgets.drawing.Gauge.setMaxValue(float) `GwtFloatVsDouble`
  com.smartgwt.client.widgets.Slider.setMinValue(float) `GwtFloatVsDouble`
  com.smartgwt.client.widgets.RangeSlider.setMinValue(float) `GwtFloatVsDouble`
  com.smartgwt.client.widgets.form.fields.SliderItem.setMinValue(float) `GwtFloatVsDouble`
  com.smartgwt.client.widgets.drawing.Gauge.setMinValue(float) `GwtFloatVsDouble`
  com.smartgwt.client.widgets.DateChooser.setNavigationLayoutHeight(int) in favor of `navigationLayoutHeight`
  com.smartgwt.client.util.DateUtil.setNormalDateDisplayFormat(DateDisplayFormat) This method is deprecated in favor of `DateUtil.setNormalDateDisplayFormatter(DateDisplayFormatter)`.
  com.smartgwt.client.widgets.Canvas.setParentElement(Canvas) As of Smartclient version 9.1, deprecated in favor of `parentCanvas` and `Canvas.getParentCanvas()`
  com.smartgwt.client.widgets.form.fields.SelectItem.setPickListFilterCriteriaFunction(FilterCriteriaFunction) in favor of `SelectItem.setPickListFilterCriteriaFunction(FormItemCriteriaFunction)`
  com.smartgwt.client.widgets.form.fields.ComboBoxItem.setPickListFilterCriteriaFunction(FilterCriteriaFunction) in favor of `ComboBoxItem.setPickListFilterCriteriaFunction(FormItemCriteriaFunction)`
  com.smartgwt.client.data.DataSourceField.setReadOnlyEditorType(FormItem) Renamed to `DataSourceField.setReadOnlyEditorProperties(FormItem)`. You can also consider using `DataSourceField.setReadOnlyEditorType(Class)` or `DataSourceField.setReadOnlyEditorType(String)` instead.
  com.smartgwt.client.data.SimpleType.setReadOnlyEditorType(FormItem) Renamed to `SimpleType.setReadOnlyEditorProperties(FormItem)`. You can also consider using `SimpleType.setReadOnlyEditorType(Class)` or `SimpleType.setReadOnlyEditorType(String)` instead.
  com.smartgwt.client.widgets.Canvas.setResizeFrom(String...) use `#setResizeFrom(EdgeName)` instead.
  com.smartgwt.client.widgets.drawing.DrawItem.setRotation(float) `GwtFloatVsDouble`
  com.smartgwt.client.widgets.drawing.DrawPane.setRotation(float) `GwtFloatVsDouble`
  com.smartgwt.client.widgets.drawing.DrawSector.setRotation(float) `GwtFloatVsDouble`
  com.smartgwt.client.widgets.drawing.DrawLabel.setRotation(float) `GwtFloatVsDouble`
  com.smartgwt.client.util.DateUtil.setShortDateDisplayFormat(DateDisplayFormat) This method is deprecated in favor of `DateUtil.setShortDateDisplayFormatter(DateDisplayFormatter)`.
  com.smartgwt.client.util.DateUtil.setShortDatetimeDisplayFormat(DateDisplayFormat) This method is deprecated in favor of `DateUtil.setShortDatetimeDisplayFormatter(DateDisplayFormatter)`.
  com.smartgwt.client.widgets.form.fields.ComboBoxItem.setSort(SortSpecifier[]) in favor of `ComboBoxItem.setPickListSort(SortSpecifier[])` where full documentation can be read.
  com.smartgwt.client.widgets.drawing.GaugeSector.setStartAngle(float) `GwtFloatVsDouble`
  com.smartgwt.client.widgets.drawing.DrawSector.setStartAngle(float) `GwtFloatVsDouble`
  com.smartgwt.client.widgets.RangeSlider.setStartValue(float) `GwtFloatVsDouble`
  com.smartgwt.client.widgets.Slider.setStepPercent(float) `GwtFloatVsDouble`
  com.smartgwt.client.widgets.grid.ListGridField.setSummaryTitle(String) Rather than customizing the summaryTitle developers should typically use the `headerTitle` attribute to show a different title in the column header button than the title used elsewhere.
  com.smartgwt.client.widgets.calendar.Calendar.setTimeFormatter(TimeFormatter) use `Calendar.setTimeFormatter(TimeDisplayFormat)` instead.
  com.smartgwt.client.data.DataSourceField.setType(DataSource) use #setTypeAsDataSource
  com.smartgwt.client.widgets.Slider.setValue(float) `GwtFloatVsDouble`
  com.smartgwt.client.widgets.drawing.Gauge.setValue(float) `GwtFloatVsDouble`
  com.smartgwt.client.widgets.drawing.GaugeSector.setValue(float) `GwtFloatVsDouble`
  com.smartgwt.client.widgets.chart.DrawnValue.setValue(Float) `GwtFloatVsDouble`
  com.smartgwt.client.widgets.drawing.DrawPane.setZoomLevel(float) `GwtFloatVsDouble`
  com.smartgwt.client.rpc.RPCManager.suspendTransaction(String) please use int methods when dealing with transaction number.
  com.smartgwt.client.widgets.drawing.DrawPane.zoom(float) `GwtFloatVsDouble`

- Deprecated Constructors
  Constructor and Description
  com.smartgwt.client.widgets.drawing.GaugeSector(float)
  com.smartgwt.client.widgets.drawing.GaugeSector(float, String)
  com.smartgwt.client.widgets.RangeSlider(float, float, float, float)