@openui5/sap.m 1.108.2 → 1.110.0

package/src/sap/m/semantic/SendEmailAction.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -19,7 +19,7 @@ sap.ui.define(['sap/m/semantic/SemanticButton'], function(SemanticButton) {
 	 * @extends sap.m.semantic.SemanticButton
 	 *
 	 * @author SAP SE
-	 * @version 1.108.2
+	 * @version 1.110.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/semantic/SendMessageAction.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -19,7 +19,7 @@ sap.ui.define(['sap/m/semantic/SemanticButton'], function(SemanticButton) {
 	 * @extends sap.m.semantic.SemanticButton
 	 *
 	 * @author SAP SE
-	 * @version 1.108.2
+	 * @version 1.110.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/semantic/ShareInJamAction.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -19,7 +19,7 @@ sap.ui.define(['sap/m/semantic/SemanticButton'], function(SemanticButton) {
 	 * @extends sap.m.semantic.SemanticButton
 	 *
 	 * @author SAP SE
-	 * @version 1.108.2
+	 * @version 1.110.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/semantic/ShareMenu.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -48,7 +48,7 @@ sap.ui.define([
 	 * ShareMenu is a special menu that is represented by (1) an actionSheet with the menu items and (2) a button that opens the actionSheet.
 	 * If the menu has only one item, then that item appears in place of the button that opens the actionSheet.
 	 *
-	 * @version 1.108.2
+	 * @version 1.110.0
 	 * @private
 	 * @since 1.30.0
 	 * @alias sap.m.semantic.ShareMenu

package/src/sap/m/semantic/ShareMenuPage.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -22,7 +22,7 @@ sap.ui.define(["sap/m/semantic/SemanticPage", "sap/m/semantic/SemanticConfigurat
 	 * @extends sap.m.semantic.SemanticPage
 	 *
 	 * @author SAP SE
-	 * @version 1.108.2
+	 * @version 1.110.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/semantic/SortAction.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -25,7 +25,7 @@ sap.ui.define(['sap/m/semantic/SemanticButton'], function(SemanticButton) {
 	 * @implements sap.m.semantic.ISort
 	 *
 	 * @author SAP SE
-	 * @version 1.108.2
+	 * @version 1.110.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/semantic/SortSelect.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -24,7 +24,7 @@ sap.ui.define(['sap/m/semantic/SemanticSelect'], function(SemanticSelect) {
 	 * @implements sap.m.semantic.ISort
 	 *
 	 * @author SAP SE
-	 * @version 1.108.2
+	 * @version 1.110.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/table/Util.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -20,7 +20,7 @@ sap.ui.define([
 	 * @namespace
 	 * @alias module:sap/m/table/Util
 	 * @author SAP SE
-	 * @version 1.108.2
+	 * @version 1.110.0
 	 * @since 1.96.0
 	 * @private
 	 * @ui5-restricted sap.fe, sap.ui.mdc, sap.ui.comp
@@ -30,7 +30,8 @@ sap.ui.define([
 	// local privates
 	var sDefaultFont = "";
 	var fBaseFontSize = parseFloat(MLibrary.BaseFontSize);
-
+	var oSelectAllNotificationPopover = null;
+	var pGetSelectAllPopover = null;
 	/**
 	 * Measures the given text width in a canvas and returns the value in rem.
 	 *
@@ -152,22 +153,35 @@ sap.ui.define([
 	 * @param {float} [fContentWidth] The calculated width of the cell in rem
 	 * @param {int} [iMaxWidth=19] The maximum header width in rem
 	 * @param {int} [iMinWidth=2] The minimum header width in rem
+	 * @param {boolean} [bRequired=false] Determines whether the given column header is marked as required
 	 * @returns {float} The calculated header width in rem
 	 * @private
+	 * @ui5-restricted sap.ui.comp
 	 */
 	Util.calcHeaderWidth = (function() {
 		var sHeaderFont = "";
+		var sRequiredFont = "";
 		var fnGetHeaderFont = function() {
 			if (!sHeaderFont) {
 				sHeaderFont = [ThemeParameters.get({ name: "sapUiColumnHeaderFontWeight" }) || "normal", sDefaultFont].join(" ");
 			}
 			return sHeaderFont;
 		};
+		var fnGetRequiredFont = function() {
+			if (!sRequiredFont) {
+				sRequiredFont = [ThemeParameters.get({ name: "sapMFontLargeSize" }) || "normal", sDefaultFont].join(" ");
+			}
+			return sRequiredFont;
+		};
 
-		Core.attachThemeChanged(function() { sHeaderFont = ""; });
+		Core.attachThemeChanged(function() {
+			sHeaderFont = "";
+			sRequiredFont = "";
+		});
 
-		return function(sHeader, fContentWidth, iMaxWidth, iMinWidth) {
+		return function(sHeader, fContentWidth, iMaxWidth, iMinWidth, bRequired) {
 			var iHeaderLength = sHeader.length;
+			var fRequired = 0;
 			iMaxWidth = iMaxWidth || 19;
 			iMinWidth = iMinWidth || 2;
 
@@ -177,8 +191,14 @@ sap.ui.define([
 			if (iMinWidth > iHeaderLength) {
 				return iMinWidth;
 			}
+
+			if (bRequired) {
+				fRequired = 0.125 /* margin */ + Util.measureText("*", fnGetRequiredFont());
+			}
+
 			if (!fContentWidth) {
-				return Util.measureText(sHeader, fnGetHeaderFont());
+				var fHeaderWidth = Util.measureText(sHeader, fnGetHeaderFont());
+				return fHeaderWidth + fRequired;
 			}
 
 			fContentWidth = Math.max(fContentWidth, iMinWidth);
@@ -194,7 +214,7 @@ sap.ui.define([
 
 			var fHeaderWidthDiff = Math.max(0, fOrigHeaderWidth - fMaxHeaderWidth);
 			var fHeaderWidth = (fHeaderWidthDiff < 0.15) ? fOrigHeaderWidth : fMaxHeaderWidth + fHeaderWidthDiff * (1 - 1 / fContentWidth) / Math.E;
-			return fHeaderWidth;
+			return fHeaderWidth + fRequired;
 		};
 	})();
 
@@ -206,12 +226,14 @@ sap.ui.define([
 	 * @param {object} [mSettings] The settings object
 	 * @param {int} [mSettings.minWidth=2] The minimum content width of the field in rem
 	 * @param {int} [mSettings.maxWidth=19] The maximum content width of the field in rem
-	 * @param {int} [mSettings.padding=1] The sum of column padding and border in rem
+	 * @param {int} [mSettings.padding=1.0625] The sum of column padding(1rem) and border(1px) in rem
 	 * @param {float} [mSettings.gap=0] The additional content width in rem
 	 * @param {boolean} [mSettings.headerGap=false] Whether icons in the header should be taken into account
 	 * @param {boolean} [mSettings.truncateLabel=true] Whether the header of the column can be truncated or not
 	 * @param {boolean} [mSettings.verticalArrangement=false] Whether the fields are arranged vertically
+	 * @param {boolean} [mSettings.required=false] Indicates the state of the column header as defined by the <code>required</code> property
 	 * @param {int} [mSettings.defaultWidth=8] The default column content width when type check fails
+	 * @param {int} [mSettings.treeColumn=false] Determines whether the first column of the tree table
 	 * @returns {string} The calculated width of the column
 	 * @private
 	 * @ui5-restricted sap.fe, sap.ui.mdc, sap.ui.comp
@@ -227,15 +249,16 @@ sap.ui.define([
 			maxWidth: 19,
 			defaultWidth: 8,
 			truncateLabel: true,
-			padding: 1,
+			padding: 1.0625,
 			gap: 0
 		}, mSettings);
 
 		var fHeaderWidth = 0;
 		var iMinWidth = Math.max(1, mSettings.minWidth);
 		var iMaxWidth = Math.max(iMinWidth, mSettings.maxWidth);
+		var fTreeColumnGap = mSettings.treeColumn ? 3 : 0;
 
-		var fContentWidth = mSettings.gap + vTypes.reduce(function(fInnerWidth, vType) {
+		var fContentWidth = mSettings.gap + fTreeColumnGap + vTypes.reduce(function(fInnerWidth, vType) {
 			var oType = vType, oTypeSettings = {
 				defaultWidth: mSettings.defaultWidth,
 				maxWidth: mSettings.maxWidth
@@ -253,13 +276,13 @@ sap.ui.define([
 		}, 0);
 
 		if (sHeader) {
-			fHeaderWidth = Util.calcHeaderWidth(sHeader, (mSettings.truncateLabel ? fContentWidth : 0), iMaxWidth, iMinWidth);
+			fHeaderWidth = Util.calcHeaderWidth(sHeader, (mSettings.truncateLabel ? fContentWidth : 0), iMaxWidth, iMinWidth, mSettings.required);
 			fHeaderWidth += mSettings.headerGap ? (8 /* padding */ + 14 /* icon width */) / fBaseFontSize : 0;
 		}
 
 		fContentWidth = Math.max(iMinWidth, fContentWidth, fHeaderWidth);
 		fContentWidth = Math.min(fContentWidth, iMaxWidth);
-		fContentWidth = Math.round(fContentWidth * 100) / 100;
+		fContentWidth = Math.ceil(fContentWidth * 100) / 100;
 
 		return fContentWidth + mSettings.padding + "rem";
 	};
@@ -291,6 +314,102 @@ sap.ui.define([
 		return oIllustratedMessage;
 	};
 
+	/**
+	 * Creates or returns the existing popover
+	 *
+	 * @returns {Promise} A promise that resolves when the popover is created
+	 * @private
+	 * @since 1.109
+	 */
+	Util.getSelectAllPopover = function() {
+		if (pGetSelectAllPopover) {
+			return pGetSelectAllPopover;
+		}
+
+		pGetSelectAllPopover = Promise.all(
+            [new Promise(function(fnResolve) {
+				sap.ui.require([
+					"sap/m/Popover",
+					"sap/m/Bar",
+					"sap/m/HBox",
+					"sap/m/Title",
+					"sap/ui/core/library",
+					"sap/m/Text"
+				], function(Popover, Bar, HBox, Title, coreLib, Text) {
+					fnResolve({
+						Popover: Popover,
+						Bar: Bar,
+						HBox: HBox,
+						Title: Title,
+						coreLib: coreLib,
+						Text: Text
+					});
+				});
+			}),
+            Core.getLibraryResourceBundle('sap.m', true)
+		]).then(function(aResult) {
+			var oModules = aResult[0];
+			var oResourceBundle = aResult[1];
+			var sIconColor = oModules.coreLib.IconColor.Critical,
+			sTitleLevel = oModules.coreLib.TitleLevel.H2;
+
+			oSelectAllNotificationPopover = new oModules.Popover({
+				customHeader: new oModules.Bar({
+					contentMiddle: [
+						new oModules.HBox({
+							items: [
+								new oModules.coreLib.Icon({src: "sap-icon://message-warning", color: sIconColor})
+									.addStyleClass("sapUiTinyMarginEnd"),
+								new oModules.Title({text: oResourceBundle.getText("TABLE_SELECT_LIMIT_TITLE"), level: sTitleLevel})
+							],
+							renderType: "Bare",
+							justifyContent: "Center",
+							alignItems: "Center"
+						})
+					]
+				}),
+				content: [new oModules.Text()]
+			}).addStyleClass("sapUiContentPadding");
+			return {
+				oSelectAllNotificationPopover: oSelectAllNotificationPopover,
+				oResourceBundle: oResourceBundle
+			};
+		});
+		return pGetSelectAllPopover;
+	};
+
+	/**
+	 * Opens the Popover and sets the appropriate message.
+	 *
+	 * @param {int} iLimit The selectable items length
+	 * @param {object} oSelectAllDomRef Control object where the popOver is opened
+	 * @private
+	 * @since 1.109
+	 */
+	Util.showSelectionLimitPopover = function(iLimit, oSelectAllDomRef) {
+		Util.getSelectAllPopover().then(function(oResult) {
+			var oPopover = oResult.oSelectAllNotificationPopover;
+			var oResourceBundle = oResult.oResourceBundle;
+			var sMessage = oResourceBundle.getText("TABLE_SELECT_LIMIT", [iLimit]);
+			oPopover.getContent()[0].setText(sMessage); //Content contains a single text element
+			if (oSelectAllDomRef) {
+				oPopover.openBy(oSelectAllDomRef);
+			}
+		});
+	};
+
+	/**
+	 * Closes the popover if opened
+	 *
+	 * @private
+	 * @since 1.109
+	 */
+	Util.hideSelectionLimitPopover = function() {
+		if (oSelectAllNotificationPopover && oSelectAllNotificationPopover.isOpen()) {
+			oSelectAllNotificationPopover.close();
+		}
+	};
+
 	return Util;
 
-});
+});

package/src/sap/m/table/columnmenu/ActionItem.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 sap.ui.define([
@@ -11,41 +11,42 @@ sap.ui.define([
 	"use strict";
 
 	/**
-	 * Constructor for a new ActionItem.
+	 * Constructor for a new <code>ActionItem</code>.
 	 *
-	 * @param {string} [sId] ID for the new ActionItem, generated automatically if no ID is given
-	 * @param {object} [mSettings] Initial settings for the new ActionItem
+	 * @param {string} [sId] ID for the new <code>ActionItem</code>, generated automatically if no ID is given
+	 * @param {object} [mSettings] Initial settings for the new <code>ActionItem</code>
 	 *
 	 * @class
-	 * The ActionItem serves as a menu action item for the sap.m.table.columnmenu.Menu.
-	 * It can be used to specify control- and application-specific items which should solely serve as actions.
+	 * The <code>ActionItem</code> class is used for action items for the <code>sap.m.table.columnmenu.Menu</code>.
+	 * It can be used to specify control- and application-specific items that should solely serve as actions.
 	 *
 	 * @extends sap.m.table.columnmenu.ItemBase
 	 *
 	 * @author SAP SE
-	 * @version 1.108.2
+	 * @version 1.110.0
 	 *
-	 * @private
-	 * @experimental
+	 * @public
+	 * @since 1.110
 	 *
 	 * @alias sap.m.table.columnmenu.ActionItem
 	 */
 	var ActionItem = ItemBase.extend("sap.m.table.columnmenu.ActionItem", {
+
 		metadata: {
 			library: "sap.m",
 			properties: {
 				/**
-				 * Defines the label, which should be used for the buttons.
+				 * Defines the label that is used for the action item.
 				 */
 				label: {type: "string"},
 				/**
-				 * Defines the icon for the menu item.
+				 * Defines the icon for the action item.
 				 */
 				icon: {type: "sap.ui.core.URI"}
 			},
 			events: {
 				/**
-				 * This event will be fired, when the action was pressed.
+				 * This event is fired when the action item is pressed.
 				 */
 				press: {}
 			}

package/src/sap/m/table/columnmenu/Entry.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 sap.ui.define([
@@ -11,40 +11,44 @@ sap.ui.define([
 	"use strict";
 
 	/**
-	 * Constructor for a new Entry.
+	 * Constructor for a new <code>Entry</code>.
 	 *
-	 * @param {string} [sId] ID for the new Entry, generated automatically if no ID is given
-	 * @param {object} [mSettings] Initial settings for the new Entry
+	 * @param {string} [sId] ID for the new <code>Entry</code>, generated automatically if no ID is given
+	 * @param {object} [mSettings] Initial settings for the new <code>Entry</code>
 	 *
 	 * @class
-	 * The Entry serves as a base class for elements residing inside the sap.m.table.columnmenu.Menu.
-	 * This base class is faceless and should be inherited to implement Menu items and quick actions.
+	 * The <code>Entry</code> class is used as a base class for elements residing inside the <code>sap.m.table.columnmenu.Menu</code>.
+	 * This faceless class can be used to specify control- and application-specific menu items and quick actions.
 	 *
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.108.2
+	 * @version 1.110.0
 	 *
-	 * @private
-	 * @experimental
+	 * @public
+	 * @since 1.110
 	 *
 	 * @alias sap.m.table.columnmenu.Entry
 	 */
 	var Entry = Element.extend("sap.m.table.columnmenu.Entry", {
+
 		metadata: {
 			"abstract": true,
 			library: "sap.m",
 			properties: {
+				/**
+				 * Determines whether the entry is visible.
+				 */
 				visible: {type: "boolean", defaultValue: true}
 			}
 		}
 	});
 
 	/**
-	 * This method can be used to retrieve the Menu, in which the entry resides in.
+	 * Retrieves the <code>Menu</code> in which the entry resides.
 	 *
-	 * If an entry is internally creating entries that use #getMenu or #getParent,
-	 * and returns them in #getEffectiveItems or #getEffectiveQuickActions, they
+	 * If an entry is internally creating entries that use {@link #getMenu} or {@link #getParent},
+	 * and returns them in {@link #getEffectiveItems} or {@link #getEffectiveQuickActions}, they
 	 * must be its children in the control tree.
 	 *
 	 * @returns {sap.m.table.columnmenu.Menu} The menu of the entry
@@ -62,7 +66,7 @@ sap.ui.define([
 	};
 
 	/**
-	 * This method can be used to retrieve the label of an entry.
+	 * Retrieves the label of an entry.
 	 *
 	 * @returns {string} The label property specified in the control
 	 * @abstract
@@ -75,7 +79,7 @@ sap.ui.define([
 	};
 
 	/**
-	 * This method can be used to retrieve the content of an entry.
+	 * Retrieves the content of an entry.
 	 *
 	 * @returns {sap.ui.core.Control} The control specified in the content aggregation
 	 * @abstract

package/src/sap/m/table/columnmenu/Item.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 sap.ui.define([
@@ -11,71 +11,72 @@ sap.ui.define([
 	"use strict";
 
 	/**
-	 * Constructor for a new Item.
+	 * Constructor for a new <code>Item</code>.
 	 *
-	 * @param {string} [sId] ID for the new Item, generated automatically if no ID is given
-	 * @param {object} [mSettings] Initial settings for the new Item
+	 * @param {string} [sId] ID for the new <code>Item</code>, generated automatically if no ID is given
+	 * @param {object} [mSettings] Initial settings for the new <code>Item</code>
 	 *
 	 * @class
-	 * This Item serves as a menu item for the sap.m.table.columnmenu.Menu.
-	 * It can be used to specify control- and application-specific items.
+	 * The <code>Item</code> class is used for menu items for the <code>sap.m.table.columnmenu.Menu</code>.
+	 * It can be used to specify control- and application-specific menu items.
 	 *
 	 * @extends sap.m.table.columnmenu.ItemBase
 	 *
 	 * @author SAP SE
-	 * @version 1.108.2
+	 * @version 1.110.0
 	 *
-	 * @private
-	 * @experimental
+	 * @public
+	 * @since 1.110
 	 *
 	 * @alias sap.m.table.columnmenu.Item
 	 */
 	var Item = ItemBase.extend("sap.m.table.columnmenu.Item", {
+
 		metadata: {
 			library: "sap.m",
 			properties: {
 				/**
-				 * Defines the label, which should be used for the buttons.
+				 * Defines the label that is used for the item.
 				 */
 				label: {type: "string"},
 				/**
-				 * Defines the icon for the menu item.
+				 * Defines the icon for the item.
 				 */
 				icon: {type: "sap.ui.core.URI"},
 				/**
-				 * Defines whether the reset button should be shown, when navigating to the item.
+				 * Defines whether the Reset button is shown when navigating to the item.
 				 */
 				showResetButton: {type: "boolean", defaultValue: true},
 				/**
-				 * Defines whether the reset button should be enabled, when navigating to the item.
+				 * Defines whether the Reset button is enabled when navigating to the item.
 				 */
 				resetButtonEnabled: {type: "boolean", defaultValue: true},
 				/**
-				 * Defines whether the confirm button should be shown, when navigating to the item.
+				 * Defines whether the Confirm button is shown when navigating to the item.
 				 */
 				showConfirmButton: {type: "boolean", defaultValue: true},
 				/**
-				 * Defines whether the cancel button should be shown, when navigating to the item.
+				 * Defines whether the Cancel button is shown when navigating to the item.
 				 */
 				showCancelButton: {type: "boolean", defaultValue: true}
 			},
 			aggregations: {
 				/**
-				 * Defines the content, which should be shown when navigating to the item.
+				 * Defines the content that is shown when navigating to the item.
 				 */
 				content: {type: "sap.ui.core.Control", multiple: false}
 			},
 			events: {
 				/**
-				 * This event will be fired, when the reset button was pressed.
+				 * This event is fired when the Reset button is pressed.
 				 */
 				reset: {},
 				/**
-				 * This event will be fired, when the confirm button was pressed.
+				 * This event is fired when the Confirm button is pressed.
 				 */
 				confirm: {},
 				/**
-				 * This event will be fired, when the cancel button was pressed.
+				 * This event is fired when the Cancel button is pressed.
 				 */
 				cancel: {}
 			}