@openui5/sap.m 1.84.27 → 1.84.29

package/src/sap/m/OverflowToolbar.js

@@ -125,7 +125,7 @@ sap.ui.define([
 	 * @implements sap.ui.core.Toolbar,sap.m.IBar
 	 *
 	 * @author SAP SE
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 *
 	 * @constructor
 	 * @public
@@ -215,6 +215,9 @@ sap.ui.define([
 		// Overflow Button clone, it helps to calculate correct size of the button
 		this._oOverflowToolbarButtonClone = null;
 
+		// Width of the content with "NeverOverflow" priority
+		this._iToolbarOnlyContentSize = 0;
+
 		this._aMovableControls = []; // Controls that can be in the toolbar or Popover
 		this._aToolbarOnlyControls = []; // Controls that can't go to the Popover (inputs, labels, buttons with special layout, etc...)
 		this._aPopoverOnlyControls = []; // Controls that are forced to stay in the Popover (buttons with layout)
@@ -458,14 +461,23 @@ sap.ui.define([
 		var aVisiblePopoverOnlyControls,
 			bHasVisiblePopoverOnlyControls,
 			iLeftPadding = parseInt(this.$().css("padding-right")) || 0,
-			iRightPadding =  parseInt(this.$().css("padding-left")) || 0;
+			iRightPadding =  parseInt(this.$().css("padding-left")) || 0,
+			iOverflowButtonSize = this._getOverflowButtonSize(),
+			iToolbarOnlyContentSize = this._iToolbarOnlyContentSize;
 
 		this._iOldContentSize = this._iContentSize;
 		this._iContentSize = 0; // The total *optimal* size of all controls in the toolbar
+		this._iToolbarOnlyContentSize = 0;
 		this._bNeedUpdateOnControlsCachedSizes = false;
 
 		this.getContent().forEach(this._updateControlsCachedSizes, this);
 
+		if (iToolbarOnlyContentSize !== this._iToolbarOnlyContentSize) {
+			this.fireEvent("_minWidthChange", {
+				minWidth: this._iToolbarOnlyContentSize > 0 ? this._iToolbarOnlyContentSize + iOverflowButtonSize : 0
+			});
+		}
+
 		// If the system is a phone sometimes due to specificity in the flex the content can be rendered 1px larger that it should be.
 		// This causes an overflow of the last element/button
 		if (Device.system.phone) {
@@ -481,7 +493,7 @@ sap.ui.define([
 
 			if (bHasVisiblePopoverOnlyControls) {
 				// At least one control will be in the Popover, so the overflow button is required within content
-				this._iContentSize += this._getOverflowButtonSize();
+				this._iContentSize += iOverflowButtonSize;
 			}
 		}
 
@@ -518,6 +530,10 @@ sap.ui.define([
 		if (sPriority !== OverflowToolbarPriority.AlwaysOverflow) {
 			this._iContentSize += iControlSize;
 		}
+
+		if (sPriority === OverflowToolbarPriority.NeverOverflow) {
+			this._iToolbarOnlyContentSize += iControlSize;
+		}
 	};
 
 	/**

package/src/sap/m/OverflowToolbarAssociativePopover.js

@@ -30,7 +30,7 @@ sap.ui.define(['./Popover', './PopoverRenderer', './OverflowToolbarAssociativePo
 	 * @extends sap.m.Popover
 	 *
 	 * @author SAP SE
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 *
 	 * @constructor
 	 * @private

package/src/sap/m/OverflowToolbarButton.js

@@ -27,7 +27,7 @@ sap.ui.define(['sap/m/Button', 'sap/m/ButtonRenderer'],
 	 * @implements sap.f.IShellBar
 	 *
 	 * @author SAP SE
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/OverflowToolbarLayoutData.js

@@ -22,7 +22,7 @@ sap.ui.define(['sap/m/ToolbarLayoutData', 'sap/m/library', "sap/base/Log"],
 	 * Holds layout data for the {@link sap.m.OverflowToolbar} items.
 	 * @extends sap.m.ToolbarLayoutData
 	 * @author SAP SE
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/OverflowToolbarToggleButton.js

@@ -23,7 +23,7 @@ sap.ui.define(['sap/m/ToggleButton', 'sap/m/ToggleButtonRenderer'],
 		 * @extends sap.m.ToggleButton
 		 *
 		 * @author SAP SE
-		 * @version 1.84.27
+		 * @version 1.84.29
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/P13nAnyFilterItem.js

@@ -17,7 +17,7 @@ sap.ui.define([
 	 * @param {object} [mSettings] initial settings for the new control
 	 * @class Type for <code>filterItems</code> aggregation in P13nFilterPanel control.
 	 * @extends sap.m.P13nFilterItem
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 * @constructor
 	 * @private
 	 * @since 1.56.0

package/src/sap/m/P13nColumnsItem.js

@@ -17,7 +17,7 @@ sap.ui.define([
 	 * @param {object} [mSettings] initial settings for the new control
 	 * @class Type for <code>columnsItems</code> aggregation in <code>P13nColumnsPanel</code> control.
 	 * @extends sap.ui.core.Item
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 * @constructor
 	 * @author SAP SE
 	 * @public

package/src/sap/m/P13nColumnsPanel.js

@@ -36,7 +36,7 @@ sap.ui.define([
 	 * @class The <code>P13nColumnsPanel</code> control is used to define column-specific settings for table personalization.
 	 * @extends sap.m.P13nPanel
 	 * @author SAP SE
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 * @constructor
 	 * @public
 	 * @since 1.26.0

package/src/sap/m/P13nConditionPanel.js

@@ -113,7 +113,7 @@ sap.ui.define([
 	 * @param {object} [mSettings] initial settings for the new control
 	 * @class The ConditionPanel Control will be used to implement the Sorting, Filtering and Grouping panel of the new Personalization dialog.
 	 * @extends sap.ui.core.Control
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 * @constructor
 	 * @public
 	 * @since 1.26.0
@@ -1921,6 +1921,10 @@ sap.ui.define([
 					oConditionGrid.oType.validateValue(oValue);
 
 					sValue = oConditionGrid.oType.formatValue(oValue, "string");
+					if (sValue && sValue.toUpperCase && this.getDisplayFormat() === "UpperCase") {
+						sValue = sValue.toUpperCase();
+					}
+
 					oCtrl.setValue(sValue);
 				} catch (err) {
 					var sMsg = err.message;

package/src/sap/m/P13nDialog.js

@@ -57,7 +57,7 @@ sap.ui.define([
 	 *        tables.
 	 * @extends sap.m.Dialog
 	 * @author SAP SE
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 * @constructor
 	 * @public
 	 * @since 1.26.0

package/src/sap/m/P13nDimMeasureItem.js

@@ -16,7 +16,7 @@ sap.ui.define([
 	 * @param {object} [mSettings] initial settings for the new control
 	 * @class Type for <code>columnsItems</code> aggregation in <code>P13nDimMeasurePanel</code> control.
 	 * @extends sap.ui.core.Item
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 * @constructor
 	 * @author SAP SE
 	 * @public

package/src/sap/m/P13nDimMeasurePanel.js

@@ -87,7 +87,7 @@ sap.ui.define([
 	 *        dimensions and measures for table personalization.
 	 * @extends sap.m.P13nPanel
 	 * @author SAP SE
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 * @constructor
 	 * @public
 	 * @since 1.34.0

package/src/sap/m/P13nFilterItem.js

@@ -17,7 +17,7 @@ sap.ui.define([
 	 * @param {object} [mSettings] initial settings for the new control
 	 * @class Type for <code>filterItems</code> aggregation in P13nFilterPanel control.
 	 * @extends sap.ui.core.Item
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 * @constructor
 	 * @public
 	 * @since 1.26.0

package/src/sap/m/P13nFilterPanel.js

@@ -23,7 +23,7 @@ sap.ui.define([
 	 * @param {object} [mSettings] initial settings for the new control
 	 * @class The P13nFilterPanel control is used to define filter-specific settings for table personalization.
 	 * @extends sap.m.P13nPanel
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 * @constructor
 	 * @public
 	 * @since 1.26.0

package/src/sap/m/P13nGroupItem.js

@@ -17,7 +17,7 @@ sap.ui.define([
 	 * @param {object} [mSettings] initial settings for the new control
 	 * @class Type for <code>groupItems</code> aggregation in P13nGroupPanel control.
 	 * @extends sap.ui.core.Item
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 * @constructor
 	 * @public
 	 * @since 1.28.0

package/src/sap/m/P13nGroupPanel.js

@@ -27,7 +27,7 @@ sap.ui.define([
 	 * @param {object} [mSettings] initial settings for the new control
 	 * @class The P13nGroupPanel control is used to define group-specific settings for table personalization.
 	 * @extends sap.m.P13nPanel
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 * @constructor
 	 * @public
 	 * @since 1.26.0

package/src/sap/m/P13nItem.js

@@ -17,7 +17,7 @@ sap.ui.define([
 	 * @param {object} [mSettings] initial settings for the new control
 	 * @class Base type for <code>items</code> aggregation in <code>P13nPanel</code> control.
 	 * @extends sap.ui.core.Element
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 * @constructor
 	 * @public
 	 * @since 1.26.0

package/src/sap/m/P13nPanel.js

@@ -17,7 +17,7 @@ sap.ui.define([
 	 * @param {object} [mSettings] initial settings for the new control
 	 * @class An abstract base type for <code>panels</code> aggregation in <code>P13nDialog</code> control.
 	 * @extends sap.ui.core.Control
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 * @constructor
 	 * @public
 	 * @abstract

package/src/sap/m/P13nSelectionItem.js

@@ -17,7 +17,7 @@ sap.ui.define([
 	 * @param {object} [mSettings] initial settings for the new control
 	 * @class Type for <code>selectionItems</code> aggregation in <code>P13nSelectionPanel</code> control.
 	 * @extends sap.ui.core.Item
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 * @constructor
 	 * @author SAP SE
 	 * @private

package/src/sap/m/P13nSelectionPanel.js

@@ -30,7 +30,7 @@ sap.ui.define([
 	 * @class The P13nSelectionPanel control is used to define selection settings like the visibility or the order of items.
 	 * @extends sap.m.P13nPanel
 	 * @author SAP SE
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 * @constructor
 	 * @private
 	 * @since 1.46.0

package/src/sap/m/P13nSortItem.js

@@ -17,7 +17,7 @@ sap.ui.define([
 	 * @param {object} [mSettings] initial settings for the new control
 	 * @class Type for <code>sortItems</code> aggregation in P13nSortPanel control.
 	 * @extends sap.ui.core.Item
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 * @constructor
 	 * @public
 	 * @since 1.26.0

package/src/sap/m/P13nSortPanel.js

@@ -26,7 +26,7 @@ sap.ui.define([
 	 * @param {object} [mSettings] initial settings for the new control
 	 * @class The P13nSortPanel control is used to define settings for sorting in table personalization.
 	 * @extends sap.m.P13nPanel
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 * @constructor
 	 * @public
 	 * @since 1.26.0

package/src/sap/m/PDFViewer.js

@@ -47,7 +47,7 @@ sap.ui.define([
 		 * @extends sap.ui.core.Control
 		 *
 		 * @author SAP SE
-		 * @version 1.84.27
+		 * @version 1.84.29
 		 * @since 1.48
 		 *
 		 * @constructor

package/src/sap/m/Page.js

@@ -91,7 +91,7 @@ function(
 		 * @extends sap.ui.core.Control
 		 * @mixes sap.ui.core.ContextMenuSupport
 		 * @author SAP SE
-		 * @version 1.84.27
+		 * @version 1.84.29
 		 *
 		 * @public
 		 * @alias sap.m.Page

package/src/sap/m/PageAccessibleLandmarkInfo.js

@@ -22,7 +22,7 @@ sap.ui.define(['sap/ui/core/Element', './library'],
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/PagingButton.js

@@ -26,7 +26,7 @@ sap.ui.define([
 		 * @extends sap.ui.core.Control
 		 *
 		 * @author SAP SE
-		 * @version 1.84.27
+		 * @version 1.84.29
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/Panel.js

@@ -66,7 +66,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/PlanningCalendar.js

@@ -201,7 +201,7 @@ sap.ui.define([
 	 * {@link sap.m.PlanningCalendarView PlanningCalendarView}'s properties.
 	 *
 	 * @extends sap.ui.core.Control
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/PlanningCalendarHeader.js

@@ -95,7 +95,7 @@ function(
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 *
 	 * @constructor
 	 * @private

package/src/sap/m/PlanningCalendarLegend.js

@@ -28,7 +28,7 @@ sap.ui.define(['sap/ui/unified/CalendarLegend', 'sap/ui/unified/CalendarAppointm
 		 * @extends sap.ui.unified.CalendarLegend
 		 *
 		 * @author SAP SE
-		 * @version 1.84.27
+		 * @version 1.84.29
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/PlanningCalendarRow.js

@@ -32,7 +32,7 @@ sap.ui.define(['sap/ui/core/Element',
 	 * The <code>sap.m.PlanningCalendarRow</code> allows you to modify appointments at row level.
 	 *
 	 * @extends sap.ui.core.Element
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/PlanningCalendarView.js

@@ -30,7 +30,7 @@ sap.ui.define(['sap/ui/core/Element', './library', 'sap/ui/unified/library'],
 	 * The <code>PlanningCalendarView</code> defines the type of the intervals (hours, days, months)
 	 * and how many intervals are displayed.
 	 * @extends sap.ui.core.Element
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/Popover.js

@@ -113,7 +113,7 @@ sap.ui.define([
 		* @extends sap.ui.core.Control
 		* @implements sap.ui.core.PopupInterface
 		* @author SAP SE
-		* @version 1.84.27
+		* @version 1.84.29
 		*
 		* @public
 		* @alias sap.m.Popover

package/src/sap/m/ProgressIndicator.js

@@ -59,7 +59,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/PullToRefresh.js

@@ -41,7 +41,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/QuickView.js

@@ -59,7 +59,7 @@ sap.ui.define([
 	 * @extends sap.m.QuickViewBase
 	 *
 	 * @author SAP SE
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/QuickViewBase.js

@@ -27,7 +27,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/QuickViewCard.js

@@ -36,7 +36,7 @@ sap.ui.define([
 	 * @extends sap.m.QuickViewBase
 	 *
 	 * @author SAP SE
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/QuickViewGroup.js

@@ -22,7 +22,7 @@ sap.ui.define([
 	* @extends sap.ui.core.Element
 	*
 	* @author SAP SE
-	* @version 1.84.27
+	* @version 1.84.29
 	*
 	* @constructor
 	* @public

package/src/sap/m/QuickViewGroupElement.js

@@ -28,7 +28,7 @@ sap.ui.define([
 	* @extends sap.ui.core.Element
 	*
 	* @author SAP SE
-	* @version 1.84.27
+	* @version 1.84.29
 	*
 	* @constructor
 	* @public

package/src/sap/m/QuickViewPage.js

@@ -93,7 +93,7 @@ sap.ui.define([
 	* @extends sap.ui.core.Control
 	*
 	* @author SAP SE
-	* @version 1.84.27
+	* @version 1.84.29
 	*
 	* @constructor
 	* @public

package/src/sap/m/RadioButton.js

@@ -87,7 +87,7 @@ function(
 	 * @implements sap.ui.core.IFormContent
 	 *
 	 * @author SAP SE
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/RadioButtonGroup.js

@@ -59,7 +59,7 @@ sap.ui.define([
 			 * @implements sap.ui.core.IFormContent
 			 *
 			 * @author SAP SE
-			 * @version 1.84.27
+			 * @version 1.84.29
 			 *
 			 * @constructor
 			 * @public
@@ -196,8 +196,7 @@ sap.ui.define([
 
 				aButtons.forEach(function (oRadioButton, i) {
 					oRadioButton._setEditableParent(bEditable);
-
-					if (i === this.getSelectedIndex() && this._iSelectionNumber > iCurrentSelectedButtonSelectionNumber) {
+					if (i === this.getSelectedIndex() && this._iSelectionNumber > iCurrentSelectedButtonSelectionNumber && oRadioButton.isPropertyInitial("selected")) {
 						oRadioButton.setSelected(true);
 					}
 				}, this);

package/src/sap/m/RangeSlider.js

@@ -51,7 +51,7 @@ sap.ui.define([
          * @extends sap.m.Slider
          *
          * @author SAP SE
-         * @version 1.84.27
+         * @version 1.84.29
          *
          * @constructor
          * @public

package/src/sap/m/RatingIndicator.js

@@ -51,7 +51,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/ResponsivePopover.js

@@ -63,7 +63,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/ResponsiveScale.js

@@ -34,7 +34,7 @@ sap.ui.define([
 		 * @extends sap.ui.core.Element
 		 *
 		 * @author SAP SE
-		 * @version 1.84.27
+		 * @version 1.84.29
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/ScrollBar.js

@@ -25,7 +25,7 @@ function(Control, ScrollBarRenderer) {
 	 * care of only rendering the currently visible rows and use this <code>ScrollBar</code> control to make
 	 * the users think they are actually scrolling through a long list.
 	 * @extends sap.ui.core.Control
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 *
 	 * @private
 	 * @alias sap.m.ScrollBar

package/src/sap/m/ScrollContainer.js

@@ -37,7 +37,7 @@ sap.ui.define([
 		 * @extends sap.ui.core.Control
 		 *
 		 * @author SAP SE
-		 * @version 1.84.27
+		 * @version 1.84.29
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/SearchField.js

@@ -72,7 +72,7 @@ sap.ui.define([
 	* @extends sap.ui.core.Control
 	* @implements sap.ui.core.IFormContent
 	* @author SAP SE
-	* @version 1.84.27
+	* @version 1.84.29
 	*
 	* @constructor
 	* @public

package/src/sap/m/SearchFieldRenderer.js

@@ -35,7 +35,12 @@ sap.ui.define(["sap/ui/Device", "sap/ui/core/InvisibleText"],
 			sId = oSF.getId(),
 			bShowRefreshButton = oSF.getShowRefreshButton(),
 			bShowSearchBtn = oSF.getShowSearchButton(),
-			oAccAttributes = {}, // additional accessibility attributes
+			oAccAttributes = {
+				describedby: {
+					value: SearchFieldRenderer._getDescribedBy(oSF),
+					append: true
+				}
+			},
 			sToolTipValue,
 			sRefreshToolTip = oSF.getRefreshButtonTooltip(),
 			sResetToolTipValue;
@@ -119,17 +124,6 @@ sap.ui.define(["sap/ui/Device", "sap/ui/core/InvisibleText"],
 
 			rm.attr("value", sValue);
 
-			// ARIA attributes
-			if (oSF.getEnabled() && bShowRefreshButton) {
-				var sAriaF5LabelId = InvisibleText.getStaticId("sap.m", "SEARCHFIELD_ARIA_F5");
-				if (sAriaF5LabelId) {
-					oAccAttributes.describedby = {
-						value: sAriaF5LabelId,
-						append: true
-					};
-				}
-			}
-
 			oAccAttributes.disabled = null;
 
 			rm.accessibilityState(oSF, oAccAttributes);
@@ -195,6 +189,16 @@ sap.ui.define(["sap/ui/Device", "sap/ui/core/InvisibleText"],
 		rm.close("div");
 	};
 
+	SearchFieldRenderer._getDescribedBy = function (oSF) {
+		var sDescribedBy = InvisibleText.getStaticId("sap.m", "SEARCHFIELD_ARIA_DESCRIBEDBY");
+
+		if (oSF.getEnabled() && oSF.getShowRefreshButton()) {
+			sDescribedBy += " " + InvisibleText.getStaticId("sap.m", "SEARCHFIELD_ARIA_F5");
+		}
+
+		return sDescribedBy;
+	};
+
 	return SearchFieldRenderer;
 
 }, /* bExport= */ true);

package/src/sap/m/SegmentedButton.js

@@ -50,7 +50,7 @@ function(
 	 * @implements sap.ui.core.IFormContent
 	 *
 	 * @author SAP SE
-	 * @version 1.84.27
+	 * @version 1.84.29
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/SegmentedButtonItem.js

@@ -23,7 +23,7 @@ sap.ui.define(['./library', 'sap/ui/core/Item', 'sap/m/Button', 'sap/ui/core/Cus
 		 * @extends sap.ui.core.Item
 		 *
 		 * @author SAP SE
-		 * @version 1.84.27
+		 * @version 1.84.29
 		 *
 		 * @constructor
 		 * @public