@openui5/types 1.127.1 → 1.129.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.127.1
1
+ // For Library Version: 1.129.0
2
2
 
3
3
  declare module "sap/ui/mdc/AggregationBaseDelegate" {
4
4
  import BaseDelegate from "sap/ui/mdc/BaseDelegate";
@@ -235,6 +235,11 @@ declare module "sap/ui/mdc/ChartDelegate" {
235
235
  * **Note:** The result of this function must be kept stable throughout the lifecycle of your application.
236
236
  * Any changes of the returned values might result in undesired effects.
237
237
  *
238
+ * **Note**: Existing properties (set via `sap.ui.mdc.Chart#setPropertyInfo`) must not be removed and their
239
+ * attributes must not be changed during the {@link module:sap/ui/mdc/ChartDelegate.fetchProperties fetchProperties }
240
+ * callback. Otherwise validation errors might occur whenever personalization-related control features (such
241
+ * as the opening of any personalization dialog) are activated.
242
+ *
238
243
  *
239
244
  * @returns Array of the property infos that is used within the chart
240
245
  */
@@ -743,8 +748,11 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" {
743
748
 
744
749
  import ContentMode from "sap/ui/mdc/enums/ContentMode";
745
750
 
751
+ import UI5Element from "sap/ui/core/Element";
752
+
746
753
  import {
747
754
  default as ValueHelp,
755
+ ValueHelpItem,
748
756
  ItemForValueConfiguration,
749
757
  } from "sap/ui/mdc/ValueHelp";
750
758
 
@@ -867,11 +875,13 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" {
867
875
  ): undefined | object;
868
876
  /**
869
877
  * Provides the possibility to customize / replace the internal content of a field
878
+ * By default, this method returns suitable controls for the given {@link sap.ui.mdc.enums.BaseType BaseType},
879
+ * {@link sap.ui.mdc.field.FieldBase#setMaxConditions maxConditions} and {@link sap.ui.mdc.enums.ContentMode ContentMode}.
870
880
  *
871
881
  * @since 1.124.0
872
882
  * @ui5-protected Do not call from applications (only from related classes in the framework)
873
883
  *
874
- * @returns Array containing the created controls
884
+ * @returns Array containing the created controls and the default value help, if needed
875
885
  */
876
886
  createContent(
877
887
  /**
@@ -885,8 +895,12 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" {
885
895
  /**
886
896
  * ID of the internal control to be created.
887
897
  */
888
- sId: string
889
- ): Promise<Control[]>;
898
+ sId: string,
899
+ /**
900
+ * If set, a default value help should be provided.
901
+ */
902
+ bProvideDefaultValueHelp: boolean
903
+ ): Promise<UI5Element[]>;
890
904
  /**
891
905
  * Determines the text for the autocomplete functionality.
892
906
  *
@@ -895,7 +909,7 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" {
895
909
  *
896
910
  * The returned text will be shown as selected after the user input ends.
897
911
  *
898
- * By Default this method uses the {@link sap.ui.mdc.field.FieldBase#getDisplay display} property of the
912
+ * By default this method uses the {@link sap.ui.mdc.field.FieldBase#getDisplay display} property of the
899
913
  * {@link sap.ui.mdc.Field Field}, {@link sap.ui.mdc.FilterField FilterField}, or {@link sap.ui.mdc.MultiValueField MultiValueField }
900
914
  * control to determine what text (key or description) is used as autocomplete-text. A text is only used
901
915
  * if it matches the user input. If set to `Value`, the key is used. If set to `Description`, the description
@@ -962,7 +976,7 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" {
962
976
  */
963
977
  oField: FieldBase,
964
978
  /**
965
- * Field help assigned to the {@link sap.ui.mdc.Field Field}, {@link sap.ui.mdc.FilterField FilterField},
979
+ * Value help assigned to the {@link sap.ui.mdc.Field Field}, {@link sap.ui.mdc.FilterField FilterField},
966
980
  * or {@link sap.ui.mdc.MultiValueField MultiValueField} control
967
981
  */
968
982
  oValueHelp: ValueHelp,
@@ -984,13 +998,13 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" {
984
998
  */
985
999
  oBindingContext: Context,
986
1000
  /**
987
- * `ConditionModel`, if bound to one - NO LONGER USED
1001
+ * NO LONGER USED
988
1002
  */
989
- oConditionModel: undefined,
1003
+ oDoNotUse: undefined,
990
1004
  /**
991
- * Name of the `ConditionModel`, if bound to one - NO LONGER USED
1005
+ * NO LONGER USED
992
1006
  */
993
- sConditionModelName: undefined,
1007
+ sDoNotUse: undefined,
994
1008
  /**
995
1009
  * Additional context information for this key
996
1010
  */
@@ -1003,10 +1017,7 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" {
1003
1017
  * Type of the value
1004
1018
  */
1005
1019
  oType: Type
1006
- ):
1007
- | string
1008
- | /* was: sap.ui.mdc.valuehelp.ValueHelpItem */ any
1009
- | Promise<string | /* was: sap.ui.mdc.valuehelp.ValueHelpItem */ any>;
1020
+ ): string | ValueHelpItem | Promise<string | ValueHelpItem>;
1010
1021
  /**
1011
1022
  * Determines the description for a given key.
1012
1023
  * By default, this method calls the {@link sap.ui.mdc.ValueHelp#getItemForValue getItemForValue} function
@@ -1033,7 +1044,7 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" {
1033
1044
  */
1034
1045
  oField: FieldBase,
1035
1046
  /**
1036
- * Field help assigned to the {@link sap.ui.mdc.Field Field}, {@link sap.ui.mdc.FilterField FilterField},
1047
+ * Value help assigned to the {@link sap.ui.mdc.Field Field}, {@link sap.ui.mdc.FilterField FilterField},
1037
1048
  * or {@link sap.ui.mdc.MultiValueField MultiValueField} control
1038
1049
  */
1039
1050
  oValueHelp: ValueHelp,
@@ -1055,9 +1066,9 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" {
1055
1066
  */
1056
1067
  oBindingContext: Context,
1057
1068
  /**
1058
- * `ConditionModel`, if bound to one - NO LONGER USED
1069
+ * NO LONGER USED
1059
1070
  */
1060
- oConditionModel: undefined,
1071
+ oDoNotUse: undefined,
1061
1072
  /**
1062
1073
  * Additional context information for this key
1063
1074
  */
@@ -1070,10 +1081,7 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" {
1070
1081
  * Type of the value
1071
1082
  */
1072
1083
  oType: Type
1073
- ):
1074
- | string
1075
- | /* was: sap.ui.mdc.valuehelp.ValueHelpItem */ any
1076
- | Promise<string | /* was: sap.ui.mdc.valuehelp.ValueHelpItem */ any>;
1084
+ ): string | ValueHelpItem | Promise<string | ValueHelpItem>;
1077
1085
  /**
1078
1086
  * Determines the description for a given key.
1079
1087
  * By default, this method calls the {@link sap.ui.mdc.ValueHelp#getItemForValue getItemForValue} function
@@ -1100,7 +1108,7 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" {
1100
1108
  */
1101
1109
  oField: FieldBase,
1102
1110
  /**
1103
- * Field help assigned to the {@link sap.ui.mdc.Field Field}, {@link sap.ui.mdc.FilterField FilterField},
1111
+ * Value help assigned to the {@link sap.ui.mdc.Field Field}, {@link sap.ui.mdc.FilterField FilterField},
1104
1112
  * or {@link sap.ui.mdc.MultiValueField MultiValueField} control
1105
1113
  */
1106
1114
  oValueHelp: ValueHelp,
@@ -1122,9 +1130,9 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" {
1122
1130
  */
1123
1131
  oBindingContext: Context,
1124
1132
  /**
1125
- * Name of the `ConditionModel`, if bound to one - NO LONGER USED
1133
+ * NO LONGER USED
1126
1134
  */
1127
- sConditionModelName: undefined,
1135
+ sDoNotUse: undefined,
1128
1136
  /**
1129
1137
  * Additional context information for this key
1130
1138
  */
@@ -1137,10 +1145,7 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" {
1137
1145
  * Type of the value
1138
1146
  */
1139
1147
  oType: Type
1140
- ):
1141
- | string
1142
- | /* was: sap.ui.mdc.valuehelp.ValueHelpItem */ any
1143
- | Promise<string | /* was: sap.ui.mdc.valuehelp.ValueHelpItem */ any>;
1148
+ ): string | ValueHelpItem | Promise<string | ValueHelpItem>;
1144
1149
  /**
1145
1150
  * Determines the description for a given key.
1146
1151
  * By default, this method calls the {@link sap.ui.mdc.ValueHelp#getItemForValue getItemForValue} function
@@ -1167,7 +1172,7 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" {
1167
1172
  */
1168
1173
  oField: FieldBase,
1169
1174
  /**
1170
- * Field help assigned to the {@link sap.ui.mdc.Field Field}, {@link sap.ui.mdc.FilterField FilterField},
1175
+ * Value help assigned to the {@link sap.ui.mdc.Field Field}, {@link sap.ui.mdc.FilterField FilterField},
1171
1176
  * or {@link sap.ui.mdc.MultiValueField MultiValueField} control
1172
1177
  */
1173
1178
  oValueHelp: ValueHelp,
@@ -1200,10 +1205,7 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" {
1200
1205
  * Type of the value
1201
1206
  */
1202
1207
  oType: Type
1203
- ):
1204
- | string
1205
- | /* was: sap.ui.mdc.valuehelp.ValueHelpItem */ any
1206
- | Promise<string | /* was: sap.ui.mdc.valuehelp.ValueHelpItem */ any>;
1208
+ ): string | ValueHelpItem | Promise<string | ValueHelpItem>;
1207
1209
  /**
1208
1210
  * Determines the key, description, and payload of a user input.
1209
1211
  * By default, this method calls the {@link sap.ui.mdc.ValueHelp#getItemForValue getItemForValue} function
@@ -1224,7 +1226,7 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" {
1224
1226
  */
1225
1227
  oField: FieldBase,
1226
1228
  /**
1227
- * Field help assigned to the {@link sap.ui.mdc.Field Field}, {@link sap.ui.mdc.FilterField FilterField},
1229
+ * Value help assigned to the {@link sap.ui.mdc.Field Field}, {@link sap.ui.mdc.FilterField FilterField},
1228
1230
  * or {@link sap.ui.mdc.MultiValueField MultiValueField} control
1229
1231
  */
1230
1232
  oValueHelp: ValueHelp,
@@ -1232,9 +1234,37 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" {
1232
1234
  * Configuration
1233
1235
  */
1234
1236
  oConfig?: ItemForValueConfiguration
1235
- ): /* was: sap.ui.mdc.valuehelp.ValueHelpItem */
1236
- | any
1237
- | Promise</* was: sap.ui.mdc.valuehelp.ValueHelpItem */ any>;
1237
+ ): ValueHelpItem | Promise<ValueHelpItem>;
1238
+ /**
1239
+ * Returns the index of a condition in an array of conditions.
1240
+ *
1241
+ * This function is called when a `Condition` is created by user input or value help selection to determine
1242
+ * if a similar `Condition` already exists. This is done to prevent duplicates.
1243
+ *
1244
+ * By default, if a `ValueHelp` exists, the `ValueHelp` logic is used to compare each condition. (See {@link module:sap/ui/mdc/ValueHelpDelegate.compareConditions ValueHelpDelegate.compareConditions})
1245
+ *
1246
+ * @ui5-protected Do not call from applications (only from related classes in the framework)
1247
+ *
1248
+ * @returns Index of the condition, -1 if not found
1249
+ */
1250
+ indexOfCondition(
1251
+ /**
1252
+ * `Field` control instance
1253
+ */
1254
+ oField: FieldBase,
1255
+ /**
1256
+ * Value help assigned to the `Field` or `FilterField` control
1257
+ */
1258
+ oValueHelp: ValueHelp,
1259
+ /**
1260
+ * Condition to check
1261
+ */
1262
+ oCondition: ConditionObject,
1263
+ /**
1264
+ * Array of conditions
1265
+ */
1266
+ aConditions: ConditionObject[]
1267
+ ): int;
1238
1268
  /**
1239
1269
  * Checks if entered text matches text found from value help
1240
1270
  *
@@ -1464,6 +1494,11 @@ declare module "sap/ui/mdc/FilterBarDelegate" {
1464
1494
  * **Note:** The result of this function must be kept stable throughout the lifecycle of your application.
1465
1495
  * Any changes of the returned values might result in undesired effects.
1466
1496
  *
1497
+ * **Note**: Existing properties (set via `sap.ui.mdc.filterbar.FilterBarBase#setPropertyInfo`) must not
1498
+ * be removed and their attributes must not be changed during the {@link module:sap/ui/mdc/FilterBarDelegate.fetchProperties fetchProperties }
1499
+ * callback. Otherwise validation errors might occur whenever personalization-related control features (such
1500
+ * as the opening of any personalization dialog) are activated.
1501
+ *
1467
1502
  *
1468
1503
  * @returns `Promise` that resolves into an array of property info objects
1469
1504
  */
@@ -1611,11 +1646,7 @@ declare module "sap/ui/mdc/LinkDelegate" {
1611
1646
  /**
1612
1647
  * Binding context of the `Link` control
1613
1648
  */
1614
- oBindingContext: Context | null | undefined,
1615
- /**
1616
- * InfoLog of the `Link` control
1617
- */
1618
- oInfoLog: /* was: sap.ui.mdc.link.Log */ any
1649
+ oBindingContext: Context | null | undefined
1619
1650
  ): Promise<null | LinkItem[]>;
1620
1651
  /**
1621
1652
  * Calculates and returns the type of link that is displayed.
@@ -1824,9 +1855,9 @@ declare module "sap/ui/mdc/odata/v4/TableDelegate" {
1824
1855
  */
1825
1856
  getInResultPropertyKeys(
1826
1857
  /**
1827
- * of the table
1858
+ * Instance of the table
1828
1859
  */
1829
- Instance: Table
1860
+ oTable: Table
1830
1861
  ): string[];
1831
1862
  /**
1832
1863
  * Updates the binding of the table with the binding info object returned from {@link module:sap/ui/mdc/TableDelegate.updateBindingInfo updateBindingInfo}.
@@ -2029,6 +2060,11 @@ declare module "sap/ui/mdc/TableDelegate" {
2029
2060
  * **Note:** The result of this function must be kept stable throughout the lifecycle of your application.
2030
2061
  * Any changes of the returned values might result in undesired effects.
2031
2062
  *
2063
+ * **Note**: Existing properties (set via `sap.ui.mdc.Table#setPropertyInfo`) must not be removed and their
2064
+ * attributes must not be changed during the {@link module:sap/ui/mdc/TableDelegate.fetchProperties fetchProperties }
2065
+ * callback. Otherwise validation errors might occur whenever personalization-related control features (such
2066
+ * as the opening of any personalization dialog) are activated.
2067
+ *
2032
2068
  * @ui5-protected Do not call from applications (only from related classes in the framework)
2033
2069
  *
2034
2070
  * @returns A `Promise` that resolves with the property information
@@ -2456,6 +2492,8 @@ declare module "sap/ui/mdc/ValueHelpDelegate" {
2456
2492
 
2457
2493
  import Content from "sap/ui/mdc/valuehelp/base/Content";
2458
2494
 
2495
+ import ValueHelpSelectionType from "sap/ui/mdc/enums/ValueHelpSelectionType";
2496
+
2459
2497
  import ValueHelpPropagationReason from "sap/ui/mdc/enums/ValueHelpPropagationReason";
2460
2498
 
2461
2499
  import Container from "sap/ui/mdc/valuehelp/base/Container";
@@ -2620,8 +2658,9 @@ declare module "sap/ui/mdc/ValueHelpDelegate" {
2620
2658
  /**
2621
2659
  * Returns filters that are used when updating the binding of the `ValueHelp`.
2622
2660
  * By default, this method returns a set of {@link sap.ui.model.Filter Filters} originating from an available
2623
- * {@link sap.ui.mdc.FilterBar FilterBar}, the delegate's own {@link #getFilterConditions}, and/or the {@link sap.ui.mdc.valuehelp.base.FilterableListContent#getFilterFields filterFields }
2624
- * configuration of the given {@link sap.ui.mdc.valuehelp.base.FilterableListContent FilterableListContent}.
2661
+ * {@link sap.ui.mdc.FilterBar FilterBar}, the delegate's own {@link module:sap/ui/mdc/ValueHelpDelegate.getFilterConditions getFilterConditions},
2662
+ * and/or the {@link sap.ui.mdc.valuehelp.base.FilterableListContent#getFilterFields filterFields} configuration
2663
+ * of the given {@link sap.ui.mdc.valuehelp.base.FilterableListContent FilterableListContent}.
2625
2664
  *
2626
2665
  * @since 1.121
2627
2666
  * @ui5-protected Do not call from applications (only from related classes in the framework)
@@ -2645,14 +2684,15 @@ declare module "sap/ui/mdc/ValueHelpDelegate" {
2645
2684
  * By default, this method searches and returns an entry from a set of relevant contexts of the given {@link sap.ui.mdc.valuehelp.base.ListContent ListContent}.
2646
2685
  *
2647
2686
  * To determine which columns are relevant for the search, the currently active displayMode {@link sap.ui.mdc.enums.FieldDisplay Display }
2648
- * of the connected control will be used. While a 'Value' configuration will lead to a 'key'-only search,
2649
- * 'DescriptionValue' leads to searching 'description' first and 'key' afterwards. Other modes work accordingly.
2687
+ * of the connected control will be used. While a `Value` configuration will lead to a 'key'-only search,
2688
+ * `DescriptionValue` leads to searching the description first and the key afterwards. Other modes work
2689
+ * the same way.
2650
2690
  *
2651
2691
  * For each relevant column all items are searched for an exact match first and again with a startsWith
2652
2692
  * filter afterwards, if necessary.
2653
2693
  *
2654
- * If the caseSensitive property is disabled, the letter case of the user's input and the corresponding
2655
- * column value are completely ignored. Whichever entry comes first, wins.
2694
+ * If the `caseSensitive` property is disabled, whichever entry comes first, wins, whether the user's input
2695
+ * is in lowercase or uppercase letters.
2656
2696
  *
2657
2697
  * {@link sap.ui.mdc.valuehelp.base.ListContent ListContent}
2658
2698
  *
@@ -2732,9 +2772,9 @@ declare module "sap/ui/mdc/ValueHelpDelegate" {
2732
2772
  ): boolean;
2733
2773
  /**
2734
2774
  * Determines is the filtering used for type-ahead is case sensitive.
2735
- * By default the value of the {@link sap.ui.mdc.base.ListContent#getCaseSensitive CaseSensitive} property
2736
- * of the content instance is returned. If `$search` or other methods are used this might depend on the
2737
- * backend logic.
2775
+ * By default the value of the {@link sap.ui.mdc.valuehelp.base.ListContent#getCaseSensitive CaseSensitive }
2776
+ * property of the content instance is returned. If `$search` or other methods are used this might depend
2777
+ * on the backend logic.
2738
2778
  *
2739
2779
  * @since 1.121.0
2740
2780
  *
@@ -2778,7 +2818,7 @@ declare module "sap/ui/mdc/ValueHelpDelegate" {
2778
2818
  *
2779
2819
  * @since 1.101.0
2780
2820
  *
2781
- * @returns oRestult Selection event configuration object
2821
+ * @returns oResult Selection event configuration object
2782
2822
  */
2783
2823
  modifySelectionBehaviour(
2784
2824
  /**
@@ -2796,11 +2836,11 @@ declare module "sap/ui/mdc/ValueHelpDelegate" {
2796
2836
  /**
2797
2837
  * Type of the selection change (add, remove)
2798
2838
  */
2799
- type: /* was: sap.ui.mdc.enums.ValueHelpSelectionType */ any;
2839
+ type: ValueHelpSelectionType | keyof typeof ValueHelpSelectionType;
2800
2840
  /**
2801
- * Array of changed conditions with structure {@link sap.ui.mdc.condition.ConditionObject ConditionObject}
2841
+ * Array of changed conditions
2802
2842
  */
2803
- conditions: object[];
2843
+ conditions: ConditionObject[];
2804
2844
  }
2805
2845
  ): object;
2806
2846
  /**
@@ -2975,6 +3015,17 @@ declare module "sap/ui/mdc/library" {
2975
3015
 
2976
3016
  import BaseType from "sap/ui/mdc/enums/BaseType";
2977
3017
 
3018
+ import Control from "sap/ui/core/Control";
3019
+
3020
+ import {
3021
+ ItemForValueConfiguration,
3022
+ ValueHelpItem,
3023
+ } from "sap/ui/mdc/ValueHelp";
3024
+
3025
+ import FormatException from "sap/ui/model/FormatException";
3026
+
3027
+ import ParseException from "sap/ui/model/ParseException";
3028
+
2978
3029
  /**
2979
3030
  * Interface for controls or entities which can serve as filters in the `sap.ui.mdc.Table` & `sap.ui.mdc.Chart`.
2980
3031
  *
@@ -3197,6 +3248,291 @@ declare module "sap/ui/mdc/library" {
3197
3248
  baseType?: BaseType | keyof typeof BaseType;
3198
3249
  };
3199
3250
  }
3251
+
3252
+ export namespace valuehelp {
3253
+ namespace base {
3254
+ /**
3255
+ * Interface for valuehelp containers shown on a dialog
3256
+ *
3257
+ * @since 1.95
3258
+ */
3259
+ interface IDialogContainer {
3260
+ __implements__sap_ui_mdc_valuehelp_base_IDialogContainer: boolean;
3261
+
3262
+ /**
3263
+ * Closes the container
3264
+ */
3265
+ close(): void;
3266
+ /**
3267
+ * Opens the container
3268
+ *
3269
+ *
3270
+ * @returns This promise resolves after the container completely opened.
3271
+ */
3272
+ open(
3273
+ /**
3274
+ * Promise for content request
3275
+ */
3276
+ oValueHelpContentPromise: Promise<any>,
3277
+ /**
3278
+ * Flag indicating whether the container is opened as type-ahead or dialog-like help
3279
+ */
3280
+ bTypeahead: boolean
3281
+ ): Promise<any>;
3282
+ }
3283
+
3284
+ /**
3285
+ * Interface for valuehelp containers / contents supporting dialog functionality
3286
+ *
3287
+ * @since 1.95
3288
+ */
3289
+ interface IDialogContent {
3290
+ __implements__sap_ui_mdc_valuehelp_base_IDialogContent: boolean;
3291
+
3292
+ /**
3293
+ * Returns number of relevant conditions for this content
3294
+ *
3295
+ *
3296
+ * @returns Number of relevant conditions
3297
+ */
3298
+ getCount(
3299
+ /**
3300
+ * Array of conditions
3301
+ */
3302
+ aConditions: ConditionObject[]
3303
+ ): number;
3304
+ /**
3305
+ * Loads additional dependencies, creates and returns displayed content.
3306
+ *
3307
+ *
3308
+ * @returns Promise resolving in displayed content
3309
+ */
3310
+ getContent(): Promise<Control>;
3311
+ /**
3312
+ * Returns a title for the given Content
3313
+ *
3314
+ *
3315
+ * @returns Content title as string
3316
+ */
3317
+ getTitle(): string;
3318
+ /**
3319
+ * Returns info if the given content is in multi select mode
3320
+ *
3321
+ *
3322
+ * @returns `true` if multi-selection is active.
3323
+ */
3324
+ isMultiSelect(): boolean;
3325
+ }
3326
+
3327
+ /**
3328
+ * Interface for valuehelp {@link sap.ui.mdc.valuehelp.base.Container Containers} supporting typeahead functionality
3329
+ *
3330
+ * @since 1.95
3331
+ */
3332
+ interface ITypeaheadContainer {
3333
+ __implements__sap_ui_mdc_valuehelp_base_ITypeaheadContainer: boolean;
3334
+
3335
+ /**
3336
+ * Closes the container
3337
+ */
3338
+ close(): void;
3339
+ /**
3340
+ * Determines the item (key and description) for a given value.
3341
+ *
3342
+ * The value help checks if there is an item with a key or description that fits this value.
3343
+ *
3344
+ * **Note:** This function must only be called by the control the `ValuedHelp` element belongs to, not by
3345
+ * the application.
3346
+ *
3347
+ *
3348
+ * @returns Promise returning object containing description, key and payload.
3349
+ */
3350
+ getItemForValue(
3351
+ /**
3352
+ * Configuration
3353
+ */
3354
+ oConfig: ItemForValueConfiguration
3355
+ ): Promise<ValueHelpItem>;
3356
+ /**
3357
+ * If the container is used for type-ahead it might be wanted that the same content should also be shown
3358
+ * as valuehelp. If not, the field should not show a valuehelp icon.
3359
+ *
3360
+ *
3361
+ * @returns `true` if the typeahead content can be used as value help
3362
+ */
3363
+ getUseAsValueHelp(): boolean;
3364
+ /**
3365
+ * Defines if the typeahead can be used for input validation.
3366
+ *
3367
+ *
3368
+ * @returns True if the typeahead container can be used for input validation
3369
+ */
3370
+ isValidationSupported(): boolean;
3371
+ /**
3372
+ * Navigates the typeaheads values (optional)
3373
+ *
3374
+ * As this could be asyncronous as data might be loaded a promise is returned.
3375
+ *
3376
+ *
3377
+ * @returns Promise fulfilled after navigation is evecuted
3378
+ */
3379
+ navigate(
3380
+ /**
3381
+ * Number of steps for navigation (e.g. 1 means next item, -1 means previous item)
3382
+ */
3383
+ iStep: int
3384
+ ): Promise<object>;
3385
+ /**
3386
+ * Opens the container
3387
+ *
3388
+ *
3389
+ * @returns This promise resolves after the container completely opened.
3390
+ */
3391
+ open(
3392
+ /**
3393
+ * Promise for content request
3394
+ */
3395
+ oValueHelpContentPromise: Promise<any>,
3396
+ /**
3397
+ * Flag indicating whether the container is opened as type-ahead or dialog-like help
3398
+ */
3399
+ bTypeahead: boolean
3400
+ ): Promise<any>;
3401
+ /**
3402
+ * The focus visualization of the field help needs to be removed as the user starts typing into the source
3403
+ * control.
3404
+ */
3405
+ removeVisualFocus(): void;
3406
+ /**
3407
+ * The focus visualization of the field help needs to be set as the user starts naigation into the value
3408
+ * help items.
3409
+ *
3410
+ * @since 1.127.0
3411
+ */
3412
+ setVisualFocus(): void;
3413
+ /**
3414
+ * Defines if the typeahead container desires to be opened whenever a user clicks on a connected control
3415
+ *
3416
+ *
3417
+ * @returns If `true`, the value help should open when user clicks into the connected field control
3418
+ */
3419
+ shouldOpenOnClick(): Promise<boolean>;
3420
+ /**
3421
+ * Defines if the typeahead container desires to be opened whenever a user focuses a connected control
3422
+ *
3423
+ *
3424
+ * @returns If `true`, the value help should open when user focuses the connected field control
3425
+ */
3426
+ shouldOpenOnFocus(): Promise<boolean>;
3427
+ /**
3428
+ * Defines if the typeahead containers values can be navigated without visibly opening the help
3429
+ *
3430
+ *
3431
+ * @returns If `true`, the value help should open when user used the arrow keys in the connected field control
3432
+ */
3433
+ shouldOpenOnNavigate(): boolean;
3434
+ }
3435
+
3436
+ /**
3437
+ * Interface for valuehelp {@link sap.ui.mdc.valuehelp.base.Container Containers} / {@link sap.ui.mdc.valuehelp.base.Content Contents }
3438
+ * supporting typeahead functionality
3439
+ *
3440
+ * @since 1.95
3441
+ */
3442
+ interface ITypeaheadContent {
3443
+ __implements__sap_ui_mdc_valuehelp_base_ITypeaheadContent: boolean;
3444
+
3445
+ /**
3446
+ * Loads additional dependencies, creates and returns displayed content.
3447
+ *
3448
+ *
3449
+ * @returns Promise resolving in displayed content
3450
+ */
3451
+ getContent(): Promise<Control>;
3452
+ /**
3453
+ * Determines the item (key and description) for a given value.
3454
+ *
3455
+ * The content checks if there is an item with a key or description that fits this value.
3456
+ *
3457
+ * **Note:** This function must only be called by the `Container` element.
3458
+ *
3459
+ *
3460
+ * @returns Promise returning object containing description, key and payload.
3461
+ */
3462
+ getItemForValue(
3463
+ /**
3464
+ * Configuration
3465
+ */
3466
+ oConfig: ItemForValueConfiguration
3467
+ ): Promise<ValueHelpItem>;
3468
+ /**
3469
+ * Returns a title for the given Content
3470
+ *
3471
+ *
3472
+ * @returns Content title as string
3473
+ */
3474
+ getTitle(): string;
3475
+ /**
3476
+ * If the container is used for typeahead it might be wanted that the same content should also be shown
3477
+ * as valuehelp. If not, the field should not show a valuehelp icon.
3478
+ *
3479
+ *
3480
+ * @returns `true` if the typeahead content can be used as value help
3481
+ */
3482
+ getUseAsValueHelp(): boolean;
3483
+ /**
3484
+ * Returns info if the given content is in multi select mode
3485
+ *
3486
+ *
3487
+ * @returns `true` if multi-selection is active.
3488
+ */
3489
+ isMultiSelect(): boolean;
3490
+ /**
3491
+ * Defines if the typeahead can be used for input validation.
3492
+ *
3493
+ *
3494
+ * @returns True if the typeahead container can be used for input validation
3495
+ */
3496
+ isValidationSupported(): boolean;
3497
+ /**
3498
+ * Navigates the typeaheads values (optional)
3499
+ */
3500
+ navigate(
3501
+ /**
3502
+ * Number of steps for navigation (e.g. 1 means next item, -1 means previous item)
3503
+ */
3504
+ iStep: int
3505
+ ): void;
3506
+ /**
3507
+ * The focus visualization of the field help needs to be removed as the user starts typing into the source
3508
+ * control.
3509
+ */
3510
+ removeVisualFocus(): void;
3511
+ /**
3512
+ * The focus visualization of the field help needs to be set as the user starts naigation into the value
3513
+ * help items.
3514
+ *
3515
+ * @since 1.127.0
3516
+ */
3517
+ setVisualFocus(): void;
3518
+ /**
3519
+ * Defines if the typeahead content desires opening the typeahead whenever a user clicks on a connected
3520
+ * control
3521
+ *
3522
+ *
3523
+ * @returns If `true`, the value help should open when user clicks into the connected field control
3524
+ */
3525
+ shouldOpenOnClick(): boolean;
3526
+ /**
3527
+ * Defines if the typeahead containers values can be navigated without visibly opening the help
3528
+ *
3529
+ *
3530
+ * @returns If `true`, the value help should open when user used the arrow keys in the connected field control
3531
+ */
3532
+ shouldOpenOnNavigate(): boolean;
3533
+ }
3534
+ }
3535
+ }
3200
3536
  }
3201
3537
 
3202
3538
  declare module "sap/ui/mdc/actiontoolbar/ActionToolbarAction" {
@@ -3404,7 +3740,7 @@ declare module "sap/ui/mdc/Chart" {
3404
3740
 
3405
3741
  /**
3406
3742
  * The `Chart` control creates a chart based on metadata and the configuration specified.
3407
- * **Note:** The inner chart needs to be assigned `ChartDelegate`.
3743
+ * **Note:** The inner chart needs to be created inside the `ChartDelegate`.
3408
3744
  *
3409
3745
  * @since 1.88
3410
3746
  * @experimental (since 1.88)
@@ -4252,7 +4588,7 @@ declare module "sap/ui/mdc/Chart" {
4252
4588
  /**
4253
4589
  * The aggregation method used if the property is aggregatable
4254
4590
  */
4255
- aggregationMethod: string;
4591
+ aggregationMethod?: string;
4256
4592
  /**
4257
4593
  * Defines the role that the property visualizes inside the chart
4258
4594
  */
@@ -4279,9 +4615,9 @@ declare module "sap/ui/mdc/Chart" {
4279
4615
  */
4280
4616
  unitPath?: object;
4281
4617
  /**
4282
- * The timeUnit type for a TimeDimension
4618
+ * The `timeUnitType` type for a `TimeDimension`. If set, a `TimeDimension` is created instead of a `Dimension`
4283
4619
  */
4284
- timeUnitType?: object;
4620
+ timeUnitType?: string;
4285
4621
  };
4286
4622
 
4287
4623
  /**
@@ -4417,7 +4753,10 @@ declare module "sap/ui/mdc/Chart" {
4417
4753
  * Specifies the chart metadata.
4418
4754
  * **Note:** This property must not be bound.
4419
4755
  * **Note:** This property is exclusively used for handling SAPUI5 flexibility changes. Do not use it otherwise.
4420
- *
4756
+ * **Note**: Existing properties (set via `sap.ui.mdc.Chart#setPropertyInfo`) must not be removed and their
4757
+ * attributes must not be changed during the {@link module:sap/ui/mdc/ChartDelegate.fetchProperties fetchProperties }
4758
+ * callback. Otherwise validation errors might occur whenever personalization-related control features (such
4759
+ * as the opening of any personalization dialog) are activated.
4421
4760
  *
4422
4761
  * **Note**: For more information about the supported inner elements, see {@link sap.ui.mdc.chart.PropertyInfo PropertyInfo}.
4423
4762
  *
@@ -5496,8 +5835,7 @@ declare module "sap/ui/mdc/condition/Condition" {
5496
5835
  import ConditionValidated from "sap/ui/mdc/enums/ConditionValidated";
5497
5836
 
5498
5837
  /**
5499
- * Utilities to create conditions to be used in {@link sap.ui.mdc.FilterField FilterField}, {@link sap.ui.mdc.FilterBar FilterBar},
5500
- * or {@link sap.ui.mdc.condition.ConditionModel ConditionModel}.
5838
+ * Utilities to create conditions to be used in {@link sap.ui.mdc.FilterField FilterField} or {@link sap.ui.mdc.FilterBar FilterBar}.
5501
5839
  *
5502
5840
  * @since 1.61.0
5503
5841
  */
@@ -5526,7 +5864,7 @@ declare module "sap/ui/mdc/condition/Condition" {
5526
5864
  */
5527
5865
  oOutParameters: object,
5528
5866
  /**
5529
- * If set to `ConditionValidated.Validated`, the condition is validated (by the field help) and not shown
5867
+ * If set to `ConditionValidated.Validated`, the condition is validated (by the value help) and not shown
5530
5868
  * in the {@link sap.ui.mdc.valuehelp.content.Conditions Conditions} content
5531
5869
  */
5532
5870
  sValidated: ConditionValidated | keyof typeof ConditionValidated,
@@ -5555,7 +5893,7 @@ declare module "sap/ui/mdc/condition/Condition" {
5555
5893
  */
5556
5894
  oInParameters: object,
5557
5895
  /**
5558
- * If set to `ConditionValidated.Validated`, the condition is validated (by the field help) and not shown
5896
+ * If set to `ConditionValidated.Validated`, the condition is validated (by the value help) and not shown
5559
5897
  * in the {@link sap.ui.mdc.valuehelp.content.Conditions Conditions} content
5560
5898
  */
5561
5899
  sValidated: ConditionValidated | keyof typeof ConditionValidated,
@@ -5584,7 +5922,7 @@ declare module "sap/ui/mdc/condition/Condition" {
5584
5922
  */
5585
5923
  oOutParameters: object,
5586
5924
  /**
5587
- * If set to `ConditionValidated.Validated`, the condition is validated (by the field help) and not shown
5925
+ * If set to `ConditionValidated.Validated`, the condition is validated (by the value help) and not shown
5588
5926
  * in the {@link sap.ui.mdc.valuehelp.content.Conditions Conditions} content
5589
5927
  */
5590
5928
  sValidated: ConditionValidated | keyof typeof ConditionValidated,
@@ -5609,7 +5947,7 @@ declare module "sap/ui/mdc/condition/Condition" {
5609
5947
  */
5610
5948
  aValues: any[],
5611
5949
  /**
5612
- * If set to `ConditionValidated.Validated`, the condition is validated (by the field help) and not shown
5950
+ * If set to `ConditionValidated.Validated`, the condition is validated (by the value help) and not shown
5613
5951
  * in the {@link sap.ui.mdc.valuehelp.content.Conditions Conditions} content
5614
5952
  */
5615
5953
  sValidated: ConditionValidated | keyof typeof ConditionValidated,
@@ -5629,9 +5967,9 @@ declare module "sap/ui/mdc/condition/Condition" {
5629
5967
  */
5630
5968
  createItemCondition(
5631
5969
  /**
5632
- * Operator for the condition
5970
+ * Key value for the condition
5633
5971
  */
5634
- sKey: string,
5972
+ vKey: any,
5635
5973
  /**
5636
5974
  * Description of the operator
5637
5975
  */
@@ -5663,7 +6001,7 @@ declare module "sap/ui/mdc/condition/Condition" {
5663
6001
  operator: string;
5664
6002
  /**
5665
6003
  * Array of values of the condition. Depending on the `operator`, this contains one or more entries. The
5666
- * entries are sored in internal format regarding the used data type.
6004
+ * entries are stored in an internal format regarding the used data type.
5667
6005
  */
5668
6006
  values: any[];
5669
6007
  /**
@@ -5815,15 +6153,15 @@ declare module "sap/ui/mdc/condition/FilterOperatorUtil" {
5815
6153
  ): void;
5816
6154
  /**
5817
6155
  * Removes all given operators from the list of known operators.
6156
+ *
6157
+ * **Note**: `aOperators` can be the name of an {@link sap.ui.mdc.condition.Operator Operator}, the instance
6158
+ * itself, or multiple operators inside an array.
5818
6159
  */
5819
6160
  removeOperators(
5820
6161
  /**
5821
6162
  * Array of operators
5822
- *
5823
- * **Note**: `aOperators` can be the name of an {@link sap.ui.mdc.condition.Operator Operator}, the instance
5824
- * itself, or multiple operators inside an array.
5825
6163
  */
5826
- aOperators: Operator[]
6164
+ aOperators: Operator[] | Operator | string[]
5827
6165
  ): void;
5828
6166
  /**
5829
6167
  * Sets the default operator for the list of operators for a type.
@@ -5842,6 +6180,11 @@ declare module "sap/ui/mdc/condition/FilterOperatorUtil" {
5842
6180
  ): void;
5843
6181
  /**
5844
6182
  * Adds operators to the list of valid operators for a type.
6183
+ *
6184
+ * **Note**: `aOperators` can be the name of an {@link sap.ui.mdc.condition.Operator Operator}, the instance
6185
+ * itself, or multiple operators inside an array.
6186
+ *
6187
+ * **Note**: `vDefaultOperator` must exist as a valid operator for the type.
5845
6188
  */
5846
6189
  setOperatorsForType(
5847
6190
  /**
@@ -5851,13 +6194,9 @@ declare module "sap/ui/mdc/condition/FilterOperatorUtil" {
5851
6194
  /**
5852
6195
  * Operators
5853
6196
  */
5854
- aOperators: Operator[],
6197
+ aOperators: Operator[] | Operator | string[],
5855
6198
  /**
5856
6199
  * The default operator instance or default operator name
5857
- *
5858
- * **Note**: `aOperators` can be the name of an {@link sap.ui.mdc.condition.Operator Operator}, the instance
5859
- * itself, or multiple operators inside an array. **Note**: `vDefaultOperator` must exist as a valid operator
5860
- * for the type.
5861
6200
  */
5862
6201
  vDefaultOperator: Operator | string
5863
6202
  ): void;
@@ -5892,7 +6231,8 @@ declare module "sap/ui/mdc/condition/Operator" {
5892
6231
  */
5893
6232
  name: string;
5894
6233
  /**
5895
- * Alias names based on `BaseType`, used to map to `DynamicDateOption` if `DynamicDateRange` is used
6234
+ * Alias names based on {@link sap.ui.mdc.enums.BaseType BaseType}, used to map to {@link sap.m.DynamicDateOption DynamicDateOption }
6235
+ * if {@link sap.m.DynamicDateRange DynamicDateRange} is used to visualize the filter
5896
6236
  */
5897
6237
  alias?: object;
5898
6238
  /**
@@ -5942,16 +6282,26 @@ declare module "sap/ui/mdc/condition/Operator" {
5942
6282
  paramTypes?: string[];
5943
6283
  /**
5944
6284
  * String representation of the operator as a long text.
5945
- * If longText is not given , it is looked up in the resource bundle of the `sap.ui.mdc` library by the
5946
- * key `operators.{oConfiguration.name}.longText`
6285
+ * This text is shown in the operator dropdown of the value help.
6286
+ * If `longText` is not given , the `tokenText` is used, replacing the placeholders "{0}" and "{1}" with
6287
+ * "X" and "Y".
5947
6288
  */
5948
6289
  longText?: string;
5949
6290
  /**
5950
6291
  * String representation of the operator as a short text.
5951
- * If the token text is not given, it is looked up in the resource bundle of the `sap.ui.mdc` library by
5952
- * the key `operators.{oConfiguration.name}.tokenText`
6292
+ * This text is only needed if there any language dependent text should be shown on the token, like "Next
6293
+ * 5 days". (In this case `#tokenText#` is used in `tokenFormat`, `tokenTest`, or `tokenParse`.) For operators
6294
+ * just showing the value and a operator symbol, no token text is needed.
6295
+ * If the token text is not given, the `longText` is used.
5953
6296
  */
5954
6297
  tokenText?: string;
6298
+ /**
6299
+ * Object holding String representation of the operator as a long text for single basic types.
6300
+ * This text is shown in the operator dropdown of the value help.
6301
+ * This is needed if the text depends on the used data type. For example the "less than" operator should
6302
+ * be named "before" if a date or time type is used.
6303
+ */
6304
+ longTextForTypes?: object;
5955
6305
  /**
5956
6306
  * Pattern how different {@link sap.ui.mdc.enums.FieldDisplay displayFormats} are rendered
5957
6307
  */
@@ -5997,7 +6347,7 @@ declare module "sap/ui/mdc/condition/Operator" {
5997
6347
  */
5998
6348
  exclude?: boolean;
5999
6349
  /**
6000
- * If set, the user input for this operator needs to be validated using a field help
6350
+ * If set, the user input for this operator needs to be validated using a value help
6001
6351
  */
6002
6352
  validateInput?: boolean;
6003
6353
  /**
@@ -6011,7 +6361,24 @@ declare module "sap/ui/mdc/condition/Operator" {
6011
6361
  */
6012
6362
  group?: {
6013
6363
  /**
6014
- * Group ID for the operator.
6364
+ * Group ID for the operator. The following groups are available for the {@link sap.m.DynamicDateRange DynamicDateRange }
6365
+ * control:
6366
+ *
6367
+ * - 1 - Single Dates
6368
+ * - 2 - Date Ranges
6369
+ * - 3 - Weeks
6370
+ * - 4 - Months
6371
+ * - 5 - Quarters
6372
+ * - 6 - Years See {@link sap.m.DynamicDateRangeGroups DynamicDateRangeGroups}.
6373
+ * This only works for `FilterFields` with custom operators if `maxConditions=1` and no `valueHelp` is
6374
+ * assigned to the `FilterField`. Example:
6375
+ * group: undefined - if group is not specified; default behavior include/exclude group with id 1 and 2
6376
+ * will be created
6377
+ * group: {id : 1} - adds the operator to existing group 1 'Single Dates'
6378
+ * group: {id : 2, text: "new group"} - inserts a new group with id 2. Existing group 2 will be shifted
6379
+ * to 3, 4....
6380
+ * group: {id : 10, text: "new group at the end"} - adds a new group with id 10 and text "new group as
6381
+ * the end" to the end of all groups
6015
6382
  */
6016
6383
  id: string;
6017
6384
  /**
@@ -6020,24 +6387,7 @@ declare module "sap/ui/mdc/condition/Operator" {
6020
6387
  text?: string;
6021
6388
  };
6022
6389
  /**
6023
- * Function to determine the text copied into clipboard The following groups are available for the `DynamicDateRange`
6024
- * control:
6025
- *
6026
- * - 1 - Single Dates
6027
- * - 2 - Date Ranges
6028
- * - 3 - Weeks
6029
- * - 4 - Months
6030
- * - 5 - Quarters
6031
- * - 6 - Years See {@link sap.m.DynamicDateRangeGroups DynamicDateRangeGroups}.
6032
- * This only works for `FilterFields` with custom operators if `maxConditions=1` and no `valueHelp` is
6033
- * assigned to the `FilterField`. Example:
6034
- * group: undefined - if group is not specified; default behavior include/exclude group with id 1 and 2
6035
- * will be created
6036
- * group: {id : 1} - adds the operator to existing group 1 'Single Dates'
6037
- * group: {id : 2, text: "new group"} - inserts a new group with id 2. Existing group 2 will be shifted
6038
- * to 3, 4....
6039
- * group: {id : 10, text: "new group at the end"} - adds a new group with id 10 and text "new group as
6040
- * the end" to the end of all groups
6390
+ * Function to determine the text copied into clipboard
6041
6391
  */
6042
6392
  getTextForCopy?: Function;
6043
6393
  }
@@ -6128,21 +6478,21 @@ declare module "sap/ui/mdc/condition/RangeOperator" {
6128
6478
  export default class RangeOperator extends Operator {
6129
6479
  constructor(
6130
6480
  /**
6131
- * Included all parameters of {@link sap.ui.mdc.condition.Operator Operator} and adds some special ones
6481
+ * Includes all parameters of {@link sap.ui.mdc.condition.Operator Operator} and adds some special ones
6132
6482
  */
6133
6483
  oConfiguration: {
6134
6484
  /**
6135
- * additional array of labels for the values of the operator. Will be shown as placeholder text or label
6136
- * on the value fields.
6485
+ * Additional array of labels for the values of the operator. Will be shown as placeholder text or label
6486
+ * of the value fields.
6137
6487
  */
6138
- label?: string;
6488
+ label?: string[];
6139
6489
  /**
6140
- * function to calculate the date range of the operation. The function returns an array of UniversalDates.
6490
+ * Function to calculate the date range of the operation. The function returns an array of `UniversalDates`.
6141
6491
  * In case of a single `filterOperator` the array can return a single value.
6142
6492
  */
6143
6493
  calcRange: Function;
6144
6494
  /**
6145
- * function to format the date range.
6495
+ * Function to format the date range.
6146
6496
  */
6147
6497
  formatRange?: Function;
6148
6498
  /**
@@ -6779,7 +7129,41 @@ declare module "sap/ui/mdc/enums/ContentMode" {
6779
7129
  *
6780
7130
  * @since 1.115
6781
7131
  */
6782
- enum ContentMode {}
7132
+ enum ContentMode {
7133
+ /**
7134
+ * Display mode for single value
7135
+ */
7136
+ Display = "Display",
7137
+ /**
7138
+ * Display mode for multiline single value
7139
+ */
7140
+ DisplayMultiLine = "DisplayMultiLine",
7141
+ /**
7142
+ * Display mode for multiple values
7143
+ */
7144
+ DisplayMultiValue = "DisplayMultiValue",
7145
+ /**
7146
+ * Edit mode for single value
7147
+ */
7148
+ Edit = "Edit",
7149
+ /**
7150
+ * Edit mode for single value field if a field help is assigned To support field help, in some cases a different
7151
+ * control needs to be rendered.
7152
+ */
7153
+ EditForHelp = "EditForHelp",
7154
+ /**
7155
+ * Edit mode for multiple lines single value
7156
+ */
7157
+ EditMultiLine = "EditMultiLine",
7158
+ /**
7159
+ * Edit mode for multiple values
7160
+ */
7161
+ EditMultiValue = "EditMultiValue",
7162
+ /**
7163
+ * Edit mode for operator dependent controls This is used for single value and only one operator.
7164
+ */
7165
+ EditOperator = "EditOperator",
7166
+ }
6783
7167
  export default ContentMode;
6784
7168
  }
6785
7169
 
@@ -7497,17 +7881,17 @@ declare module "sap/ui/mdc/enums/OperatorName" {
7497
7881
 
7498
7882
  declare module "sap/ui/mdc/enums/OperatorOverwrite" {
7499
7883
  /**
7500
- * Enumeration of the `OperatorOverwrite` in `Operator`.
7884
+ * Enumeration of the {@link sap.ui.mdc.condition.Operator#OperatorOverwrite OperatorOverwrite} in {@link sap.ui.mdc.condition.Operator Operator}.
7501
7885
  *
7502
7886
  * @since 1.115
7503
7887
  */
7504
7888
  enum OperatorOverwrite {
7505
7889
  /**
7506
- * Overwrite the `getTypeText` function of the operator.
7890
+ * Overwrites the `getLongText` function of the operator.
7507
7891
  */
7508
7892
  getLongText = "getLongText",
7509
7893
  /**
7510
- * Overwrite the `getModelFilter` function of the operator.
7894
+ * Overwrites the `getModelFilter` function of the operator.
7511
7895
  */
7512
7896
  getModelFilter = "getModelFilter",
7513
7897
  }
@@ -7538,6 +7922,33 @@ declare module "sap/ui/mdc/enums/OperatorValueType" {
7538
7922
  export default OperatorValueType;
7539
7923
  }
7540
7924
 
7925
+ declare module "sap/ui/mdc/enums/ReasonMode" {
7926
+ /**
7927
+ * Enumeration of the possible reasons for the search event.
7928
+ *
7929
+ * @since 1.115
7930
+ */
7931
+ enum ReasonMode {
7932
+ /**
7933
+ * Enter pressed in filter field.
7934
+ */
7935
+ Enter = "Enter",
7936
+ /**
7937
+ * Go button pressed.
7938
+ */
7939
+ Go = "Go",
7940
+ /**
7941
+ * Used if the mentioned reasons are not applicable.
7942
+ */
7943
+ Unclear = "",
7944
+ /**
7945
+ * The applied variant is marked as Apply Automatically.
7946
+ */
7947
+ Variant = "Variant",
7948
+ }
7949
+ export default ReasonMode;
7950
+ }
7951
+
7541
7952
  declare module "sap/ui/mdc/enums/TableGrowingMode" {
7542
7953
  /**
7543
7954
  * Growing mode of the table.
@@ -7678,7 +8089,8 @@ declare module "sap/ui/mdc/enums/TableType" {
7678
8089
 
7679
8090
  declare module "sap/ui/mdc/enums/ValueHelpPropagationReason" {
7680
8091
  /**
7681
- * Enumeration of the propagation reason in the condition propagation callback of the {@link sap.ui.mdc.ValueHelp ValueHelp}
8092
+ * Enumeration of the propagation reason in the {@link sap.ui.mdc.ValueHelpDelegate#onConditionPropagation condition propagation callback }
8093
+ * of the {@link sap.ui.mdc.ValueHelp ValueHelp}
7682
8094
  *
7683
8095
  * @since 1.115
7684
8096
  */
@@ -7699,6 +8111,29 @@ declare module "sap/ui/mdc/enums/ValueHelpPropagationReason" {
7699
8111
  export default ValueHelpPropagationReason;
7700
8112
  }
7701
8113
 
8114
+ declare module "sap/ui/mdc/enums/ValueHelpSelectionType" {
8115
+ /**
8116
+ * Enumeration of the possible selection types in {@link sap.ui.mdc.ValueHelp ValueHelp}
8117
+ *
8118
+ * @since 1.115
8119
+ */
8120
+ enum ValueHelpSelectionType {
8121
+ /**
8122
+ * The given conditions are just added to the existing ones, if they don't already exist.
8123
+ */
8124
+ Add = "Add",
8125
+ /**
8126
+ * The given conditions are removed.
8127
+ */
8128
+ Remove = "Remove",
8129
+ /**
8130
+ * The given conditions are set and replace the existing ones.
8131
+ */
8132
+ Set = "Set",
8133
+ }
8134
+ export default ValueHelpSelectionType;
8135
+ }
8136
+
7702
8137
  declare module "sap/ui/mdc/Field" {
7703
8138
  import {
7704
8139
  default as FieldBase,
@@ -9416,11 +9851,10 @@ declare module "sap/ui/mdc/field/FieldBase" {
9416
9851
  *
9417
9852
  * Sets the conditions that represent the values of the field.
9418
9853
  *
9419
- * These should be bound to a {@link sap.ui.mdc.condition.ConditionModel ConditionModel} using the corresponding
9420
- * `fieldPath`.
9854
+ * These should be bound to a {@link sap.ui.mdc.FilterBar FilterBar} using the corresponding `propertyPath`.
9421
9855
  *
9422
9856
  * **Note:** For {@link sap.ui.mdc.FilterField FilterField} controls, the `conditions` property must be
9423
- * used to bind {@link sap.ui.mdc.FilterField FilterField} to a {@link sap.ui.mdc.condition.ConditionModel ConditionModel}.
9857
+ * used to bind {@link sap.ui.mdc.FilterField FilterField} to a {@link @link sap.ui.mdc.FilterBar FilterBar}.
9424
9858
  * For example, for a {@link sap.ui.mdc.FilterField FilterField} control inside a {@link sap.ui.mdc.FilterBar FilterBar }
9425
9859
  * control, the binding looks like this:
9426
9860
  * `conditions="{$filters>/conditions/propertyPath}"` with the following data:
@@ -9507,14 +9941,6 @@ declare module "sap/ui/mdc/field/FieldBase" {
9507
9941
  * @since 1.61.0
9508
9942
  */
9509
9943
  getContentEdit(): Control1;
9510
- /**
9511
- * Returns the `ContentFactory` used to manage the internal content control.
9512
- *
9513
- * @ui5-protected Do not call from applications (only from related classes in the framework)
9514
- *
9515
- * @returns oContentFactory the ContentFactory of the Field
9516
- */
9517
- getContentFactory(): /* was: sap.ui.mdc.field.content.ContentFactory */ any;
9518
9944
  /**
9519
9945
  * Gets the currently used content controls.
9520
9946
  *
@@ -9962,11 +10388,10 @@ declare module "sap/ui/mdc/field/FieldBase" {
9962
10388
  *
9963
10389
  * Sets the conditions that represent the values of the field.
9964
10390
  *
9965
- * These should be bound to a {@link sap.ui.mdc.condition.ConditionModel ConditionModel} using the corresponding
9966
- * `fieldPath`.
10391
+ * These should be bound to a {@link sap.ui.mdc.FilterBar FilterBar} using the corresponding `propertyPath`.
9967
10392
  *
9968
10393
  * **Note:** For {@link sap.ui.mdc.FilterField FilterField} controls, the `conditions` property must be
9969
- * used to bind {@link sap.ui.mdc.FilterField FilterField} to a {@link sap.ui.mdc.condition.ConditionModel ConditionModel}.
10394
+ * used to bind {@link sap.ui.mdc.FilterField FilterField} to a {@link @link sap.ui.mdc.FilterBar FilterBar}.
9970
10395
  * For example, for a {@link sap.ui.mdc.FilterField FilterField} control inside a {@link sap.ui.mdc.FilterBar FilterBar }
9971
10396
  * control, the binding looks like this:
9972
10397
  * `conditions="{$filters>/conditions/propertyPath}"` with the following data:
@@ -10555,11 +10980,10 @@ declare module "sap/ui/mdc/field/FieldBase" {
10555
10980
  /**
10556
10981
  * Sets the conditions that represent the values of the field.
10557
10982
  *
10558
- * These should be bound to a {@link sap.ui.mdc.condition.ConditionModel ConditionModel} using the corresponding
10559
- * `fieldPath`.
10983
+ * These should be bound to a {@link sap.ui.mdc.FilterBar FilterBar} using the corresponding `propertyPath`.
10560
10984
  *
10561
10985
  * **Note:** For {@link sap.ui.mdc.FilterField FilterField} controls, the `conditions` property must be
10562
- * used to bind {@link sap.ui.mdc.FilterField FilterField} to a {@link sap.ui.mdc.condition.ConditionModel ConditionModel}.
10986
+ * used to bind {@link sap.ui.mdc.FilterField FilterField} to a {@link @link sap.ui.mdc.FilterBar FilterBar}.
10563
10987
  * For example, for a {@link sap.ui.mdc.FilterField FilterField} control inside a {@link sap.ui.mdc.FilterBar FilterBar }
10564
10988
  * control, the binding looks like this:
10565
10989
  * `conditions="{$filters>/conditions/propertyPath}"` with the following data:
@@ -11318,8 +11742,6 @@ declare module "sap/ui/mdc/FilterBar" {
11318
11742
 
11319
11743
  import FilterBarP13nMode from "sap/ui/mdc/enums/FilterBarP13nMode";
11320
11744
 
11321
- import FilterField from "sap/ui/mdc/FilterField";
11322
-
11323
11745
  import { PropertyInfo as PropertyInfo1 } from "sap/ui/mdc/util/PropertyHelper";
11324
11746
 
11325
11747
  import { PropertyBindingInfo } from "sap/ui/base/ManagedObject";
@@ -11440,13 +11862,6 @@ declare module "sap/ui/mdc/FilterBar" {
11440
11862
  * @returns Value of property `showClearButton`
11441
11863
  */
11442
11864
  getShowClearButton(): boolean;
11443
- /**
11444
- * Sets the focus on the first filter in error state.
11445
- *
11446
- *
11447
- * @returns The first filter field in error state
11448
- */
11449
- setFocusOnFirstErroneousField(): FilterField | null;
11450
11865
  /**
11451
11866
  * Sets a new value for property {@link #getP13nMode p13nMode}.
11452
11867
  *
@@ -11568,6 +11983,8 @@ declare module "sap/ui/mdc/filterbar/FilterBarBase" {
11568
11983
 
11569
11984
  import Event from "sap/ui/base/Event";
11570
11985
 
11986
+ import ReasonMode from "sap/ui/mdc/enums/ReasonMode";
11987
+
11571
11988
  /**
11572
11989
  * The `FilterBarBase` control is the base for filter displaying controls in MDC.
11573
11990
  *
@@ -12037,6 +12454,13 @@ declare module "sap/ui/mdc/filterbar/FilterBarBase" {
12037
12454
  */
12038
12455
  oDelegate?: object
12039
12456
  ): this;
12457
+ /**
12458
+ * Sets the focus on the first filter in error state.
12459
+ *
12460
+ *
12461
+ * @returns The first filter field in error state
12462
+ */
12463
+ setFocusOnFirstErroneousField(): FilterField | null;
12040
12464
  /**
12041
12465
  * Sets a new value for property {@link #getLiveMode liveMode}.
12042
12466
  *
@@ -12211,7 +12635,10 @@ declare module "sap/ui/mdc/filterbar/FilterBarBase" {
12211
12635
  * **Note**: This property must not be bound.
12212
12636
  * **Note**: This property is used exclusively for SAPUI5 flexibility/ Fiori Elements. Do not use it otherwise.
12213
12637
  * **Node**: Please check {@link sap.ui.mdc.filterbar.PropertyInfo} for more information about the supported
12214
- * inner elements.
12638
+ * inner elements. **Note**: Existing properties (set via `sap.ui.mdc.filterbar.FilterBarBase#setPropertyInfo`)
12639
+ * must not be removed and their attributes must not be changed during the {@link module:sap/ui/mdc/FilterBarDelegate.fetchProperties fetchProperties }
12640
+ * callback. Otherwise validation errors might occur whenever personalization-related control features (such
12641
+ * as the opening of any personalization dialog) are activated.
12215
12642
  *
12216
12643
  * @since 1.97
12217
12644
  */
@@ -12307,7 +12734,7 @@ declare module "sap/ui/mdc/filterbar/FilterBarBase" {
12307
12734
  * - `{@link sap.ui.mdc.enums.ReasonMode.Go}`: Search is triggered based on pressing the Go button
12308
12735
  * - `{@link sap.ui.mdc.enums.ReasonMode.Unclear}`: Any other reasons for the search
12309
12736
  */
12310
- reason?: /* was: sap.ui.mdc.enums.ReasonMode */ any;
12737
+ reason?: ReasonMode;
12311
12738
  }
12312
12739
 
12313
12740
  /**
@@ -12486,9 +12913,9 @@ declare module "sap/ui/mdc/FilterField" {
12486
12913
 
12487
12914
  /**
12488
12915
  * The `FilterField` control is used to filter data based on the conditions. The conditions are managed
12489
- * in the corresponding {@link sap.ui.mdc.condition.ConditionModel ConditionModel}. That is why the `conditions`
12490
- * property must be bound to the related conditions in the {@link sap.ui.mdc.condition.ConditionModel ConditionModel}.
12491
- * The type of this data must be defined in the `dataType` property.
12916
+ * in the corresponding {@link sap.ui.mdc.FilterBar FilterBar}. That is why the `conditions` property must
12917
+ * be bound to the related conditions in the {@link sap.ui.mdc.FilterBar FilterBar}. The type of this data
12918
+ * must be defined in the `dataType` property.
12492
12919
  *
12493
12920
  * Based on the data type settings, a default control is rendered by the `FilterField` as follows:
12494
12921
  *
@@ -12618,7 +13045,7 @@ declare module "sap/ui/mdc/FilterField" {
12618
13045
  * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
12619
13046
  * otherwise it will be bound to this `sap.ui.mdc.FilterField` itself.
12620
13047
  *
12621
- * This event is fired when the `value` property of the field is changed.
13048
+ * This event is fired when the `conditions` property of the `FilterField` is changed by a user interaction.
12622
13049
  *
12623
13050
  * **Note** This event is only triggered if the used content control has a change event.
12624
13051
  *
@@ -12646,7 +13073,7 @@ declare module "sap/ui/mdc/FilterField" {
12646
13073
  * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
12647
13074
  * otherwise it will be bound to this `sap.ui.mdc.FilterField` itself.
12648
13075
  *
12649
- * This event is fired when the `value` property of the field is changed.
13076
+ * This event is fired when the `conditions` property of the `FilterField` is changed by a user interaction.
12650
13077
  *
12651
13078
  * **Note** This event is only triggered if the used content control has a change event.
12652
13079
  *
@@ -12917,7 +13344,7 @@ declare module "sap/ui/mdc/FilterField" {
12917
13344
  additionalDataType?: object | PropertyBindingInfo | `{${string}}`;
12918
13345
 
12919
13346
  /**
12920
- * This event is fired when the `value` property of the field is changed.
13347
+ * This event is fired when the `conditions` property of the `FilterField` is changed by a user interaction.
12921
13348
  *
12922
13349
  * **Note** This event is only triggered if the used content control has a change event.
12923
13350
  */
@@ -13055,43 +13482,18 @@ declare module "sap/ui/mdc/Link" {
13055
13482
  * @returns Metadata object describing this class
13056
13483
  */
13057
13484
  static getMetadata(): ElementMetadata;
13058
- /**
13059
- * Retrieves the relevant metadata for the panel and returns a property info array.
13060
- *
13061
- * @ui5-protected Do not call from applications (only from related classes in the framework)
13062
- *
13063
- * @returns Array of copied property info
13064
- */
13065
- static retrieveAllMetadata(
13066
- /**
13067
- * Instance of a `Panel` control
13068
- */
13069
- oPanel: /* was: sap.ui.mdc.link.Panel */ any
13070
- ): object[];
13071
- /**
13072
- * Retrieves the items that are initially part of the baseline which is used when a reset is done.
13073
- *
13074
- * @ui5-protected Do not call from applications (only from related classes in the framework)
13075
- *
13076
- * @returns Array containing the `ID` and `visible` property of every {@link sap.ui.mdc.link.LinkItem}
13077
- */
13078
- static retrieveBaseline(
13079
- /**
13080
- * Instance of a `Panel` control
13081
- */
13082
- oPanel: /* was: sap.ui.mdc.link.Panel */ any
13083
- ): BaseLineObject[];
13084
13485
  /**
13085
13486
  * Gets current value of property {@link #getDelegate delegate}.
13086
13487
  *
13087
- * Object related to the `Delegate` module that provides the required APIs to execute model-specific logic.
13488
+ * Object related to the `LinkDelegate` module that provides the required APIs to execute model-specific
13489
+ * logic.
13088
13490
  * The object has the following properties:
13089
- * - `name` defines the path to the `Delegate` module
13491
+ * - `name` defines the path to the `LinkDelegate` module
13090
13492
  * - `payload` (optional) defines application-specific information that can be used in the given delegate
13091
13493
  * Sample delegate object:
13092
13494
  * ```javascript
13093
13495
  * {
13094
- * name: "sap/ui/mdc/BaseDelegate",
13496
+ * name: "sap/ui/mdc/LinkDelegate",
13095
13497
  * payload: {}
13096
13498
  * }```
13097
13499
  * **Note:** Ensure that the related file can be requested (any required library has to be loaded before
@@ -13145,14 +13547,15 @@ declare module "sap/ui/mdc/Link" {
13145
13547
  /**
13146
13548
  * Sets a new value for property {@link #getDelegate delegate}.
13147
13549
  *
13148
- * Object related to the `Delegate` module that provides the required APIs to execute model-specific logic.
13550
+ * Object related to the `LinkDelegate` module that provides the required APIs to execute model-specific
13551
+ * logic.
13149
13552
  * The object has the following properties:
13150
- * - `name` defines the path to the `Delegate` module
13553
+ * - `name` defines the path to the `LinkDelegate` module
13151
13554
  * - `payload` (optional) defines application-specific information that can be used in the given delegate
13152
13555
  * Sample delegate object:
13153
13556
  * ```javascript
13154
13557
  * {
13155
- * name: "sap/ui/mdc/BaseDelegate",
13558
+ * name: "sap/ui/mdc/LinkDelegate",
13156
13559
  * payload: {}
13157
13560
  * }```
13158
13561
  * **Note:** Ensure that the related file can be requested (any required library has to be loaded before
@@ -13272,14 +13675,15 @@ declare module "sap/ui/mdc/Link" {
13272
13675
  enablePersonalization?: boolean | PropertyBindingInfo | `{${string}}`;
13273
13676
 
13274
13677
  /**
13275
- * Object related to the `Delegate` module that provides the required APIs to execute model-specific logic.
13678
+ * Object related to the `LinkDelegate` module that provides the required APIs to execute model-specific
13679
+ * logic.
13276
13680
  * The object has the following properties:
13277
- * - `name` defines the path to the `Delegate` module
13681
+ * - `name` defines the path to the `LinkDelegate` module
13278
13682
  * - `payload` (optional) defines application-specific information that can be used in the given delegate
13279
13683
  * Sample delegate object:
13280
13684
  * ```javascript
13281
13685
  * {
13282
- * name: "sap/ui/mdc/BaseDelegate",
13686
+ * name: "sap/ui/mdc/LinkDelegate",
13283
13687
  * payload: {}
13284
13688
  * }```
13285
13689
  * **Note:** Ensure that the related file can be requested (any required library has to be loaded before
@@ -13299,6 +13703,8 @@ declare module "sap/ui/mdc/Link" {
13299
13703
  declare module "sap/ui/mdc/link/LinkItem" {
13300
13704
  import { default as UI5Element, $ElementSettings } from "sap/ui/core/Element";
13301
13705
 
13706
+ import { URI } from "sap/ui/core/library";
13707
+
13302
13708
  import ElementMetadata from "sap/ui/core/ElementMetadata";
13303
13709
 
13304
13710
  import { PropertyBindingInfo } from "sap/ui/base/ManagedObject";
@@ -13400,7 +13806,7 @@ declare module "sap/ui/mdc/link/LinkItem" {
13400
13806
  *
13401
13807
  * @returns Value of property `icon`
13402
13808
  */
13403
- getIcon(): string;
13809
+ getIcon(): URI;
13404
13810
  /**
13405
13811
  * Gets current value of property {@link #getInitiallyVisible initiallyVisible}.
13406
13812
  *
@@ -13506,7 +13912,7 @@ declare module "sap/ui/mdc/link/LinkItem" {
13506
13912
  /**
13507
13913
  * New value for property `icon`
13508
13914
  */
13509
- sIcon: string
13915
+ sIcon: URI
13510
13916
  ): this;
13511
13917
  /**
13512
13918
  * Sets a new value for property {@link #getInitiallyVisible initiallyVisible}.
@@ -13643,7 +14049,7 @@ declare module "sap/ui/mdc/link/LinkItem" {
13643
14049
  /**
13644
14050
  * Defines the icon of the item.
13645
14051
  */
13646
- icon?: string | PropertyBindingInfo;
14052
+ icon?: URI | PropertyBindingInfo | `{${string}}`;
13647
14053
 
13648
14054
  /**
13649
14055
  * Determines the initial visibility of the `LinkItem`. If set to `true`, the item will appear on the `Popover`
@@ -16387,7 +16793,10 @@ declare module "sap/ui/mdc/Table" {
16387
16793
  * no effect.
16388
16794
  *
16389
16795
  * **Note**: This property must not be bound. **Note**: This property is used exclusively for SAPUI5 flexibility
16390
- * / Fiori Elements. Do not use it otherwise.
16796
+ * / Fiori Elements. Do not use it otherwise. **Note**: Existing properties (set via `sap.ui.mdc.Table#setPropertyInfo`)
16797
+ * must not be removed and their attributes must not be changed during the {@link module:sap/ui/mdc/TableDelegate.fetchProperties fetchProperties }
16798
+ * callback. Otherwise validation errors might occur whenever personalization-related control features (such
16799
+ * as the opening of any personalization dialog) are activated.
16391
16800
  *
16392
16801
  * @since 1.111
16393
16802
  */
@@ -18363,6 +18772,25 @@ declare module "sap/ui/mdc/table/GridTableType" {
18363
18772
  * @returns Value of property `rowCountMode`
18364
18773
  */
18365
18774
  getRowCountMode(): TableRowCountMode | keyof typeof TableRowCountMode;
18775
+ /**
18776
+ * Gets current value of property {@link #getScrollThreshold scrollThreshold}.
18777
+ *
18778
+ * Number of records to be requested from the model when the user scrolls through the table.
18779
+ *
18780
+ * The property defines how many additional (not yet visible) data records from the back-end system are
18781
+ * pre-fetched during scrolling. If the `scrollThreshold` is lower than the number of visible rows, the
18782
+ * number of visible rows is used as the `scrollThreshold`. If the value is 0, thresholding is disabled.
18783
+ *
18784
+ * **Note:** This property only takes effect if it is set to a positive integer value. Otherwise the `threshold`
18785
+ * property is used.
18786
+ *
18787
+ * Default value is `-1`.
18788
+ *
18789
+ * @since 1.128
18790
+ *
18791
+ * @returns Value of property `scrollThreshold`
18792
+ */
18793
+ getScrollThreshold(): int;
18366
18794
  /**
18367
18795
  * Gets current value of property {@link #getSelectionLimit selectionLimit}.
18368
18796
  *
@@ -18451,6 +18879,32 @@ declare module "sap/ui/mdc/table/GridTableType" {
18451
18879
  */
18452
18880
  sRowCountMode?: TableRowCountMode | keyof typeof TableRowCountMode
18453
18881
  ): this;
18882
+ /**
18883
+ * Sets a new value for property {@link #getScrollThreshold scrollThreshold}.
18884
+ *
18885
+ * Number of records to be requested from the model when the user scrolls through the table.
18886
+ *
18887
+ * The property defines how many additional (not yet visible) data records from the back-end system are
18888
+ * pre-fetched during scrolling. If the `scrollThreshold` is lower than the number of visible rows, the
18889
+ * number of visible rows is used as the `scrollThreshold`. If the value is 0, thresholding is disabled.
18890
+ *
18891
+ * **Note:** This property only takes effect if it is set to a positive integer value. Otherwise the `threshold`
18892
+ * property is used.
18893
+ *
18894
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
18895
+ *
18896
+ * Default value is `-1`.
18897
+ *
18898
+ * @since 1.128
18899
+ *
18900
+ * @returns Reference to `this` in order to allow method chaining
18901
+ */
18902
+ setScrollThreshold(
18903
+ /**
18904
+ * New value for property `scrollThreshold`
18905
+ */
18906
+ iScrollThreshold?: int
18907
+ ): this;
18454
18908
  /**
18455
18909
  * Sets a new value for property {@link #getSelectionLimit selectionLimit}.
18456
18910
  *
@@ -18541,6 +18995,20 @@ declare module "sap/ui/mdc/table/GridTableType" {
18541
18995
  * Defines the number of fixed columns.
18542
18996
  */
18543
18997
  fixedColumnCount?: int | PropertyBindingInfo | `{${string}}`;
18998
+
18999
+ /**
19000
+ * Number of records to be requested from the model when the user scrolls through the table.
19001
+ *
19002
+ * The property defines how many additional (not yet visible) data records from the back-end system are
19003
+ * pre-fetched during scrolling. If the `scrollThreshold` is lower than the number of visible rows, the
19004
+ * number of visible rows is used as the `scrollThreshold`. If the value is 0, thresholding is disabled.
19005
+ *
19006
+ * **Note:** This property only takes effect if it is set to a positive integer value. Otherwise the `threshold`
19007
+ * property is used.
19008
+ *
19009
+ * @since 1.128
19010
+ */
19011
+ scrollThreshold?: int | PropertyBindingInfo | `{${string}}`;
18544
19012
  }
18545
19013
  }
18546
19014
 
@@ -19805,6 +20273,8 @@ declare module "sap/ui/mdc/ValueHelp" {
19805
20273
 
19806
20274
  import Event from "sap/ui/base/Event";
19807
20275
 
20276
+ import { valuehelp } from "sap/ui/mdc/library";
20277
+
19808
20278
  import ElementMetadata from "sap/ui/core/ElementMetadata";
19809
20279
 
19810
20280
  import Context from "sap/ui/model/Context";
@@ -20163,13 +20633,13 @@ declare module "sap/ui/mdc/ValueHelp" {
20163
20633
  *
20164
20634
  * Container that is used and opened if the value help icon of the input field is pressed.
20165
20635
  */
20166
- getDialog(): /* was: sap.ui.mdc.valuehelp.IDialogContainer */ any;
20636
+ getDialog(): valuehelp.base.IDialogContainer;
20167
20637
  /**
20168
20638
  * Gets content of aggregation {@link #getTypeahead typeahead}.
20169
20639
  *
20170
20640
  * Container that is used and opened in typeahead
20171
20641
  */
20172
- getTypeahead(): /* was: sap.ui.mdc.valuehelp.ITypeaheadContainer */ any;
20642
+ getTypeahead(): valuehelp.base.ITypeaheadContainer;
20173
20643
  /**
20174
20644
  * Gets current value of property {@link #getValidateInput validateInput}.
20175
20645
  *
@@ -20180,6 +20650,9 @@ declare module "sap/ui/mdc/ValueHelp" {
20180
20650
  * is found, the user input is set to the field if the used data type allows this. (A type parsing error
20181
20651
  * is shown if the user input adheres to the requirements of the used data type.)
20182
20652
  *
20653
+ * **Note:** The input is validated and compared against the content assigned to the `typeahead` aggregation.
20654
+ * If no content is assigned to the `typeahead` aggregation, the input is not validated.
20655
+ *
20183
20656
  * Default value is `true`.
20184
20657
  *
20185
20658
  *
@@ -20227,7 +20700,7 @@ declare module "sap/ui/mdc/ValueHelp" {
20227
20700
  /**
20228
20701
  * The dialog to set
20229
20702
  */
20230
- oDialog: /* was: sap.ui.mdc.valuehelp.IDialogContainer */ any
20703
+ oDialog: valuehelp.base.IDialogContainer
20231
20704
  ): this;
20232
20705
  /**
20233
20706
  * Sets the aggregated {@link #getTypeahead typeahead}.
@@ -20239,7 +20712,7 @@ declare module "sap/ui/mdc/ValueHelp" {
20239
20712
  /**
20240
20713
  * The typeahead to set
20241
20714
  */
20242
- oTypeahead: /* was: sap.ui.mdc.valuehelp.ITypeaheadContainer */ any
20715
+ oTypeahead: valuehelp.base.ITypeaheadContainer
20243
20716
  ): this;
20244
20717
  /**
20245
20718
  * Sets a new value for property {@link #getValidateInput validateInput}.
@@ -20251,6 +20724,9 @@ declare module "sap/ui/mdc/ValueHelp" {
20251
20724
  * is found, the user input is set to the field if the used data type allows this. (A type parsing error
20252
20725
  * is shown if the user input adheres to the requirements of the used data type.)
20253
20726
  *
20727
+ * **Note:** The input is validated and compared against the content assigned to the `typeahead` aggregation.
20728
+ * If no content is assigned to the `typeahead` aggregation, the input is not validated.
20729
+ *
20254
20730
  * When called with a value of `null` or `undefined`, the default value of the property will be restored.
20255
20731
  *
20256
20732
  * Default value is `true`.
@@ -20330,6 +20806,25 @@ declare module "sap/ui/mdc/ValueHelp" {
20330
20806
  control: Control;
20331
20807
  };
20332
20808
 
20809
+ /**
20810
+ * Configuration object type for normalized definition of a `ValueHelpItem`.
20811
+ */
20812
+ export type ValueHelpItem = {
20813
+ /**
20814
+ * Key
20815
+ */
20816
+ key: any;
20817
+ /**
20818
+ * Description
20819
+ */
20820
+ description?: any;
20821
+ /**
20822
+ * Payload of the condition. Set by application. Data needs to be stringified. (as stored and loaded in
20823
+ * variants)
20824
+ */
20825
+ payload?: object;
20826
+ };
20827
+
20333
20828
  /**
20334
20829
  * Describes the settings that can be provided to the ValueHelp constructor.
20335
20830
  */
@@ -20359,18 +20854,21 @@ declare module "sap/ui/mdc/ValueHelp" {
20359
20854
  * If this property is not set, the user input is still checked against the value help. But if no entry
20360
20855
  * is found, the user input is set to the field if the used data type allows this. (A type parsing error
20361
20856
  * is shown if the user input adheres to the requirements of the used data type.)
20857
+ *
20858
+ * **Note:** The input is validated and compared against the content assigned to the `typeahead` aggregation.
20859
+ * If no content is assigned to the `typeahead` aggregation, the input is not validated.
20362
20860
  */
20363
20861
  validateInput?: boolean | PropertyBindingInfo | `{${string}}`;
20364
20862
 
20365
20863
  /**
20366
20864
  * Container that is used and opened if the value help icon of the input field is pressed.
20367
20865
  */
20368
- dialog?: /* was: sap.ui.mdc.valuehelp.IDialogContainer */ any;
20866
+ dialog?: valuehelp.base.IDialogContainer;
20369
20867
 
20370
20868
  /**
20371
20869
  * Container that is used and opened in typeahead
20372
20870
  */
20373
- typeahead?: /* was: sap.ui.mdc.valuehelp.ITypeaheadContainer */ any;
20871
+ typeahead?: valuehelp.base.ITypeaheadContainer;
20374
20872
 
20375
20873
  /**
20376
20874
  * This event is fired after the value help has been closed.
@@ -20595,6 +21093,15 @@ declare module "sap/ui/mdc/valuehelp/base/Container" {
20595
21093
 
20596
21094
  import Control from "sap/ui/core/Control";
20597
21095
 
21096
+ import {
21097
+ ItemForValueConfiguration,
21098
+ ValueHelpItem,
21099
+ } from "sap/ui/mdc/ValueHelp";
21100
+
21101
+ import FormatException from "sap/ui/model/FormatException";
21102
+
21103
+ import ParseException from "sap/ui/model/ParseException";
21104
+
20598
21105
  import ElementMetadata from "sap/ui/core/ElementMetadata";
20599
21106
 
20600
21107
  import UIArea from "sap/ui/core/UIArea";
@@ -20606,6 +21113,8 @@ declare module "sap/ui/mdc/valuehelp/base/Container" {
20606
21113
  AggregationBindingInfo,
20607
21114
  } from "sap/ui/base/ManagedObject";
20608
21115
 
21116
+ import ValueHelpSelectionType from "sap/ui/mdc/enums/ValueHelpSelectionType";
21117
+
20609
21118
  /**
20610
21119
  * Container for the {@link sap.ui.mdc.ValueHelp ValueHelp} element.
20611
21120
  *
@@ -20701,6 +21210,10 @@ declare module "sap/ui/mdc/valuehelp/base/Container" {
20701
21210
  */
20702
21211
  oContent: Content
20703
21212
  ): void;
21213
+ /**
21214
+ * Closes the container
21215
+ */
21216
+ close(): void;
20704
21217
  /**
20705
21218
  * Closes the container control or element.
20706
21219
  *
@@ -20748,6 +21261,23 @@ declare module "sap/ui/mdc/valuehelp/base/Container" {
20748
21261
  * @returns connected control
20749
21262
  */
20750
21263
  getControl(): Control;
21264
+ /**
21265
+ * Determines the item (key and description) for a given value.
21266
+ *
21267
+ * The value help checks if there is an item with a key or description that fits this value.
21268
+ *
21269
+ * **Note:** This function must only be called by the control the `ValuedHelp` element belongs to, not by
21270
+ * the application.
21271
+ *
21272
+ *
21273
+ * @returns Promise returning object containing description, key and payload.
21274
+ */
21275
+ getItemForValue(
21276
+ /**
21277
+ * Configuration
21278
+ */
21279
+ oConfig: ItemForValueConfiguration
21280
+ ): Promise<ValueHelpItem>;
20751
21281
  /**
20752
21282
  * Returns the maximum allowed number of conditions, -1 if no limit is set.
20753
21283
  *
@@ -20791,6 +21321,14 @@ declare module "sap/ui/mdc/valuehelp/base/Container" {
20791
21321
  * @returns The UI area of the content or `null`
20792
21322
  */
20793
21323
  getUIAreaForContent(): UIArea | null;
21324
+ /**
21325
+ * If the container is used for type-ahead it might be wanted that the same content should also be shown
21326
+ * as valuehelp. If not, the field should not show a valuehelp icon.
21327
+ *
21328
+ *
21329
+ * @returns `true` if the typeahead content can be used as value help
21330
+ */
21331
+ getUseAsValueHelp(): boolean;
20794
21332
  /**
20795
21333
  * Handles the `cancelled` event of the content.
20796
21334
  *
@@ -20935,6 +21473,27 @@ declare module "sap/ui/mdc/valuehelp/base/Container" {
20935
21473
  * @returns `true` id single selection
20936
21474
  */
20937
21475
  isSingleSelect(): boolean;
21476
+ /**
21477
+ * Defines if the typeahead can be used for input validation.
21478
+ *
21479
+ *
21480
+ * @returns True if the typeahead container can be used for input validation
21481
+ */
21482
+ isValidationSupported(): boolean;
21483
+ /**
21484
+ * Navigates the typeaheads values (optional)
21485
+ *
21486
+ * As this could be asyncronous as data might be loaded a promise is returned.
21487
+ *
21488
+ *
21489
+ * @returns Promise fulfilled after navigation is evecuted
21490
+ */
21491
+ navigate(
21492
+ /**
21493
+ * Number of steps for navigation (e.g. 1 means next item, -1 means previous item)
21494
+ */
21495
+ iStep: int
21496
+ ): Promise<object>;
20938
21497
  /**
20939
21498
  * Triggers navigation in the content of the container.
20940
21499
  *
@@ -20957,6 +21516,22 @@ declare module "sap/ui/mdc/valuehelp/base/Container" {
20957
21516
  */
20958
21517
  oChanges: object
20959
21518
  ): void;
21519
+ /**
21520
+ * Opens the container
21521
+ *
21522
+ *
21523
+ * @returns This promise resolves after the container completely opened.
21524
+ */
21525
+ open(
21526
+ /**
21527
+ * Promise for content request
21528
+ */
21529
+ oValueHelpContentPromise: Promise<any>,
21530
+ /**
21531
+ * Flag indicating whether the container is opened as type-ahead or dialog-like help
21532
+ */
21533
+ bTypeahead: boolean
21534
+ ): Promise<any>;
20960
21535
  /**
20961
21536
  * Opens the container control or element.
20962
21537
  *
@@ -21006,6 +21581,11 @@ declare module "sap/ui/mdc/valuehelp/base/Container" {
21006
21581
  */
21007
21582
  vContent: int | string | Content
21008
21583
  ): Content | null;
21584
+ /**
21585
+ * The focus visualization of the field help needs to be removed as the user starts typing into the source
21586
+ * control.
21587
+ */
21588
+ removeVisualFocus(): void;
21009
21589
  /**
21010
21590
  * Sets a new value for property {@link #getTitle title}.
21011
21591
  *
@@ -21024,6 +21604,34 @@ declare module "sap/ui/mdc/valuehelp/base/Container" {
21024
21604
  */
21025
21605
  sTitle?: string
21026
21606
  ): this;
21607
+ /**
21608
+ * The focus visualization of the field help needs to be set as the user starts naigation into the value
21609
+ * help items.
21610
+ *
21611
+ * @since 1.127.0
21612
+ */
21613
+ setVisualFocus(): void;
21614
+ /**
21615
+ * Defines if the typeahead container desires to be opened whenever a user clicks on a connected control
21616
+ *
21617
+ *
21618
+ * @returns If `true`, the value help should open when user clicks into the connected field control
21619
+ */
21620
+ shouldOpenOnClick(): Promise<boolean>;
21621
+ /**
21622
+ * Defines if the typeahead container desires to be opened whenever a user focuses a connected control
21623
+ *
21624
+ *
21625
+ * @returns If `true`, the value help should open when user focuses the connected field control
21626
+ */
21627
+ shouldOpenOnFocus(): Promise<boolean>;
21628
+ /**
21629
+ * Defines if the typeahead containers values can be navigated without visibly opening the help
21630
+ *
21631
+ *
21632
+ * @returns If `true`, the value help should open when user used the arrow keys in the connected field control
21633
+ */
21634
+ shouldOpenOnNavigate(): boolean;
21027
21635
  /**
21028
21636
  * Unbinds the content from the container.
21029
21637
  *
@@ -21187,7 +21795,7 @@ declare module "sap/ui/mdc/valuehelp/base/Container" {
21187
21795
  /**
21188
21796
  * Type of the selection change (add, remove)
21189
21797
  */
21190
- type?: /* was: sap.ui.mdc.enums.ValueHelpSelectionType */ any;
21798
+ type?: ValueHelpSelectionType | keyof typeof ValueHelpSelectionType;
21191
21799
 
21192
21800
  /**
21193
21801
  * Changed conditions
@@ -21266,16 +21874,26 @@ declare module "sap/ui/mdc/valuehelp/base/Content" {
21266
21874
 
21267
21875
  import Control from "sap/ui/core/Control";
21268
21876
 
21877
+ import {
21878
+ ItemForValueConfiguration,
21879
+ ValueHelpItem,
21880
+ default as ValueHelp,
21881
+ } from "sap/ui/mdc/ValueHelp";
21882
+
21883
+ import FormatException from "sap/ui/model/FormatException";
21884
+
21885
+ import ParseException from "sap/ui/model/ParseException";
21886
+
21269
21887
  import ElementMetadata from "sap/ui/core/ElementMetadata";
21270
21888
 
21271
21889
  import BaseDelegate from "sap/ui/mdc/BaseDelegate";
21272
21890
 
21273
- import ValueHelp from "sap/ui/mdc/ValueHelp";
21274
-
21275
21891
  import { PropertyBindingInfo } from "sap/ui/base/ManagedObject";
21276
21892
 
21277
21893
  import Event from "sap/ui/base/Event";
21278
21894
 
21895
+ import ValueHelpSelectionType from "sap/ui/mdc/enums/ValueHelpSelectionType";
21896
+
21279
21897
  /**
21280
21898
  * Content for the {@link sap.ui.mdc.valuehelp.base.Container Container} element.
21281
21899
  *
@@ -21378,6 +21996,13 @@ declare module "sap/ui/mdc/valuehelp/base/Content" {
21378
21996
  */
21379
21997
  oPayload?: object
21380
21998
  ): ConditionObject;
21999
+ /**
22000
+ * Loads additional dependencies, creates and returns displayed content.
22001
+ *
22002
+ *
22003
+ * @returns Promise resolving in displayed content
22004
+ */
22005
+ getContent(): Promise<Control>;
21381
22006
  /**
21382
22007
  * Returns control connected to value help.
21383
22008
  *
@@ -21386,6 +22011,34 @@ declare module "sap/ui/mdc/valuehelp/base/Content" {
21386
22011
  * @returns Connected control
21387
22012
  */
21388
22013
  getControl(): Control;
22014
+ /**
22015
+ * Returns number of relevant conditions for this content
22016
+ *
22017
+ *
22018
+ * @returns Number of relevant conditions
22019
+ */
22020
+ getCount(
22021
+ /**
22022
+ * Array of conditions
22023
+ */
22024
+ aConditions: ConditionObject[]
22025
+ ): number;
22026
+ /**
22027
+ * Determines the item (key and description) for a given value.
22028
+ *
22029
+ * The content checks if there is an item with a key or description that fits this value.
22030
+ *
22031
+ * **Note:** This function must only be called by the `Container` element.
22032
+ *
22033
+ *
22034
+ * @returns Promise returning object containing description, key and payload.
22035
+ */
22036
+ getItemForValue(
22037
+ /**
22038
+ * Configuration
22039
+ */
22040
+ oConfig: ItemForValueConfiguration
22041
+ ): Promise<ValueHelpItem>;
21389
22042
  /**
21390
22043
  * Returns the maximum allowed number of conditions, -1 if no limit is set.
21391
22044
  *
@@ -21427,6 +22080,14 @@ declare module "sap/ui/mdc/valuehelp/base/Content" {
21427
22080
  * @returns Value of property `tokenizerTitle`
21428
22081
  */
21429
22082
  getTokenizerTitle(): string;
22083
+ /**
22084
+ * If the container is used for typeahead it might be wanted that the same content should also be shown
22085
+ * as valuehelp. If not, the field should not show a valuehelp icon.
22086
+ *
22087
+ *
22088
+ * @returns `true` if the typeahead content can be used as value help
22089
+ */
22090
+ getUseAsValueHelp(): boolean;
21430
22091
  /**
21431
22092
  * Returns the used `ValueHelpDelegate`.
21432
22093
  *
@@ -21492,6 +22153,13 @@ declare module "sap/ui/mdc/valuehelp/base/Content" {
21492
22153
  * @returns `true` if opening
21493
22154
  */
21494
22155
  isContainerOpening(): boolean;
22156
+ /**
22157
+ * Returns info if the given content is in multi select mode
22158
+ *
22159
+ *
22160
+ * @returns `true` if multi-selection is active.
22161
+ */
22162
+ isMultiSelect(): boolean;
21495
22163
  /**
21496
22164
  * Returns if the value help is used for single selection.
21497
22165
  *
@@ -21510,6 +22178,13 @@ declare module "sap/ui/mdc/valuehelp/base/Content" {
21510
22178
  * @returns `true` if used as `typeahead`
21511
22179
  */
21512
22180
  isTypeahead(): boolean;
22181
+ /**
22182
+ * Defines if the typeahead can be used for input validation.
22183
+ *
22184
+ *
22185
+ * @returns True if the typeahead container can be used for input validation
22186
+ */
22187
+ isValidationSupported(): boolean;
21513
22188
  /**
21514
22189
  * Determines if delegate of the value help has been initialized.
21515
22190
  *
@@ -21518,6 +22193,15 @@ declare module "sap/ui/mdc/valuehelp/base/Content" {
21518
22193
  * @returns `true` if delegate has been initialized
21519
22194
  */
21520
22195
  isValueHelpDelegateInitialized(): boolean;
22196
+ /**
22197
+ * Navigates the typeaheads values (optional)
22198
+ */
22199
+ navigate(
22200
+ /**
22201
+ * Number of steps for navigation (e.g. 1 means next item, -1 means previous item)
22202
+ */
22203
+ iStep: int
22204
+ ): void;
21521
22205
  /**
21522
22206
  * Observes property and aggregation changes.
21523
22207
  *
@@ -21557,6 +22241,11 @@ declare module "sap/ui/mdc/valuehelp/base/Content" {
21557
22241
  * @returns `true` if a scrolling mechanism is needed
21558
22242
  */
21559
22243
  provideScrolling(): boolean;
22244
+ /**
22245
+ * The focus visualization of the field help needs to be removed as the user starts typing into the source
22246
+ * control.
22247
+ */
22248
+ removeVisualFocus(): void;
21560
22249
  /**
21561
22250
  * Sets a new value for property {@link #getShortTitle shortTitle}.
21562
22251
  *
@@ -21629,6 +22318,28 @@ declare module "sap/ui/mdc/valuehelp/base/Content" {
21629
22318
  */
21630
22319
  bVisible?: boolean
21631
22320
  ): this;
22321
+ /**
22322
+ * The focus visualization of the field help needs to be set as the user starts naigation into the value
22323
+ * help items.
22324
+ *
22325
+ * @since 1.127.0
22326
+ */
22327
+ setVisualFocus(): void;
22328
+ /**
22329
+ * Defines if the typeahead content desires opening the typeahead whenever a user clicks on a connected
22330
+ * control
22331
+ *
22332
+ *
22333
+ * @returns If `true`, the value help should open when user clicks into the connected field control
22334
+ */
22335
+ shouldOpenOnClick(): boolean;
22336
+ /**
22337
+ * Defines if the typeahead containers values can be navigated without visibly opening the help
22338
+ *
22339
+ *
22340
+ * @returns If `true`, the value help should open when user used the arrow keys in the connected field control
22341
+ */
22342
+ shouldOpenOnNavigate(): boolean;
21632
22343
  }
21633
22344
  /**
21634
22345
  * Describes the settings that can be provided to the Content constructor.
@@ -21741,7 +22452,7 @@ declare module "sap/ui/mdc/valuehelp/base/Content" {
21741
22452
  /**
21742
22453
  * Type of the selection change (add, remove)
21743
22454
  */
21744
- type?: /* was: sap.ui.mdc.enums.ValueHelpSelectionType */ any;
22455
+ type?: ValueHelpSelectionType | keyof typeof ValueHelpSelectionType;
21745
22456
 
21746
22457
  /**
21747
22458
  * Changed conditions
@@ -21821,8 +22532,6 @@ declare module "sap/ui/mdc/valuehelp/base/FilterableListContent" {
21821
22532
 
21822
22533
  import FilterBar from "sap/ui/mdc/valuehelp/FilterBar";
21823
22534
 
21824
- import Context from "sap/ui/model/Context";
21825
-
21826
22535
  import {
21827
22536
  AggregationBindingInfo,
21828
22537
  PropertyBindingInfo,
@@ -21979,7 +22688,7 @@ declare module "sap/ui/mdc/valuehelp/base/FilterableListContent" {
21979
22688
  *
21980
22689
  * Default value is `empty string`.
21981
22690
  *
21982
- * @deprecated (since 1.120.2) - please see `{@link module:sap/ui/mdc/ValueHelpDelegate.isSearchSupported isSearchSupported}`
22691
+ * @deprecated (since 1.120.2) - replaced by {@link module:sap/ui/mdc/ValueHelpDelegate.isSearchSupported isSearchSupported}
21983
22692
  *
21984
22693
  * @returns Value of property `filterFields`
21985
22694
  */
@@ -21997,23 +22706,6 @@ declare module "sap/ui/mdc/valuehelp/base/FilterableListContent" {
21997
22706
  * @returns Value of property `group`
21998
22707
  */
21999
22708
  getGroup(): string;
22000
- /**
22001
- * Gets an item for a `BindingContext`.
22002
- *
22003
- * @ui5-protected Do not call from applications (only from related classes in the framework)
22004
- *
22005
- * @returns Item object containing `key`, `description`, and `payload`
22006
- */
22007
- getItemFromContext(
22008
- /**
22009
- * BindingContext
22010
- */
22011
- oBindingContext: Context,
22012
- /**
22013
- * Options
22014
- */
22015
- oOptions?: object
22016
- ): object;
22017
22709
  /**
22018
22710
  * Gets current value of property {@link #getKeyPath keyPath}.
22019
22711
  *
@@ -22102,7 +22794,7 @@ declare module "sap/ui/mdc/valuehelp/base/FilterableListContent" {
22102
22794
  *
22103
22795
  * Default value is `empty string`.
22104
22796
  *
22105
- * @deprecated (since 1.120.2) - please see `{@link module:sap/ui/mdc/ValueHelpDelegate.isSearchSupported isSearchSupported}`
22797
+ * @deprecated (since 1.120.2) - replaced by {@link module:sap/ui/mdc/ValueHelpDelegate.isSearchSupported isSearchSupported}
22106
22798
  *
22107
22799
  * @returns Reference to `this` in order to allow method chaining
22108
22800
  */
@@ -22169,7 +22861,7 @@ declare module "sap/ui/mdc/valuehelp/base/FilterableListContent" {
22169
22861
  *
22170
22862
  * If it is empty, no suggestion is available.
22171
22863
  *
22172
- * @deprecated (since 1.120.2) - please see `{@link module:sap/ui/mdc/ValueHelpDelegate.isSearchSupported isSearchSupported}`
22864
+ * @deprecated (since 1.120.2) - replaced by {@link module:sap/ui/mdc/ValueHelpDelegate.isSearchSupported isSearchSupported}
22173
22865
  */
22174
22866
  filterFields?: string | PropertyBindingInfo;
22175
22867
 
@@ -22205,6 +22897,8 @@ declare module "sap/ui/mdc/valuehelp/base/ListContent" {
22205
22897
  $ContentSettings,
22206
22898
  } from "sap/ui/mdc/valuehelp/base/Content";
22207
22899
 
22900
+ import Context from "sap/ui/model/Context";
22901
+
22208
22902
  import ListBinding from "sap/ui/model/ListBinding";
22209
22903
 
22210
22904
  import ElementMetadata from "sap/ui/core/ElementMetadata";
@@ -22299,21 +22993,41 @@ declare module "sap/ui/mdc/valuehelp/base/ListContent" {
22299
22993
  */
22300
22994
  getCaseSensitive(): boolean;
22301
22995
  /**
22302
- * Gets current descriptionPath of the content. **Note:** Every listcontent must implement this method.
22996
+ * Gets current descriptionPath of the content.
22997
+ * **Note:** Every listcontent must implement this method.
22303
22998
  *
22304
22999
  *
22305
23000
  * @returns Content description path
22306
23001
  */
22307
23002
  getDescriptionPath(): string;
22308
23003
  /**
22309
- * Gets current keyPath of the content. **Note:** Every listcontent must implement this method.
23004
+ * Gets an item for a `BindingContext`.
23005
+ *
23006
+ * @ui5-protected Do not call from applications (only from related classes in the framework)
23007
+ *
23008
+ * @returns Item object containing `key`, `description`, and `payload`
23009
+ */
23010
+ getItemFromContext(
23011
+ /**
23012
+ * BindingContext
23013
+ */
23014
+ oBindingContext: Context,
23015
+ /**
23016
+ * Options
23017
+ */
23018
+ oOptions?: object
23019
+ ): object;
23020
+ /**
23021
+ * Gets current keyPath of the content.
23022
+ * **Note:** Every listcontent must implement this method.
22310
23023
  *
22311
23024
  *
22312
23025
  * @returns Content key path
22313
23026
  */
22314
23027
  getKeyPath(): string;
22315
23028
  /**
22316
- * Gets the `ListBinding` of the content. **Note:** Every listcontent must implement this method.
23029
+ * Gets the `ListBinding` of the content.
23030
+ * **Note:** Every listcontent must implement this method.
22317
23031
  *
22318
23032
  *
22319
23033
  * @returns `ListBinding`
@@ -22449,6 +23163,8 @@ declare module "sap/ui/mdc/valuehelp/content/Conditions" {
22449
23163
  $ContentSettings,
22450
23164
  } from "sap/ui/mdc/valuehelp/base/Content";
22451
23165
 
23166
+ import { valuehelp } from "sap/ui/mdc/library";
23167
+
22452
23168
  import { ID } from "sap/ui/core/library";
22453
23169
 
22454
23170
  import ElementMetadata from "sap/ui/core/ElementMetadata";
@@ -22462,7 +23178,12 @@ declare module "sap/ui/mdc/valuehelp/content/Conditions" {
22462
23178
  *
22463
23179
  * @since 1.95.0
22464
23180
  */
22465
- export default class Conditions extends Content {
23181
+ export default class Conditions
23182
+ extends Content
23183
+ implements valuehelp.base.ITypeaheadContent, valuehelp.base.IDialogContent
23184
+ {
23185
+ __implements__sap_ui_mdc_valuehelp_base_ITypeaheadContent: boolean;
23186
+ __implements__sap_ui_mdc_valuehelp_base_IDialogContent: boolean;
22466
23187
  /**
22467
23188
  * Constructor for a new `Conditions` content.
22468
23189
  *
@@ -22603,10 +23324,14 @@ declare module "sap/ui/mdc/valuehelp/content/Conditions" {
22603
23324
  * Optional `FieldHelp`.
22604
23325
  *
22605
23326
  * This is an association that allows the usage of one `FieldHelp` instance for the value fields for the
22606
- * `Conditions`. **Note:** The value fields on the conditions UI cannot be accessed from outside. The fields
22607
- * are single-value input, and the display is always set to `FieldDisplay.Value`. Only a `ValueHelp>/code>
22608
- * with a TypeAhead` and a single-selection `MTable` can be used. **Note:** For `Boolean`, `Date`,
22609
- * or `Time` types, no `FieldHelp` should be added, but a default `FieldHelp` used instead.
23327
+ * `Conditions`.
23328
+ *
23329
+ * **Note:** The value fields on the conditions UI cannot be accessed from outside. The fields are single-value
23330
+ * input, and the display is always set to `FieldDisplay.Value`. Only a `ValueHelp` with a `TypeAhead` and
23331
+ * a single-selection `MTable` can be used.
23332
+ *
23333
+ * **Note:** For `Boolean`, `Date`, or `Time` types, no `FieldHelp` should be added, but a default `FieldHelp`
23334
+ * used instead.
22610
23335
  *
22611
23336
  * @deprecated (since 1.114.0) - replaced by {@link #setValueHelp valueHelp} association
22612
23337
  */
@@ -22619,8 +23344,8 @@ declare module "sap/ui/mdc/valuehelp/content/Conditions" {
22619
23344
  * `Conditions`.
22620
23345
  *
22621
23346
  * **Note:** The value fields on the conditions UI cannot be accessed from outside. The fields are single-value
22622
- * input, and the display is always set to `FieldDisplay.Value`. Only a `ValueHelp>/code> with a TypeAhead`
22623
- * and a single-selection `MTable` can be used.
23347
+ * input, and the display is always set to `FieldDisplay.Value`. Only a `ValueHelp` with a `TypeAhead` and
23348
+ * a single-selection `MTable` can be used.
22624
23349
  *
22625
23350
  * **Note:** For `Boolean`, `Date`, or `Time` types, no `ValueHelp` should be added, but a default `ValueHelp`
22626
23351
  * used instead.
@@ -22635,6 +23360,8 @@ declare module "sap/ui/mdc/valuehelp/content/FixedList" {
22635
23360
  $ListContentSettings,
22636
23361
  } from "sap/ui/mdc/valuehelp/base/ListContent";
22637
23362
 
23363
+ import { valuehelp } from "sap/ui/mdc/library";
23364
+
22638
23365
  import FixedListItem from "sap/ui/mdc/valuehelp/content/FixedListItem";
22639
23366
 
22640
23367
  import ElementMetadata from "sap/ui/core/ElementMetadata";
@@ -22650,7 +23377,12 @@ declare module "sap/ui/mdc/valuehelp/content/FixedList" {
22650
23377
  *
22651
23378
  * @since 1.95.0
22652
23379
  */
22653
- export default class FixedList extends ListContent {
23380
+ export default class FixedList
23381
+ extends ListContent
23382
+ implements valuehelp.base.ITypeaheadContent, valuehelp.base.IDialogContent
23383
+ {
23384
+ __implements__sap_ui_mdc_valuehelp_base_ITypeaheadContent: boolean;
23385
+ __implements__sap_ui_mdc_valuehelp_base_IDialogContent: boolean;
22654
23386
  /**
22655
23387
  * Constructor for a new `FixedList` content.
22656
23388
  *
@@ -23052,6 +23784,8 @@ declare module "sap/ui/mdc/valuehelp/Dialog" {
23052
23784
  $ContainerSettings,
23053
23785
  } from "sap/ui/mdc/valuehelp/base/Container";
23054
23786
 
23787
+ import { valuehelp } from "sap/ui/mdc/library";
23788
+
23055
23789
  import { PopupInterface } from "sap/ui/core/library";
23056
23790
 
23057
23791
  import ElementMetadata from "sap/ui/core/ElementMetadata";
@@ -23077,7 +23811,11 @@ declare module "sap/ui/mdc/valuehelp/Dialog" {
23077
23811
  *
23078
23812
  * @since 1.95.0
23079
23813
  */
23080
- export default class Dialog extends Container implements PopupInterface {
23814
+ export default class Dialog
23815
+ extends Container
23816
+ implements valuehelp.base.IDialogContainer, PopupInterface
23817
+ {
23818
+ __implements__sap_ui_mdc_valuehelp_base_IDialogContainer: boolean;
23081
23819
  __implements__sap_ui_core_PopupInterface: boolean;
23082
23820
  /**
23083
23821
  * Constructor for a new `Dialog` container.
@@ -23240,7 +23978,11 @@ declare module "sap/ui/mdc/valuehelp/content/MDCTable" {
23240
23978
  *
23241
23979
  * @since 1.95.0
23242
23980
  */
23243
- export default class MDCTable extends FilterableListContent {
23981
+ export default class MDCTable
23982
+ extends FilterableListContent
23983
+ implements /* was: sap.ui.mdc.valuehelp.IDialogContent */ Object
23984
+ {
23985
+ __implements__sap_ui_mdc_valuehelp_IDialogContent: boolean;
23244
23986
  /**
23245
23987
  * Constructor for a new `MDCTable` content.
23246
23988
  *
@@ -23397,6 +24139,8 @@ declare module "sap/ui/mdc/valuehelp/content/MTable" {
23397
24139
  $FilterableListContentSettings,
23398
24140
  } from "sap/ui/mdc/valuehelp/base/FilterableListContent";
23399
24141
 
24142
+ import { valuehelp } from "sap/ui/mdc/library";
24143
+
23400
24144
  import Event from "sap/ui/base/Event";
23401
24145
 
23402
24146
  import ElementMetadata from "sap/ui/core/ElementMetadata";
@@ -23408,7 +24152,12 @@ declare module "sap/ui/mdc/valuehelp/content/MTable" {
23408
24152
  *
23409
24153
  * @since 1.95.0
23410
24154
  */
23411
- export default class MTable extends FilterableListContent {
24155
+ export default class MTable
24156
+ extends FilterableListContent
24157
+ implements valuehelp.base.ITypeaheadContent, valuehelp.base.IDialogContent
24158
+ {
24159
+ __implements__sap_ui_mdc_valuehelp_base_ITypeaheadContent: boolean;
24160
+ __implements__sap_ui_mdc_valuehelp_base_IDialogContent: boolean;
23412
24161
  /**
23413
24162
  * Constructor for a new `MTable` content.
23414
24163
  *
@@ -23731,7 +24480,7 @@ declare module "sap/ui/mdc/valuehelp/FilterBar" {
23731
24480
  * Sample delegate object:
23732
24481
  * ```javascript
23733
24482
  * {
23734
- * name: "sap/ui/mdc/BaseDelegate",
24483
+ * name: "sap/ui/valuehelp/FilterBarDelegate",
23735
24484
  * payload: {}
23736
24485
  * }```
23737
24486
  * **Note:** Ensure that the related file can be requested (any required library has to be loaded before
@@ -23778,7 +24527,7 @@ declare module "sap/ui/mdc/valuehelp/FilterBar" {
23778
24527
  * Sample delegate object:
23779
24528
  * ```javascript
23780
24529
  * {
23781
- * name: "sap/ui/mdc/BaseDelegate",
24530
+ * name: "sap/ui/valuehelp/FilterBarDelegate",
23782
24531
  * payload: {}
23783
24532
  * }```
23784
24533
  * **Note:** Ensure that the related file can be requested (any required library has to be loaded before
@@ -23849,7 +24598,7 @@ declare module "sap/ui/mdc/valuehelp/FilterBar" {
23849
24598
  * Sample delegate object:
23850
24599
  * ```javascript
23851
24600
  * {
23852
- * name: "sap/ui/mdc/BaseDelegate",
24601
+ * name: "sap/ui/valuehelp/FilterBarDelegate",
23853
24602
  * payload: {}
23854
24603
  * }```
23855
24604
  * **Note:** Ensure that the related file can be requested (any required library has to be loaded before
@@ -23876,6 +24625,8 @@ declare module "sap/ui/mdc/valuehelp/Popover" {
23876
24625
  $ContainerSettings,
23877
24626
  } from "sap/ui/mdc/valuehelp/base/Container";
23878
24627
 
24628
+ import { valuehelp } from "sap/ui/mdc/library";
24629
+
23879
24630
  import { PopupInterface } from "sap/ui/core/library";
23880
24631
 
23881
24632
  import ElementMetadata from "sap/ui/core/ElementMetadata";
@@ -23887,7 +24638,15 @@ declare module "sap/ui/mdc/valuehelp/Popover" {
23887
24638
  *
23888
24639
  * @since 1.95.0
23889
24640
  */
23890
- export default class Popover extends Container implements PopupInterface {
24641
+ export default class Popover
24642
+ extends Container
24643
+ implements
24644
+ valuehelp.base.ITypeaheadContainer,
24645
+ valuehelp.base.IDialogContainer,
24646
+ PopupInterface
24647
+ {
24648
+ __implements__sap_ui_mdc_valuehelp_base_ITypeaheadContainer: boolean;
24649
+ __implements__sap_ui_mdc_valuehelp_base_IDialogContainer: boolean;
23891
24650
  __implements__sap_ui_core_PopupInterface: boolean;
23892
24651
  /**
23893
24652
  * Constructor for a new `Popover` container.