@openui5/sap.m 1.120.6 → 1.121.0

package/src/sap/m/plugins/CellSelector.js

@@ -5,11 +5,12 @@
  */
 sap.ui.define([
 	"./PluginBase",
+	"sap/base/i18n/Localization",
+	"sap/base/util/deepEqual",
 	"sap/ui/events/KeyCodes",
-	"sap/ui/core/Core",
 	"sap/ui/core/Element",
 	"sap/base/Log"
-], function (PluginBase, KeyCodes, Core, Element, Log) {
+], function (PluginBase, Localization, deepEqual, KeyCodes, Element, Log) {
 	"use strict";
 
 	var DIRECTION = {
@@ -44,13 +45,14 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @extends sap.ui.core.Element
-	 * @version 1.120.6
+	 * @version 1.121.0
 	 * @author SAP SE
 	 *
 	 * @public
 	 * @experimental Since 1.119. This class is experimental. The API might be changed in the future.
 	 * @since 1.119
 	 * @alias sap.m.plugins.CellSelector
+	 * @borrows sap.m.plugins.PluginBase.findOn as findOn
 	 */
 	var CellSelector = PluginBase.extend("sap.m.plugins.CellSelector", /** @lends sap.m.plugins.CellSelector.prototype */  {
 		metadata: {
@@ -79,6 +81,19 @@ sap.ui.define([
 		}
 	});
 
+	CellSelector.findOn = PluginBase.findOn;
+
+	/**
+	 * A selection object representing the selected cells.
+	 *
+	 * The selection object contains the selected cells separated into rows and columns.
+	 * Rows are represented by their context, while columns are the column instance, which may vary depending on the table type.
+	 * @public
+	 * @typedef {object} sap.m.plugins.CellSelector.Selection
+	 * @property {sap.ui.model.Context[]} rows The row contexts of the selected cells.
+	 * @property {sap.ui.core.Element[]} columns The column instances of the selected cells; the content is based on the owner control.
+	 */
+
 	/**
 	 * Event Delegate that containts events, that need to be executed after control events.
 	 */
@@ -103,12 +118,15 @@ sap.ui.define([
 	 */
 	const PriorityDelegate = {
 		onBeforeRendering: function() {
-			this._iRtl = Core.getConfiguration().getRTL() ? -1 : 1;
+			this._iRtl = Localization.getRTL() ? -1 : 1;
 			if (this._oResizer) {
 				// remove resizer, as due to rerendering table element may be gone
 				this._oResizer.remove();
 				this._oResizer = null;
 			}
+			if (this._bSelecting) {
+				this.removeSelection();
+			}
 		},
 		onAfterRendering: function() {
 			this._deregisterEvents();
@@ -182,7 +200,7 @@ sap.ui.define([
 			var oSelectableCell = this._getSelectableCell(oEvent.target);
 			if (oSelectableCell) {
 				this._bMouseDown = true;
-				this._mClickedCell = this.getConfig("getCellInfo", this.getControl(), oSelectableCell);
+				this._mClickedCell = this._oPreviousCell = this.getConfig("getCellInfo", this.getControl(), oSelectableCell);
 			}
 		},
 		onmouseup: function(oEvent) {
@@ -190,6 +208,7 @@ sap.ui.define([
 			this._bBorderDown = false;
 			this._mClickedCell = undefined;
 			this._bScrolling = false;
+			this._oPreviousCell = undefined;
 			this._clearScroller();
 		}
 	};
@@ -204,7 +223,11 @@ sap.ui.define([
 			if (this._bScrolling) {
 				this._scrollSelect(this._oSession.scrollForward, this._oSession.isVertical, oEvent);
 			} else {
-				this._selectCells();
+				if (!this._oSession.mSource || !this._oSession.mTarget) {
+					return;
+				}
+				const mBounds = this._getNormalizedBounds(this._oSession.mSource, this._oSession.mTarget);
+				this._drawSelection(mBounds);
 			}
 		}.bind(this);
 		this._fnOnMouseEnter = this._onmouseenter.bind(this);
@@ -247,15 +270,31 @@ sap.ui.define([
 	 * Determines whether cells are selectable or not.
 	 *
 	 * @private
+	 * @returns {boolean} Whether cells are selectable or not
 	 * @ui5-restricted sap.m.plugins.CopyProvider
 	 */
 	CellSelector.prototype.isSelectable = function() {
 		return this.isActive() ? this.getConfig("isSupported", this.getControl()) : false;
 	};
 
+	/**
+	 * Determines whether there is a cell selection or not.
+	 *
+	 * @private
+	 * @returns {boolean} Whether there is a cell selection or not
+	 * @ui5-restricted sap.m.plugins.CopyProvider
+	 */
+	CellSelector.prototype.hasSelection = function() {
+		return Boolean(this._bSelecting && this._oSession?.mSource);
+	};
+
 	CellSelector.prototype._onSelectableChange = function() {
-		const oCopyProvider = this.getPlugin("sap.m.plugins.CopyProvider");
-		oCopyProvider?.onCellSelectorSelectableChange(this.isSelectable());
+		this.getPlugin("sap.m.plugins.CopyProvider")?.onCellSelectorSelectableChange(this);
+	};
+
+	CellSelector.prototype._onSelectionChange = function() {
+		/* @ui5-restricted sap.m.plugins.CopyProvider */
+		this.fireEvent("selectionChange");
 	};
 
 	CellSelector.prototype._registerEvents = function() {
@@ -290,15 +329,15 @@ sap.ui.define([
 
 	/**
 	 * Returns the cell selection range.
-	 * The value <code>Infinity</code> in <code>rowIndex</code> meant for until the limit is reached.
+	 * The value <code>Infinity</code> in <code>rowIndex</code> indicates that the limit is reached.
 	 *
-	 * Note: This method is subject to change.
+	 * <b>Note</b>: This method is subject to change.
+	 * @param {boolean} bIgnore Ignore group header rows within selection range
 	 * @returns {{from: {rowIndex: int, colIndex: int}, to: {rowIndex: int, colIndex: int}}  The range of the selection
-	 * @private
-	 * @experimental Since 1.110
 	 * @ui5-restricted sap.m.plugins.CopyProvider
+	 * @private
 	 */
-	CellSelector.prototype.getSelectionRange = function () {
+	CellSelector.prototype.getSelectionRange = function (bIgnore) {
 		if (!this._bSelecting) {
 			return null;
 		}
@@ -312,6 +351,18 @@ sap.ui.define([
 		mSelectionRange.from.colIndex = Math.max(mSelectionRange.from.colIndex, 0);
 		mSelectionRange.to.colIndex = Math.min(mSelectionRange.to.colIndex, iMaxColumnIndex);
 		mSelectionRange.from.rowIndex = Math.max(mSelectionRange.from.rowIndex, 0);
+
+		if (bIgnore) {
+			mSelectionRange.ignoredRows = [];
+			const aContexts = this.getSelectedRowContexts();
+			aContexts.forEach((oContext, iIndex) => {
+				const iRowIndex = mSelectionRange.from.rowIndex + iIndex;
+				if (isGroupRow(this._getBinding(), oContext, iRowIndex)) {
+					mSelectionRange.ignoredRows.push(iRowIndex);
+				}
+			});
+		}
+
 		return mSelectionRange;
 	};
 
@@ -321,7 +372,6 @@ sap.ui.define([
 	 * Note: This method is subject to change.
 	 * @returns {sap.ui.model.Context[]} The binding context of selected rows
 	 * @private
-	 * @experimental Since 1.110
 	 * @ui5-restricted sap.m.plugins.CopyProvider
 	 */
 	CellSelector.prototype.getSelectedRowContexts = function () {
@@ -330,7 +380,51 @@ sap.ui.define([
 			return [];
 		}
 
-		return this.getConfig("rowContexts", this.getControl(), mSelectionRange.from.rowIndex, mSelectionRange.to.rowIndex, this.getRangeLimit());
+		return this.getConfig("getSelectedRowContexts", this.getControl(), mSelectionRange.from.rowIndex, mSelectionRange.to.rowIndex, this.getRangeLimit());
+	};
+
+	/**
+	 * Returns the selected cells separated into the selected rows and columns.
+	 *
+	 * Example:
+	 * If the cells from (0, 0) to (2, 4) are selected, this method will return the following object:
+	 * <pre>
+	 * 	{
+	 * 		rows: [Row0_Context, Row1_Context, Row2_Context],
+	 * 		columns: [Column0, Column1, Column2, Column3, Column4]
+	 * 	}
+	 * </pre>
+	 *
+	 * <b>Note:</b> The content of the <code>rows</code> and <code>columns</code> depends on the owner control.
+	 * The type of the column that is returned depends on the table type for which the plugin is used (for example, <code>sap.ui.table.Column</code> for <code>sap.ui.table.Table</code>).
+	 *
+	 * @param {boolean} bIgnore Ignores group headers from selection
+	 * @returns {sap.m.plugins.CellSelector.Selection} An object containing the selected cells separated into rows and columns
+	 * @private
+	 * @ui5-restricted sap.fe, sap.suite.ui.generic.template
+	 */
+	CellSelector.prototype.getSelection = function(bIgnore) {
+		var mSelectionRange = this.getSelectionRange();
+		if (!mSelectionRange) {
+			return {rows: [], columns: []};
+		}
+
+		var aSelection = this.getConfig("getSelectedRowContexts", this.getControl(), mSelectionRange.from.rowIndex, mSelectionRange.to.rowIndex, this.getRangeLimit());
+		if (bIgnore) {
+			aSelection = aSelection.filter((oContext, iIndex) => !isGroupRow(this._getBinding(), oContext, iIndex + mSelectionRange.from.rowIndex));
+		}
+
+		var aSelectedColumns = this.getConfig("getVisibleColumns", this.getControl()).slice(mSelectionRange.from.colIndex, mSelectionRange.to.colIndex + 1);
+		if (this.getControl().getParent().isA("sap.ui.mdc.Table")) {
+			aSelectedColumns = aSelectedColumns.map(function(oSelectedColumn) {
+				return Element.getElementById(oSelectedColumn.getId().replace(/\-innerColumn$/, ""));
+			});
+		}
+
+		return {
+			rows: aSelection,
+			columns: aSelectedColumns
+		};
 	};
 
 	CellSelector.prototype._onsaparrowmodifiers = function(oEvent, sDirectionType, iRowDiff, iColDiff) {
@@ -392,11 +486,11 @@ sap.ui.define([
 
 		// If clicked cell (=starting cell) is equal to currently hovered cell, don't do anything
 		var oInfo = this.getConfig("getCellInfo", this.getControl(), oSelectableCell);
-		if (this._mClickedCell
-			&& oInfo.rowIndex == this._mClickedCell.rowIndex
-			&& oInfo.colIndex == this._mClickedCell.colIndex) {
+		if (oInfo.rowIndex == this._oPreviousCell?.rowIndex && oInfo.colIndex == this._oPreviousCell?.colIndex) {
+			// If currently hovered cell is the same as previous cell, nothing needs to be done.
 			return;
 		}
+		this._oPreviousCell = oInfo;
 
 		// Remove text selection during mouse cell selection
 		window.getSelection().removeAllRanges();
@@ -593,13 +687,11 @@ sap.ui.define([
 	 * @param {int} mTo.colIndex column index
 	 * @private
 	 */
-	CellSelector.prototype._selectCells = function (mFrom, mTo, mFocus) {
+	CellSelector.prototype._selectCells = function (mFrom, mTo) {
 		if (!this._bSelecting) {
 			return;
 		}
 
-		this._clearSelection();
-
 		mFrom = mFrom ? mFrom : this._oSession.mSource;
 		mTo = mTo ? mTo : this._oSession.mTarget;
 		var mBounds = this._getNormalizedBounds(mFrom, mTo);
@@ -610,8 +702,11 @@ sap.ui.define([
 
 		this._drawSelection(mBounds);
 
-		this._oSession.mSource = mFrom;
-		this._oSession.mTarget = mTo;
+		if (!deepEqual(this._oSession.mSource, mFrom) || !deepEqual(this._oSession.mTarget, mTo)) {
+			this._oSession.mSource = mFrom;
+			this._oSession.mTarget = mTo;
+			this._onSelectionChange();
+		}
 	};
 
 	/**
@@ -626,6 +721,8 @@ sap.ui.define([
 			return;
 		}
 
+		this._clearSelection();
+
 		this._oSession.cellRefs = [];
 		for (var iRow = mBounds.from.rowIndex; iRow <= mBounds.to.rowIndex; iRow++) {
 			for (var iCol = mBounds.from.colIndex; iCol <= mBounds.to.colIndex; iCol++) {
@@ -761,8 +858,12 @@ sap.ui.define([
 	CellSelector.prototype.removeSelection = function () {
 		this._clearSelection();
 
+		const bSelectionChange = this._oSession?.mSource || this._oSession?.mTarget;
 		this._bSelecting = false;
 		this._oSession = { cellRefs: [] };
+		if (bSelectionChange) {
+			this._onSelectionChange();
+		}
 	};
 
 	/**
@@ -798,10 +899,22 @@ sap.ui.define([
 		return !oEvent.isMarked?.() && this.getConfig("isSupported", this.getControl());
 	};
 
+	CellSelector.prototype._getBinding = function() {
+		return this.getConfig("getBinding", this.getControl());
+	};
+
 	function isCell(oTarget, sCell) {
 		return oTarget.classList.contains(sCell);
 	}
 
+	function isGroupRow(oBinding, oContext, iIndex) {
+		const oRowContext = oBinding?.getNodeByIndex?.(iIndex) ?? oContext;
+		if (oBinding?.nodeHasChildren) {
+			return oBinding.nodeHasChildren(oRowContext);
+		}
+		return !(oRowContext.getProperty("@ui5.node.isExpanded") === undefined);
+	}
+
 	/**
 	 * Check if the given key combination applies to the event.
 	 * @param {sap.ui.base.Event} oEvent event instance
@@ -872,7 +985,7 @@ sap.ui.define([
 				});
 				if (oRow) {
 					var oColumn = this.getVisibleColumns(oTable)[mPosition.colIndex];
-					var oCell = oColumn && oRow.getCells()[mPosition.colIndex];
+					var oCell = oColumn && oRow.getCells()[oColumn.getIndex()];
 					if (oCell) {
 						return oCell.$().closest(`.${this.selectableCells}`)[0];
 					}
@@ -903,7 +1016,7 @@ sap.ui.define([
 			getCellInfo: function (oTable, oTarget) {
 				return {
 					rowIndex: Element.closestTo(oTarget, true).getIndex(),
-					colIndex: this.getVisibleColumns(oTable).indexOf(Core.byId(oTarget.getAttribute("data-sap-ui-colid")))
+					colIndex: this.getVisibleColumns(oTable).indexOf(Element.getElementById(oTarget.getAttribute("data-sap-ui-colid")))
 				};
 			},
 			/**
@@ -929,7 +1042,7 @@ sap.ui.define([
 			 * @param {int} iLimit The range limit
 			 * @returns {sap.ui.model.Context[]} A portion of the row binding contexts
 			 */
-			rowContexts: function(oTable, iFromIndex, iToIndex, iLimit) {
+			getSelectedRowContexts: function(oTable, iFromIndex, iToIndex, iLimit) {
 				if (iToIndex == Infinity) {
 					var iMaxIndex = oTable.getBinding("rows").getAllCurrentContexts().length - 1;
 					iToIndex = Math.min(iToIndex, iFromIndex + iLimit - 1, iMaxIndex);
@@ -1026,6 +1139,9 @@ sap.ui.define([
 			},
 			_getSelectionOwner: function(oTable) {
 				return PluginBase.getPlugin(oTable, "sap.ui.table.plugins.SelectionPlugin") || oTable;
+			},
+			getBinding: function(oTable) {
+				return oTable.getBinding("rows");
 			}
 		}
 	}, CellSelector);

package/src/sap/m/plugins/ColumnResizer.js

@@ -6,25 +6,18 @@
 
 sap.ui.define([
 	"./PluginBase",
-	"sap/ui/core/Core",
+	"sap/base/i18n/Localization",
 	"sap/ui/core/Element",
 	"sap/ui/core/InvisibleText",
 	"sap/ui/Device",
 	"sap/m/ColumnPopoverActionItem",
 	"sap/m/table/columnmenu/QuickAction",
 	"sap/m/Button",
+	"sap/ui/core/Lib",
 	"sap/ui/thirdparty/jquery",
-	"sap/ui/dom/jquery/Aria" // jQuery Plugin "aria"
-], function(PluginBase,
-	Core,
-	Element,
-	InvisibleText,
-	Device,
-	ColumnPopoverActionItem,
-	QuickAction,
-	Button,
-	jQuery
-) {
+	// jQuery Plugin "aria"
+	"sap/ui/dom/jquery/Aria"
+], function(PluginBase, Localization, Element, InvisibleText, Device, ColumnPopoverActionItem, QuickAction, Button, Library, jQuery) {
 	"use strict";
 
 	/**
@@ -40,11 +33,12 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.core.Element
 	 * @author SAP SE
-	 * @version 1.120.6
+	 * @version 1.121.0
 	 *
 	 * @public
 	 * @since 1.91
 	 * @alias sap.m.plugins.ColumnResizer
+	 * @borrows sap.m.plugins.PluginBase.findOn as findOn
 	 */
 	var ColumnResizer = PluginBase.extend("sap.m.plugins.ColumnResizer", /** @lends sap.m.plugins.ColumnResizer.prototype */ { metadata: {
 		library: "sap.m",
@@ -75,12 +69,13 @@ sap.ui.define([
 	var oSession = {};
 	var bResizing = false;
 	var CSS_CLASS = "sapMPluginsColumnResizer";
-	var bRTL = Core.getConfiguration().getRTL();
+	var bRTL = Localization.getRTL();
 	var sBeginDirection = bRTL ? "right" : "left";
 	var sEndDirection = bRTL ? "left" : "right";
 	var iDirectionFactor = bRTL ? -1 : 1;
 
-	ColumnResizer.getPlugin = PluginBase.getPlugin;
+	//TBD Remove the ColumnResizer.getPlugin part when usages (SmartTable) are cleaned up and use findOn instead.
+	ColumnResizer.findOn = ColumnResizer.getPlugin = PluginBase.findOn;
 
 	ColumnResizer.prototype.init = function() {
 		this._iHoveredColumnIndex = -1;
@@ -516,7 +511,7 @@ sap.ui.define([
 
 		return new QuickAction({
 			content: new Button({
-				text: Core.getLibraryResourceBundle("sap.m").getText("table.COLUMNMENU_RESIZE"),
+				text: Library.getResourceBundleFor("sap.m").getText("table.COLUMNMENU_RESIZE"),
 				press: function() {
 					oColumnMenu.close();
 					this.startResizing(oColumn.getDomRef());
@@ -538,7 +533,7 @@ sap.ui.define([
 		}
 
 		return new ColumnPopoverActionItem({
-			text: Core.getLibraryResourceBundle("sap.m").getText("COLUMNRESIZER_RESIZE_BUTTON"),
+			text: Library.getResourceBundleFor("sap.m").getText("COLUMNRESIZER_RESIZE_BUTTON"),
 			icon: "sap-icon://resize-horizontal",
 			press: this.startResizing.bind(this, oColumn.getDomRef())
 		});

package/src/sap/m/plugins/ContextMenuSetting.js

@@ -0,0 +1,155 @@
+/*
+ * OpenUI5
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+sap.ui.define([
+	"sap/ui/core/Element",
+	"./PluginBase",
+    "../library",
+	"sap/ui/base/ManagedObjectObserver"
+], function(
+	Element,
+	PluginBase,
+    library,
+	ManagedObjectObserver
+) {
+
+	"use strict";
+
+    const ContextMenuScope = library.plugins.ContextMenuScope;
+    /**
+	 * Constructs an instance of sap.m.plugins.ContextMenuSetting
+	 *
+	 * @class Provides configuration options and an extended behavior for the context menu that is applied to the related control.
+	 * @extends sap.ui.core.Element
+	 * @author SAP SE
+	 * @version 1.121.0
+	 * @public
+	 * @since 1.121
+	 * @alias sap.m.plugins.ContextMenuSetting
+	 * @borrows sap.m.plugins.PluginBase.findOn as findOn
+	 */
+	const ContextMenuSetting = PluginBase.extend("sap.m.plugins.ContextMenuSetting", {metadata: {
+		library: "sap.m",
+		properties: {
+
+			/**
+			 * Defines the scope of the context menu actions.
+			 *
+			 * The scope of the context menu is visually represented to the user by providing a clear indication of the affected items.
+			 * The visual cues help users understand the potential impact of their actions.
+			 *
+			 * <b>Note:</b> The scope visualization is only supported if a <code>sap.m.Menu</code> is used as context menu.
+			 */
+			scope: {type: "sap.m.plugins.ContextMenuScope", group: "Behavior", defaultValue: ContextMenuScope.Default}
+		},
+		events: {}
+    }});
+
+	ContextMenuSetting.findOn = PluginBase.findOn;
+
+	ContextMenuSetting.prototype.init = function(oControl) {
+		this._oObserver = new ManagedObjectObserver(this._observeChanges.bind(this));
+	};
+
+	ContextMenuSetting.prototype.exit = function() {
+		this._oObserver.destroy();
+		this._oObserver = null;
+	};
+
+	ContextMenuSetting.prototype._observeChanges = function(mChange) {
+		if (mChange.mutation == "insert") {
+			this._monkeypatch(mChange.child);
+		} else {
+			this._cleanupMonkeypatch(mChange.child);
+		}
+	};
+
+	/**
+	 * Overrides the original openAsContextMenu
+	 *
+	 * @param {sap.ui.core.IContextMenu} oMenu Context Menu.
+	 */
+	ContextMenuSetting.prototype._monkeypatch = function(oMenu) {
+		if (!oMenu || !oMenu.isA("sap.m.Menu")) {
+			return;
+		}
+
+		const that = this;
+		this._original_openAsContextMenu = oMenu.openAsContextMenu;
+
+		oMenu.openAsContextMenu = function(oEvent, vActiveItem) {
+			if (that.getScope() !== ContextMenuScope.Selection) {
+				return that._original_openAsContextMenu.apply(this, arguments);
+			}
+
+			const oControl = that.getControl();
+			const aItems = that.getConfig("items", oControl);
+
+			if (vActiveItem instanceof HTMLElement) {
+				vActiveItem = Element.closestTo(vActiveItem, true);
+			}
+			const bActiveItemSelected = that.getConfig("isItemSelected", oControl, vActiveItem);
+
+			aItems.forEach((oItem) => {
+				const bItemSelected = that.getConfig("isItemSelected", oControl, oItem);
+				if (oItem !== vActiveItem && !(bActiveItemSelected && bItemSelected)) {
+					oItem.addStyleClass("sapMContextMenuSettingContentOpacity");
+				}
+			});
+
+			this.attachEventOnce("closed", () => {
+				aItems.forEach((oItem) => {
+					oItem.removeStyleClass("sapMContextMenuSettingContentOpacity");
+				});
+			});
+			return that._original_openAsContextMenu.apply(this, arguments);
+		};
+	};
+
+	ContextMenuSetting.prototype._cleanupMonkeypatch = function(oMenu) {
+		if (oMenu && this._original_openAsContextMenu) {
+			oMenu.openAsContextMenu = this._original_openAsContextMenu;
+			this._original_openAsContextMenu = null;
+		}
+	};
+
+	ContextMenuSetting.prototype.onActivate = function(oControl) {
+		const sAggr = this.getConfig("contextMenuAggregation");
+		this._monkeypatch(oControl.getAggregation(sAggr));
+		this._oObserver.observe(oControl, {aggregations: [sAggr]});
+	};
+
+	ContextMenuSetting.prototype.onDeactivate = function(oControl) {
+		const sAggr = this.getConfig("contextMenuAggregation");
+		this._cleanupMonkeypatch(oControl.getAggregation(sAggr));
+		this._oObserver?.unobserve(oControl, {aggregations: [sAggr]});
+	};
+
+	/**
+	 * Plugin-specific control configurations.
+	 */
+	PluginBase.setConfigs({
+		"sap.m.ListBase": {
+			items: function(oList) {
+				return oList.getItems();
+			},
+			isItemSelected: function(oTable, oItem) {
+				return oItem.getSelected();
+			},
+			contextMenuAggregation: "contextMenu"
+		},
+		"sap.ui.table.Table": {
+			items: function(oTable) {
+				return oTable.getRows();
+			},
+			isItemSelected: function(oTable, oItem) {
+				return oTable._getSelectionPlugin().isSelected(oItem);
+			},
+			contextMenuAggregation: "contextMenu"
+		}
+	}, ContextMenuSetting);
+
+	return ContextMenuSetting;
+});