@openui5/ts-types 1.117.0 → 1.118.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,4 +1,4 @@
1
- // For Library Version: 1.117.0
1
+ // For Library Version: 1.118.0
2
2
 
3
3
  declare module "sap/ui/mdc/BaseDelegate" {
4
4
  import TypeMap from "sap/ui/mdc/util/TypeMap";
@@ -1602,6 +1602,34 @@ declare module "sap/ui/mdc/ValueHelpDelegate" {
1602
1602
  */
1603
1603
  iRequestedItems: int
1604
1604
  ): Promise<sap.ui.model.ListBinding>;
1605
+ /**
1606
+ * @since 1.118.0
1607
+ *
1608
+ * Find all conditions, which are represented by the given context for 'Select from list' scenarios. By
1609
+ * default, only condition keys are considered. This may be extended with payload dependent filters.
1610
+ *
1611
+ * Note: this method replaces the former `isFilterableListItemSelected`
1612
+ *
1613
+ * @returns Conditions represented by the given context
1614
+ */
1615
+ findConditionsForContext(
1616
+ /**
1617
+ * The `ValueHelp` control instance
1618
+ */
1619
+ oValueHelp: sap.ui.mdc.ValueHelp,
1620
+ /**
1621
+ * `ValueHelp` content instance
1622
+ */
1623
+ oContent: sap.ui.mdc.valuehelp.base.FilterableListContent,
1624
+ /**
1625
+ * Entry of a given list
1626
+ */
1627
+ oContext: sap.ui.model.Context,
1628
+ /**
1629
+ * current conditions
1630
+ */
1631
+ aConditions: sap.ui.mdc.condition.ConditionObject[]
1632
+ ): sap.ui.mdc.condition.ConditionObject[];
1605
1633
  /**
1606
1634
  * @since 1.106.0
1607
1635
  *
@@ -1696,32 +1724,6 @@ declare module "sap/ui/mdc/ValueHelpDelegate" {
1696
1724
  */
1697
1725
  oConditions: object
1698
1726
  ): object;
1699
- /**
1700
- * @since 1.101.0
1701
- *
1702
- * Provides the possibility to customize selections in 'Select from list' scenarios. By default, only condition
1703
- * keys are taken into consideration. This might be extended with payload dependent filters.
1704
- *
1705
- * @returns `true` if item is selected
1706
- */
1707
- isFilterableListItemSelected(
1708
- /**
1709
- * The `ValueHelp` control instance
1710
- */
1711
- oValueHelp: sap.ui.mdc.ValueHelp,
1712
- /**
1713
- * `ValueHelp` content instance
1714
- */
1715
- oContent: sap.ui.mdc.valuehelp.base.FilterableListContent,
1716
- /**
1717
- * Entry of a given list
1718
- */
1719
- oItem: sap.ui.core.Element,
1720
- /**
1721
- * current conditions
1722
- */
1723
- aConditions: sap.ui.mdc.condition.ConditionObject[]
1724
- ): boolean;
1725
1727
  /**
1726
1728
  * Checks if a `ListBinding` supports `$search`.
1727
1729
  *
@@ -3181,6 +3183,8 @@ declare namespace sap {
3181
3183
  * If set to a name of a data type an instance of this data type will be used.
3182
3184
  * If set to an object with structure {@link sap.ui.mdc.condition.ValueType} an instance of the corresponding
3183
3185
  * data type will be used. The type given via `name` must be loaded by the application.
3186
+ * If set to `null` the corresponding value is interpreted as description that holds no required data.
3187
+ * To display this value the additional `Type` of the `Field` or `FilterField` using the `Operator` is used.
3184
3188
  */
3185
3189
  valueTypes: string[] | object[];
3186
3190
  /**
@@ -4254,6 +4258,10 @@ declare namespace sap {
4254
4258
  * Type of the value of the condition (used for formatting, parsing and validating)
4255
4259
  */
4256
4260
  valueType?: sap.ui.model.Type;
4261
+ /**
4262
+ * Type of the additionalValue (description) of the condition (used for formatting, parsing and validating)
4263
+ */
4264
+ additionalValueType?: sap.ui.model.Type;
4257
4265
  /**
4258
4266
  * Possible operators to be used in the condition
4259
4267
  */
@@ -4290,9 +4298,13 @@ declare namespace sap {
4290
4298
  */
4291
4299
  additionalType?: sap.ui.model.Type;
4292
4300
  /**
4293
- * additional types used for parts of a `CompositeType`
4301
+ * additional types used for parts of a `CompositeType` (if valueType is a `CompositeType`)
4294
4302
  */
4295
4303
  compositeTypes?: sap.ui.model.Type[];
4304
+ /**
4305
+ * additional types used for parts of a `CompositeType` (if additionalValueType is a `CompositeType`)
4306
+ */
4307
+ additionalCompositeTypes?: sap.ui.model.Type[];
4296
4308
  /**
4297
4309
  * Function to get the existing conditions of the field.
4298
4310
  */
@@ -4452,6 +4464,10 @@ declare namespace sap {
4452
4464
  * Type of the value of the condition (used for formatting, parsing and validating)
4453
4465
  */
4454
4466
  valueType?: sap.ui.model.Type;
4467
+ /**
4468
+ * Type of the additionalValue (description) of the condition (used for formatting, parsing and validating)
4469
+ */
4470
+ additionalValueType?: sap.ui.model.Type;
4455
4471
  /**
4456
4472
  * Possible operators to be used in the condition
4457
4473
  */
@@ -4491,6 +4507,10 @@ declare namespace sap {
4491
4507
  * additional types used for parts of a `CompositeType`
4492
4508
  */
4493
4509
  compositeTypes?: sap.ui.model.Type[];
4510
+ /**
4511
+ * additional types used for parts of a `CompositeType` (if additionalValueType is a `CompositeType`)
4512
+ */
4513
+ additionalCompositeTypes?: sap.ui.model.Type[];
4494
4514
  /**
4495
4515
  * Function to get the existing conditions of the field.
4496
4516
  */
@@ -4639,9 +4659,13 @@ declare namespace sap {
4639
4659
  */
4640
4660
  oFormatOptions?: {
4641
4661
  /**
4642
- * Type of the value of the condition (used for formatting and parsing)
4662
+ * Type of the value of the condition (used for formatting, parsing and validating)
4643
4663
  */
4644
4664
  valueType?: sap.ui.model.Type;
4665
+ /**
4666
+ * Type of the additionalValue (description) of the condition (used for formatting, parsing and validating)
4667
+ */
4668
+ additionalValueType?: sap.ui.model.Type;
4645
4669
  /**
4646
4670
  * Possible operators to be used in the condition
4647
4671
  */
@@ -4653,7 +4677,7 @@ declare namespace sap {
4653
4677
  /**
4654
4678
  * ID of the value help to determine the key and description
4655
4679
  */
4656
- ValueHelpID?: string;
4680
+ valueHelpID?: string;
4657
4681
  /**
4658
4682
  * If set, only the value of the condition is shown, but no operator. (Use it only if just one operator
4659
4683
  * is supported.)
@@ -4674,11 +4698,19 @@ declare namespace sap {
4674
4698
  */
4675
4699
  originalDateType?: sap.ui.model.Type;
4676
4700
  /**
4677
- * If set, the type is used for the unit part of a field
4701
+ * additional type used on other part of a field. (For example, for unit fields.)
4678
4702
  */
4679
- isUnit?: boolean;
4703
+ additionalType?: sap.ui.model.Type;
4680
4704
  /**
4681
- * Function to get the existing conditions of the field. Only used if `isUnit` is set. TODO: better solution
4705
+ * additional types used for parts of a `CompositeType` (if valueType is a `CompositeType`)
4706
+ */
4707
+ compositeTypes?: sap.ui.model.Type[];
4708
+ /**
4709
+ * additional types used for parts of a `CompositeType` (if additionalValueType is a `CompositeType`)
4710
+ */
4711
+ additionalCompositeTypes?: sap.ui.model.Type[];
4712
+ /**
4713
+ * Function to get the existing conditions of the field.
4682
4714
  */
4683
4715
  getConditions?: Function;
4684
4716
  /**
@@ -4707,6 +4739,22 @@ declare namespace sap {
4707
4739
  * Name of the default `Operator`
4708
4740
  */
4709
4741
  defaultOperatorName?: string;
4742
+ /**
4743
+ * If set, whitespaces will be replaced by special characters to display whitespaces in HTML
4744
+ */
4745
+ convertWhitespaces?: boolean;
4746
+ /**
4747
+ * Instance of the calling control
4748
+ */
4749
+ control?: sap.ui.core.Control;
4750
+ /**
4751
+ * If set, the conditions will not be formatted (MultiInput value-property case)
4752
+ */
4753
+ noFormatting?: boolean;
4754
+ /**
4755
+ * If noFormatting is set, this value is used as output (To keep typed value during value help selection)
4756
+ */
4757
+ keepValue?: string;
4710
4758
  },
4711
4759
  /**
4712
4760
  * Value constraints
@@ -5186,6 +5234,20 @@ declare namespace sap {
5186
5234
  */
5187
5235
  mParameters?: sap.ui.mdc.field.FieldBase$SubmitEventParameters
5188
5236
  ): this;
5237
+ /**
5238
+ * @since 1.118.0
5239
+ * @ui5-protected Do not call from applications (only from related classes in the framework)
5240
+ *
5241
+ * Returns the configuration for the additional data type.
5242
+ *
5243
+ * In {@link sap.ui.mdc.Field Field} case it is determined from the binding of the `additionalValue` In
5244
+ * {@link sap.ui.mdc.MultiValueField MultiValueField} case it is determined from the binding of `description`
5245
+ * of an item In {@link sap.ui.mdc.FilterField FilterField} case it is provided via `additionalDataType`
5246
+ * property.
5247
+ *
5248
+ * @returns return a type instance ot a configuration object
5249
+ */
5250
+ getAdditionalDataTypeConfiguration(): sap.ui.model.Type | object;
5189
5251
  /**
5190
5252
  * Returns array of IDs of the elements which are the current targets of the association {@link #getAriaLabelledBy ariaLabelledBy}.
5191
5253
  */
@@ -7214,6 +7276,10 @@ declare namespace sap {
7214
7276
  * @returns Returns the validation status
7215
7277
  */
7216
7278
  checkFilters(): sap.ui.mdc.enums.FilterBarValidationStatus;
7279
+ /**
7280
+ * Clears non-model value for any filter field and resets the value state to none.
7281
+ */
7282
+ cleanUpAllFilterFieldsInErrorState(): void;
7217
7283
  /**
7218
7284
  * Destroys the basicSearchField in the aggregation {@link #getBasicSearchField basicSearchField}.
7219
7285
  *
@@ -7315,6 +7381,12 @@ declare namespace sap {
7315
7381
  * property.
7316
7382
  */
7317
7383
  getBasicSearchField(): sap.ui.mdc.FilterField;
7384
+ /**
7385
+ * Returns the external conditions.
7386
+ *
7387
+ * @returns Map containing the external conditions
7388
+ */
7389
+ getConditions(): Record<string, any>;
7318
7390
  /**
7319
7391
  * Returns the external conditions of the inner condition model. **Note:** This API returns only attributes
7320
7392
  * related to the {@link sap.ui.mdc.FilterBar#setP13nMode p13nMode} property configuration.
@@ -7803,7 +7875,7 @@ declare namespace sap {
7803
7875
  /**
7804
7876
  * Defines if the filter supports multiple values `-1` or single values `1`
7805
7877
  */
7806
- maxConditions: int;
7878
+ maxConditions?: int;
7807
7879
  };
7808
7880
 
7809
7881
  type FilterBarBase$FiltersChangedEvent = sap.ui.base.Event<
@@ -10596,9 +10668,13 @@ declare namespace sap {
10596
10668
  */
10597
10669
  value: any;
10598
10670
  /**
10599
- * Value parsed by type to fit the data type of the key
10671
+ * Value parsed by type of key to fit the data type of the key
10600
10672
  */
10601
10673
  parsedValue?: any;
10674
+ /**
10675
+ * Value parsed by type of description to fit the data type of the description
10676
+ */
10677
+ parsedDescription?: any;
10602
10678
  /**
10603
10679
  * Contextual information provided by condition `payload` or `inParameters`/`outParameters`. This is only
10604
10680
  * filled if the description needs to be determined for an existing condition.
@@ -10844,6 +10920,8 @@ declare namespace sap {
10844
10920
  table?: sap.m.Table;
10845
10921
 
10846
10922
  /**
10923
+ * @deprecated (since 1.118.0) - This event is not fired or consumed anymore
10924
+ *
10847
10925
  * This event is fired when the content of the table is updated.
10848
10926
  */
10849
10927
  contentUpdated?: (oEvent: sap.ui.base.Event) => void;
@@ -11513,6 +11591,8 @@ declare namespace sap {
11513
11591
  */
11514
11592
  static getMetadata(): sap.ui.core.ElementMetadata;
11515
11593
  /**
11594
+ * @deprecated (since 1.118.0) - This event is not fired or consumed anymore
11595
+ *
11516
11596
  * Attaches event handler `fnFunction` to the {@link #event:contentUpdated contentUpdated} event of this
11517
11597
  * `sap.ui.mdc.valuehelp.content.MTable`.
11518
11598
  *
@@ -11540,6 +11620,8 @@ declare namespace sap {
11540
11620
  oListener?: object
11541
11621
  ): this;
11542
11622
  /**
11623
+ * @deprecated (since 1.118.0) - This event is not fired or consumed anymore
11624
+ *
11543
11625
  * Attaches event handler `fnFunction` to the {@link #event:contentUpdated contentUpdated} event of this
11544
11626
  * `sap.ui.mdc.valuehelp.content.MTable`.
11545
11627
  *
@@ -11568,6 +11650,8 @@ declare namespace sap {
11568
11650
  */
11569
11651
  destroyTable(): this;
11570
11652
  /**
11653
+ * @deprecated (since 1.118.0) - This event is not fired or consumed anymore
11654
+ *
11571
11655
  * Detaches event handler `fnFunction` from the {@link #event:contentUpdated contentUpdated} event of this
11572
11656
  * `sap.ui.mdc.valuehelp.content.MTable`.
11573
11657
  *
@@ -11586,6 +11670,7 @@ declare namespace sap {
11586
11670
  oListener?: object
11587
11671
  ): this;
11588
11672
  /**
11673
+ * @deprecated (since 1.118.0) - This event is not fired or consumed anymore
11589
11674
  * @ui5-protected Do not call from applications (only from related classes in the framework)
11590
11675
  *
11591
11676
  * Fires event {@link #event:contentUpdated contentUpdated} to attached listeners.
@@ -11978,7 +12063,7 @@ declare namespace sap {
11978
12063
  interface $ActionToolbarActionSettings
11979
12064
  extends sap.ui.core.$ControlSettings {
11980
12065
  /**
11981
- * Layout information
12066
+ * Contains the information where the action is displayed on the `ActionToolbar`.
11982
12067
  */
11983
12068
  layoutInformation?:
11984
12069
  | object
@@ -11986,7 +12071,7 @@ declare namespace sap {
11986
12071
  | `{${string}}`;
11987
12072
 
11988
12073
  /**
11989
- * Action
12074
+ * The control that is displayed on the `ActionToolbar`.
11990
12075
  */
11991
12076
  action?: sap.ui.core.Control;
11992
12077
  }
@@ -11994,7 +12079,8 @@ declare namespace sap {
11994
12079
  /**
11995
12080
  * @since 1.58
11996
12081
  *
11997
- * The action for an {@link sap.ui.mdc.ActionToolbar ActionToolbar} control
12082
+ * The action for an {@link sap.ui.mdc.ActionToolbar ActionToolbar} control with given layout information
12083
+ * that determines where the wrapped control is displayed on the `ActionToolbar`.
11998
12084
  */
11999
12085
  class ActionToolbarAction
12000
12086
  extends sap.ui.core.Control
@@ -12080,13 +12166,13 @@ declare namespace sap {
12080
12166
  /**
12081
12167
  * Gets content of aggregation {@link #getAction action}.
12082
12168
  *
12083
- * Action
12169
+ * The control that is displayed on the `ActionToolbar`.
12084
12170
  */
12085
12171
  getAction(): sap.ui.core.Control;
12086
12172
  /**
12087
12173
  * Gets current value of property {@link #getLayoutInformation layoutInformation}.
12088
12174
  *
12089
- * Layout information
12175
+ * Contains the information where the action is displayed on the `ActionToolbar`.
12090
12176
  *
12091
12177
  * Default value is `...see text or source`.
12092
12178
  *
@@ -12107,7 +12193,7 @@ declare namespace sap {
12107
12193
  /**
12108
12194
  * Sets a new value for property {@link #getLayoutInformation layoutInformation}.
12109
12195
  *
12110
- * Layout information
12196
+ * Contains the information where the action is displayed on the `ActionToolbar`.
12111
12197
  *
12112
12198
  * When called with a value of `null` or `undefined`, the default value of the property will be restored.
12113
12199
  *
@@ -15463,6 +15549,19 @@ declare namespace sap {
15463
15549
  */
15464
15550
  propertyKey?: string | sap.ui.base.ManagedObject.PropertyBindingInfo;
15465
15551
 
15552
+ /**
15553
+ * @since 1.118.0
15554
+ *
15555
+ * The type of data for the description part of a equal-condition This type is used to parse, format, and
15556
+ * validate the value.
15557
+ *
15558
+ * Here a data type instance can be provided or an object containing `name`, `formatOptions` and `constraints`.
15559
+ */
15560
+ additionalDataType?:
15561
+ | object
15562
+ | sap.ui.base.ManagedObject.PropertyBindingInfo
15563
+ | `{${string}}`;
15564
+
15466
15565
  /**
15467
15566
  * This event is fired when the `value` property of the field is changed.
15468
15567
  *
@@ -15931,6 +16030,13 @@ declare namespace sap {
15931
16030
  */
15932
16031
  copyProvider?: sap.m.plugins.CopyProvider;
15933
16032
 
16033
+ /**
16034
+ * @since 1.118
16035
+ *
16036
+ * Defines the context menu for the table rows.
16037
+ */
16038
+ contextMenu?: sap.ui.core.IContextMenu;
16039
+
15934
16040
  /**
15935
16041
  * Control or object that enables the table to do filtering, such as {@link sap.ui.mdc.FilterBar}. See also
15936
16042
  * {@link sap.ui.mdc.IFilter}.
@@ -15962,6 +16068,15 @@ declare namespace sap {
15962
16068
  * This event is fired when the user pastes content from the clipboard to the table.
15963
16069
  */
15964
16070
  paste?: (oEvent: Table$PasteEvent) => void;
16071
+
16072
+ /**
16073
+ * @since 1.117
16074
+ *
16075
+ * This event is fired when the user requests the context menu for the table.
16076
+ */
16077
+ beforeOpenContextMenu?: (
16078
+ oEvent: Table$BeforeOpenContextMenuEvent
16079
+ ) => void;
15965
16080
  }
15966
16081
 
15967
16082
  interface $ValueHelpSettings extends sap.ui.mdc.$ElementSettings {
@@ -16185,6 +16300,19 @@ declare namespace sap {
16185
16300
  filterSettings?: object[];
16186
16301
  }
16187
16302
 
16303
+ interface Table$BeforeOpenContextMenuEventParameters {
16304
+ /**
16305
+ * The binding context
16306
+ */
16307
+ bindingContext?: sap.ui.model.Context;
16308
+
16309
+ /**
16310
+ * The column used for the context menu **Note:** The column parameter can be empty when opened in a popin
16311
+ * area for responsiveTable type.
16312
+ */
16313
+ column?: sap.ui.mdc.table.Column;
16314
+ }
16315
+
16188
16316
  interface Table$PasteEventParameters {
16189
16317
  /**
16190
16318
  * 2D array of strings with data from the clipboard. The first dimension represents the rows, and the second
@@ -17612,11 +17740,12 @@ declare namespace sap {
17612
17740
  * @since 1.61
17613
17741
  * @experimental (since 1.61)
17614
17742
  *
17615
- * The base class for MDC controls providing delegate-related functionality (see {@link sap.ui.mdc.mixin.DelegateMixin}).
17743
+ * The base class for controls in the `sap.ui.mdc` library providing delegate-related functionality (see
17744
+ * {@link sap.ui.mdc.mixin.DelegateMixin}).
17616
17745
  */
17617
17746
  class Control extends sap.ui.core.Control {
17618
17747
  /**
17619
- * Creates and initializes a new MDC control with the given `sId` and settings.
17748
+ * Creates and initializes a new control with the given `sId` and settings.
17620
17749
  *
17621
17750
  * Accepts an object literal `mSettings` that defines initial property values, aggregated and associated
17622
17751
  * objects as well as event handlers. See {@link sap.ui.base.ManagedObject#constructor} for a general description
@@ -17629,7 +17758,7 @@ declare namespace sap {
17629
17758
  mSettings?: sap.ui.mdc.$ControlSettings
17630
17759
  );
17631
17760
  /**
17632
- * Creates and initializes a new MDC control with the given `sId` and settings.
17761
+ * Creates and initializes a new control with the given `sId` and settings.
17633
17762
  *
17634
17763
  * Accepts an object literal `mSettings` that defines initial property values, aggregated and associated
17635
17764
  * objects as well as event handlers. See {@link sap.ui.base.ManagedObject#constructor} for a general description
@@ -17637,8 +17766,8 @@ declare namespace sap {
17637
17766
  */
17638
17767
  constructor(
17639
17768
  /**
17640
- * Optional ID for the new control; generated automatically if no non-empty ID is given Note: this can be
17641
- * omitted, no matter whether `mSettings` will be given or not!
17769
+ * Optional ID for the new control; generated automatically if no non-empty ID is given **Note:** This can
17770
+ * be omitted, no matter whether `mSettings` is given.
17642
17771
  */
17643
17772
  sId?: string,
17644
17773
  /**
@@ -17647,25 +17776,6 @@ declare namespace sap {
17647
17776
  mSettings?: sap.ui.mdc.$ControlSettings
17648
17777
  );
17649
17778
 
17650
- /**
17651
- * @ui5-protected Do not call from applications (only from related classes in the framework)
17652
- *
17653
- * Provides access to the delegate initialization `Promise`. **Note:** `initControlDelegate` must be called
17654
- * to start the delegate initialization
17655
- *
17656
- * @returns Returns a `Promise` reflecting the delegate initialization
17657
- */
17658
- static awaitControlDelegate(): Promise<
17659
- import("sap/ui/mdc/BaseDelegate").default
17660
- >;
17661
- /**
17662
- * @ui5-protected Do not call from applications (only from related classes in the framework)
17663
- *
17664
- * Provides access to the property helper initialization `Promise`.
17665
- *
17666
- * @returns Returns a `Promise` that resolves with the property helper
17667
- */
17668
- static awaitPropertyHelper(): Promise</* was: sap.ui.mdc.util.PropertyHelper */ any>;
17669
17779
  /**
17670
17780
  * Creates a new subclass of class sap.ui.mdc.Control with name `sClassName` and enriches it with the information
17671
17781
  * contained in `oClassInfo`.
@@ -17689,6 +17799,31 @@ declare namespace sap {
17689
17799
  */
17690
17800
  FNMetaImpl?: Function
17691
17801
  ): Function;
17802
+ /**
17803
+ * Returns a metadata object for class sap.ui.mdc.Control.
17804
+ *
17805
+ * @returns Metadata object describing this class
17806
+ */
17807
+ static getMetadata(): sap.ui.core.ElementMetadata;
17808
+ /**
17809
+ * @ui5-protected Do not call from applications (only from related classes in the framework)
17810
+ *
17811
+ * Provides access to the delegate initialization `Promise`. **Note:** `initControlDelegate` must be called
17812
+ * to start the delegate initialization
17813
+ *
17814
+ * @returns Returns a `Promise` reflecting the delegate initialization
17815
+ */
17816
+ awaitControlDelegate(): Promise<
17817
+ import("sap/ui/mdc/BaseDelegate").default
17818
+ >;
17819
+ /**
17820
+ * @ui5-protected Do not call from applications (only from related classes in the framework)
17821
+ *
17822
+ * Provides access to the property helper initialization `Promise`.
17823
+ *
17824
+ * @returns Returns a `Promise` that resolves with the property helper
17825
+ */
17826
+ awaitPropertyHelper(): Promise</* was: sap.ui.mdc.util.PropertyHelper */ any>;
17692
17827
  /**
17693
17828
  * @ui5-protected Do not call from applications (only from related classes in the framework)
17694
17829
  *
@@ -17696,7 +17831,7 @@ declare namespace sap {
17696
17831
  *
17697
17832
  * @returns Returns a `Promise` that resolves with the property helper
17698
17833
  */
17699
- static finalizePropertyHelper(
17834
+ finalizePropertyHelper(
17700
17835
  /**
17701
17836
  * optional set of initial properties
17702
17837
  */
@@ -17711,19 +17846,26 @@ declare namespace sap {
17711
17846
  *
17712
17847
  * @returns `typeUtil` made available by a delegate module
17713
17848
  */
17714
- static getControlDelegate(): import("sap/ui/mdc/BaseDelegate").default;
17849
+ getControlDelegate(): import("sap/ui/mdc/BaseDelegate").default;
17715
17850
  /**
17716
- * Returns a metadata object for class sap.ui.mdc.Control.
17851
+ * @experimental
17717
17852
  *
17718
- * @returns Metadata object describing this class
17853
+ * Gets current value of property {@link #getDelegate delegate}.
17854
+ *
17855
+ * Path to the `Delegate` module that provides the required APIs to execute model-specific logic.
17856
+ * **Note:** Ensure that the related file can be requested (any required library has to be loaded before
17857
+ * that).
17858
+ * Do not bind or modify the module. This property can only be configured during control initialization.
17859
+ *
17860
+ * @returns Value of property `delegate`
17719
17861
  */
17720
- static getMetadata(): sap.ui.core.ElementMetadata;
17862
+ getDelegate(): object;
17721
17863
  /**
17722
17864
  * Returns the payload object set for the delegate property.
17723
17865
  *
17724
17866
  * @returns Payload set for delegate property
17725
17867
  */
17726
- static getPayload(): object;
17868
+ getPayload(): object;
17727
17869
  /**
17728
17870
  * @ui5-protected Do not call from applications (only from related classes in the framework)
17729
17871
  *
@@ -17731,13 +17873,13 @@ declare namespace sap {
17731
17873
  *
17732
17874
  * @returns The property helper
17733
17875
  */
17734
- static getPropertyHelper(): /* was: sap.ui.mdc.util.PropertyHelper */ any;
17876
+ getPropertyHelper(): /* was: sap.ui.mdc.util.PropertyHelper */ any;
17735
17877
  /**
17736
17878
  * Returns the `TypeMap` made available by a delegate module.
17737
17879
  *
17738
17880
  * @returns `TypeMap` object
17739
17881
  */
17740
- static getTypeMap(): import("sap/ui/mdc/util/TypeMap").default;
17882
+ getTypeMap(): import("sap/ui/mdc/util/TypeMap").default;
17741
17883
  /**
17742
17884
  * @deprecated (since 1.115.0) - please see {@link #getTypeMap}
17743
17885
  * @ui5-protected Do not call from applications (only from related classes in the framework)
@@ -17746,7 +17888,7 @@ declare namespace sap {
17746
17888
  *
17747
17889
  * @returns `TypeUtil` object
17748
17890
  */
17749
- static getTypeUtil(): /* was: sap.ui.mdc.util.TypeUtil */
17891
+ getTypeUtil(): /* was: sap.ui.mdc.util.TypeUtil */
17750
17892
  | any
17751
17893
  | import("sap/ui/mdc/util/TypeMap").default;
17752
17894
  /**
@@ -17756,7 +17898,7 @@ declare namespace sap {
17756
17898
  *
17757
17899
  * @returns Returns a `Promise` that resolves the delegate module, if available
17758
17900
  */
17759
- static initControlDelegate(
17901
+ initControlDelegate(
17760
17902
  /**
17761
17903
  * Preloaded delegate module
17762
17904
  */
@@ -17769,7 +17911,7 @@ declare namespace sap {
17769
17911
  *
17770
17912
  * @returns Returns a `Promise` that resolves with the property helper
17771
17913
  */
17772
- static initPropertyHelper(
17914
+ initPropertyHelper(
17773
17915
  /**
17774
17916
  * Custom property helper class
17775
17917
  */
@@ -17790,20 +17932,7 @@ declare namespace sap {
17790
17932
  *
17791
17933
  * @returns Returns a `boolean` indicating the propertyHelper's final state
17792
17934
  */
17793
- static isPropertyHelperFinal(): boolean;
17794
- /**
17795
- * @experimental
17796
- *
17797
- * Gets current value of property {@link #getDelegate delegate}.
17798
- *
17799
- * Path to the `Delegate` module that provides the required APIs to execute model-specific logic.
17800
- * **Note:** Ensure that the related file can be requested (any required library has to be loaded before
17801
- * that).
17802
- * Do not bind or modify the module. This property can only be configured during control initialization.
17803
- *
17804
- * @returns Value of property `delegate`
17805
- */
17806
- getDelegate(): object;
17935
+ isPropertyHelperFinal(): boolean;
17807
17936
  /**
17808
17937
  * @experimental
17809
17938
  *
@@ -17829,11 +17958,12 @@ declare namespace sap {
17829
17958
  * @since 1.74
17830
17959
  * @experimental (since 1.74)
17831
17960
  *
17832
- * The base class for MDC composite elements providing delegate-related functionality (see {@link sap.ui.mdc.mixin.DelegateMixin}).
17961
+ * The base class for composite elements in the `sap.ui.mdc` library providing delegate-related functionality
17962
+ * (see {@link sap.ui.mdc.mixin.DelegateMixin}).
17833
17963
  */
17834
17964
  class Element extends sap.ui.core.Element {
17835
17965
  /**
17836
- * Creates and initializes a new MDC element with the given `sId` and settings.
17966
+ * Creates and initializes a new element with the given `sId` and settings.
17837
17967
  *
17838
17968
  * Accepts an object literal `mSettings` that defines initial property values, aggregated and associated
17839
17969
  * objects as well as event handlers. See {@link sap.ui.base.ManagedObject#constructor} for a general description
@@ -17846,7 +17976,7 @@ declare namespace sap {
17846
17976
  mSettings?: sap.ui.mdc.$ElementSettings
17847
17977
  );
17848
17978
  /**
17849
- * Creates and initializes a new MDC element with the given `sId` and settings.
17979
+ * Creates and initializes a new element with the given `sId` and settings.
17850
17980
  *
17851
17981
  * Accepts an object literal `mSettings` that defines initial property values, aggregated and associated
17852
17982
  * objects as well as event handlers. See {@link sap.ui.base.ManagedObject#constructor} for a general description
@@ -17854,8 +17984,8 @@ declare namespace sap {
17854
17984
  */
17855
17985
  constructor(
17856
17986
  /**
17857
- * Optional ID for the new element; generated automatically if no non-empty ID is given Note: this can be
17858
- * omitted, no matter whether `mSettings` will be given or not!
17987
+ * Optional ID for the new element; generated automatically if no non-empty ID is given **Note:** This can
17988
+ * be omitted, no matter whether `mSettings` is given.
17859
17989
  */
17860
17990
  sId?: string,
17861
17991
  /**
@@ -17864,25 +17994,6 @@ declare namespace sap {
17864
17994
  mSettings?: sap.ui.mdc.$ElementSettings
17865
17995
  );
17866
17996
 
17867
- /**
17868
- * @ui5-protected Do not call from applications (only from related classes in the framework)
17869
- *
17870
- * Provides access to the delegate initialization `Promise`. **Note:** `initControlDelegate` must be called
17871
- * to start the delegate initialization
17872
- *
17873
- * @returns Returns a `Promise` reflecting the delegate initialization
17874
- */
17875
- static awaitControlDelegate(): Promise<
17876
- import("sap/ui/mdc/BaseDelegate").default
17877
- >;
17878
- /**
17879
- * @ui5-protected Do not call from applications (only from related classes in the framework)
17880
- *
17881
- * Provides access to the property helper initialization `Promise`.
17882
- *
17883
- * @returns Returns a `Promise` that resolves with the property helper
17884
- */
17885
- static awaitPropertyHelper(): Promise</* was: sap.ui.mdc.util.PropertyHelper */ any>;
17886
17997
  /**
17887
17998
  * Creates a new subclass of class sap.ui.mdc.Element with name `sClassName` and enriches it with the information
17888
17999
  * contained in `oClassInfo`.
@@ -17906,6 +18017,31 @@ declare namespace sap {
17906
18017
  */
17907
18018
  FNMetaImpl?: Function
17908
18019
  ): Function;
18020
+ /**
18021
+ * Returns a metadata object for class sap.ui.mdc.Element.
18022
+ *
18023
+ * @returns Metadata object describing this class
18024
+ */
18025
+ static getMetadata(): sap.ui.core.ElementMetadata;
18026
+ /**
18027
+ * @ui5-protected Do not call from applications (only from related classes in the framework)
18028
+ *
18029
+ * Provides access to the delegate initialization `Promise`. **Note:** `initControlDelegate` must be called
18030
+ * to start the delegate initialization
18031
+ *
18032
+ * @returns Returns a `Promise` reflecting the delegate initialization
18033
+ */
18034
+ awaitControlDelegate(): Promise<
18035
+ import("sap/ui/mdc/BaseDelegate").default
18036
+ >;
18037
+ /**
18038
+ * @ui5-protected Do not call from applications (only from related classes in the framework)
18039
+ *
18040
+ * Provides access to the property helper initialization `Promise`.
18041
+ *
18042
+ * @returns Returns a `Promise` that resolves with the property helper
18043
+ */
18044
+ awaitPropertyHelper(): Promise</* was: sap.ui.mdc.util.PropertyHelper */ any>;
17909
18045
  /**
17910
18046
  * @ui5-protected Do not call from applications (only from related classes in the framework)
17911
18047
  *
@@ -17913,7 +18049,7 @@ declare namespace sap {
17913
18049
  *
17914
18050
  * @returns Returns a `Promise` that resolves with the property helper
17915
18051
  */
17916
- static finalizePropertyHelper(
18052
+ finalizePropertyHelper(
17917
18053
  /**
17918
18054
  * optional set of initial properties
17919
18055
  */
@@ -17928,19 +18064,26 @@ declare namespace sap {
17928
18064
  *
17929
18065
  * @returns `typeUtil` made available by a delegate module
17930
18066
  */
17931
- static getControlDelegate(): import("sap/ui/mdc/BaseDelegate").default;
18067
+ getControlDelegate(): import("sap/ui/mdc/BaseDelegate").default;
17932
18068
  /**
17933
- * Returns a metadata object for class sap.ui.mdc.Element.
18069
+ * @experimental
17934
18070
  *
17935
- * @returns Metadata object describing this class
18071
+ * Gets current value of property {@link #getDelegate delegate}.
18072
+ *
18073
+ * Path to the `Delegate` module that provides the required APIs to execute model-specific logic.
18074
+ * **Note:** Ensure that the related file can be requested (any required library has to be loaded before
18075
+ * that).
18076
+ * Do not bind or modify the module. This property can only be configured during control initialization.
18077
+ *
18078
+ * @returns Value of property `delegate`
17936
18079
  */
17937
- static getMetadata(): sap.ui.core.ElementMetadata;
18080
+ getDelegate(): object;
17938
18081
  /**
17939
18082
  * Returns the payload object set for the delegate property.
17940
18083
  *
17941
18084
  * @returns Payload set for delegate property
17942
18085
  */
17943
- static getPayload(): object;
18086
+ getPayload(): object;
17944
18087
  /**
17945
18088
  * @ui5-protected Do not call from applications (only from related classes in the framework)
17946
18089
  *
@@ -17948,13 +18091,13 @@ declare namespace sap {
17948
18091
  *
17949
18092
  * @returns The property helper
17950
18093
  */
17951
- static getPropertyHelper(): /* was: sap.ui.mdc.util.PropertyHelper */ any;
18094
+ getPropertyHelper(): /* was: sap.ui.mdc.util.PropertyHelper */ any;
17952
18095
  /**
17953
18096
  * Returns the `TypeMap` made available by a delegate module.
17954
18097
  *
17955
18098
  * @returns `TypeMap` object
17956
18099
  */
17957
- static getTypeMap(): import("sap/ui/mdc/util/TypeMap").default;
18100
+ getTypeMap(): import("sap/ui/mdc/util/TypeMap").default;
17958
18101
  /**
17959
18102
  * @deprecated (since 1.115.0) - please see {@link #getTypeMap}
17960
18103
  * @ui5-protected Do not call from applications (only from related classes in the framework)
@@ -17963,7 +18106,7 @@ declare namespace sap {
17963
18106
  *
17964
18107
  * @returns `TypeUtil` object
17965
18108
  */
17966
- static getTypeUtil(): /* was: sap.ui.mdc.util.TypeUtil */
18109
+ getTypeUtil(): /* was: sap.ui.mdc.util.TypeUtil */
17967
18110
  | any
17968
18111
  | import("sap/ui/mdc/util/TypeMap").default;
17969
18112
  /**
@@ -17973,7 +18116,7 @@ declare namespace sap {
17973
18116
  *
17974
18117
  * @returns Returns a `Promise` that resolves the delegate module, if available
17975
18118
  */
17976
- static initControlDelegate(
18119
+ initControlDelegate(
17977
18120
  /**
17978
18121
  * Preloaded delegate module
17979
18122
  */
@@ -17986,7 +18129,7 @@ declare namespace sap {
17986
18129
  *
17987
18130
  * @returns Returns a `Promise` that resolves with the property helper
17988
18131
  */
17989
- static initPropertyHelper(
18132
+ initPropertyHelper(
17990
18133
  /**
17991
18134
  * Custom property helper class
17992
18135
  */
@@ -18007,20 +18150,7 @@ declare namespace sap {
18007
18150
  *
18008
18151
  * @returns Returns a `boolean` indicating the propertyHelper's final state
18009
18152
  */
18010
- static isPropertyHelperFinal(): boolean;
18011
- /**
18012
- * @experimental
18013
- *
18014
- * Gets current value of property {@link #getDelegate delegate}.
18015
- *
18016
- * Path to the `Delegate` module that provides the required APIs to execute model-specific logic.
18017
- * **Note:** Ensure that the related file can be requested (any required library has to be loaded before
18018
- * that).
18019
- * Do not bind or modify the module. This property can only be configured during control initialization.
18020
- *
18021
- * @returns Value of property `delegate`
18022
- */
18023
- getDelegate(): object;
18153
+ isPropertyHelperFinal(): boolean;
18024
18154
  /**
18025
18155
  * @experimental
18026
18156
  *
@@ -18848,6 +18978,19 @@ declare namespace sap {
18848
18978
  */
18849
18979
  mParameters?: sap.ui.mdc.FilterField$ChangeEventParameters
18850
18980
  ): this;
18981
+ /**
18982
+ * @since 1.118.0
18983
+ *
18984
+ * Gets current value of property {@link #getAdditionalDataType additionalDataType}.
18985
+ *
18986
+ * The type of data for the description part of a equal-condition This type is used to parse, format, and
18987
+ * validate the value.
18988
+ *
18989
+ * Here a data type instance can be provided or an object containing `name`, `formatOptions` and `constraints`.
18990
+ *
18991
+ * @returns Value of property `additionalDataType`
18992
+ */
18993
+ getAdditionalDataType(): object;
18851
18994
  /**
18852
18995
  * @since 1.88.0
18853
18996
  *
@@ -18913,6 +19056,26 @@ declare namespace sap {
18913
19056
  */
18914
19057
  aOperators: sap.ui.mdc.condition.Operator[]
18915
19058
  ): void;
19059
+ /**
19060
+ * @since 1.118.0
19061
+ *
19062
+ * Sets a new value for property {@link #getAdditionalDataType additionalDataType}.
19063
+ *
19064
+ * The type of data for the description part of a equal-condition This type is used to parse, format, and
19065
+ * validate the value.
19066
+ *
19067
+ * Here a data type instance can be provided or an object containing `name`, `formatOptions` and `constraints`.
19068
+ *
19069
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
19070
+ *
19071
+ * @returns Reference to `this` in order to allow method chaining
19072
+ */
19073
+ setAdditionalDataType(
19074
+ /**
19075
+ * New value for property `additionalDataType`
19076
+ */
19077
+ oAdditionalDataType?: object
19078
+ ): this;
18916
19079
  /**
18917
19080
  * @since 1.88.0
18918
19081
  *
@@ -19619,6 +19782,57 @@ declare namespace sap {
19619
19782
  */
19620
19783
  oListener?: object
19621
19784
  ): this;
19785
+ /**
19786
+ * @since 1.117
19787
+ *
19788
+ * Attaches event handler `fnFunction` to the {@link #event:beforeOpenContextMenu beforeOpenContextMenu }
19789
+ * event of this `sap.ui.mdc.Table`.
19790
+ *
19791
+ * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
19792
+ * otherwise it will be bound to this `sap.ui.mdc.Table` itself.
19793
+ *
19794
+ * This event is fired when the user requests the context menu for the table.
19795
+ *
19796
+ * @returns Reference to `this` in order to allow method chaining
19797
+ */
19798
+ attachBeforeOpenContextMenu(
19799
+ /**
19800
+ * An application-specific payload object that will be passed to the event handler along with the event
19801
+ * object when firing the event
19802
+ */
19803
+ oData: object,
19804
+ /**
19805
+ * The function to be called when the event occurs
19806
+ */
19807
+ fnFunction: (p1: Table$BeforeOpenContextMenuEvent) => void,
19808
+ /**
19809
+ * Context object to call the event handler with. Defaults to this `sap.ui.mdc.Table` itself
19810
+ */
19811
+ oListener?: object
19812
+ ): this;
19813
+ /**
19814
+ * @since 1.117
19815
+ *
19816
+ * Attaches event handler `fnFunction` to the {@link #event:beforeOpenContextMenu beforeOpenContextMenu }
19817
+ * event of this `sap.ui.mdc.Table`.
19818
+ *
19819
+ * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
19820
+ * otherwise it will be bound to this `sap.ui.mdc.Table` itself.
19821
+ *
19822
+ * This event is fired when the user requests the context menu for the table.
19823
+ *
19824
+ * @returns Reference to `this` in order to allow method chaining
19825
+ */
19826
+ attachBeforeOpenContextMenu(
19827
+ /**
19828
+ * The function to be called when the event occurs
19829
+ */
19830
+ fnFunction: (p1: Table$BeforeOpenContextMenuEvent) => void,
19831
+ /**
19832
+ * Context object to call the event handler with. Defaults to this `sap.ui.mdc.Table` itself
19833
+ */
19834
+ oListener?: object
19835
+ ): this;
19622
19836
  /**
19623
19837
  * Attaches event handler `fnFunction` to the {@link #event:paste paste} event of this `sap.ui.mdc.Table`.
19624
19838
  *
@@ -19772,6 +19986,14 @@ declare namespace sap {
19772
19986
  * @returns Reference to `this` in order to allow method chaining
19773
19987
  */
19774
19988
  destroyColumns(): this;
19989
+ /**
19990
+ * @since 1.118
19991
+ *
19992
+ * Destroys the contextMenu in the aggregation {@link #getContextMenu contextMenu}.
19993
+ *
19994
+ * @returns Reference to `this` in order to allow method chaining
19995
+ */
19996
+ destroyContextMenu(): this;
19775
19997
  /**
19776
19998
  * @since 1.114
19777
19999
  *
@@ -19847,6 +20069,26 @@ declare namespace sap {
19847
20069
  */
19848
20070
  oListener?: object
19849
20071
  ): this;
20072
+ /**
20073
+ * @since 1.117
20074
+ *
20075
+ * Detaches event handler `fnFunction` from the {@link #event:beforeOpenContextMenu beforeOpenContextMenu }
20076
+ * event of this `sap.ui.mdc.Table`.
20077
+ *
20078
+ * The passed function and listener object must match the ones used for event registration.
20079
+ *
20080
+ * @returns Reference to `this` in order to allow method chaining
20081
+ */
20082
+ detachBeforeOpenContextMenu(
20083
+ /**
20084
+ * The function to be called, when the event occurs
20085
+ */
20086
+ fnFunction: (p1: Table$BeforeOpenContextMenuEvent) => void,
20087
+ /**
20088
+ * Context object on which the given function had to be called
20089
+ */
20090
+ oListener?: object
20091
+ ): this;
19850
20092
  /**
19851
20093
  * Detaches event handler `fnFunction` from the {@link #event:paste paste} event of this `sap.ui.mdc.Table`.
19852
20094
  *
@@ -19913,6 +20155,23 @@ declare namespace sap {
19913
20155
  */
19914
20156
  mParameters?: sap.ui.mdc.Table$BeforeExportEventParameters
19915
20157
  ): this;
20158
+ /**
20159
+ * @since 1.117
20160
+ * @ui5-protected Do not call from applications (only from related classes in the framework)
20161
+ *
20162
+ * Fires event {@link #event:beforeOpenContextMenu beforeOpenContextMenu} to attached listeners.
20163
+ *
20164
+ * Listeners may prevent the default action of this event by calling the `preventDefault` method on the
20165
+ * event object. The return value of this method indicates whether the default action should be executed.
20166
+ *
20167
+ * @returns Whether or not to prevent the default action
20168
+ */
20169
+ fireBeforeOpenContextMenu(
20170
+ /**
20171
+ * Parameters to pass along with the event
20172
+ */
20173
+ mParameters?: sap.ui.mdc.Table$BeforeOpenContextMenuEventParameters
20174
+ ): boolean;
19916
20175
  /**
19917
20176
  * @ui5-protected Do not call from applications (only from related classes in the framework)
19918
20177
  *
@@ -20018,6 +20277,14 @@ declare namespace sap {
20018
20277
  * Columns of the table.
20019
20278
  */
20020
20279
  getColumns(): sap.ui.mdc.table.Column[];
20280
+ /**
20281
+ * @since 1.118
20282
+ *
20283
+ * Gets content of aggregation {@link #getContextMenu contextMenu}.
20284
+ *
20285
+ * Defines the context menu for the table rows.
20286
+ */
20287
+ getContextMenu(): sap.ui.core.IContextMenu;
20021
20288
  /**
20022
20289
  * @since 1.114
20023
20290
  *
@@ -20592,6 +20859,19 @@ declare namespace sap {
20592
20859
  */
20593
20860
  iBusyIndicatorDelay?: int
20594
20861
  ): this;
20862
+ /**
20863
+ * @since 1.118
20864
+ *
20865
+ * Sets the aggregated {@link #getContextMenu contextMenu}.
20866
+ *
20867
+ * @returns Reference to `this` in order to allow method chaining
20868
+ */
20869
+ setContextMenu(
20870
+ /**
20871
+ * The contextMenu to set
20872
+ */
20873
+ oContextMenu: sap.ui.core.IContextMenu
20874
+ ): this;
20595
20875
  /**
20596
20876
  * @since 1.114
20597
20877
  *
@@ -22033,6 +22313,11 @@ declare namespace sap {
22033
22313
  Table
22034
22314
  >;
22035
22315
 
22316
+ type Table$BeforeOpenContextMenuEvent = sap.ui.base.Event<
22317
+ Table$BeforeOpenContextMenuEventParameters,
22318
+ Table
22319
+ >;
22320
+
22036
22321
  type Table$PasteEvent = sap.ui.base.Event<
22037
22322
  Table$PasteEventParameters,
22038
22323
  Table