@grapecity/wijmo.input 5.20241.9 → 5.20242.21

package/index.d.ts

@@ -1,6 +1,6 @@
 /*!
     *
-    * Wijmo Library 5.20241.9
+    * Wijmo Library 5.20242.21
     * https://developer.mescius.com/wijmo
     *
     * Copyright(c) MESCIUS inc. All rights reserved.
@@ -1072,7 +1072,7 @@ export declare class MultiSelectListBox<T = any> extends Control {
      * The default value for this property is a very big number, meaning virtualization is
      * disabled. To enable virtualization, set its value to 0 or a positive number.
      *
-     * For more detals, please see the {@link ListBox.virtializationThreshold}
+     * For more detals, please see the {@link ListBox.virtualizationThreshold}
      * property.
      */
     virtualizationThreshold: number;
@@ -2554,6 +2554,23 @@ export declare class PopupBoundsChangingEventArgs extends CancelEventArgs {
      */
     readonly bounds: Rect;
 }
+/**
+ * Provides arguments for {@link InputDate}'s invalidInput event.
+ */
+export declare class InputDateEventArgs extends CancelEventArgs {
+    _isUserInput: boolean;
+    /**
+     * Initializes a new instance of the {@link InputDateEventArgs} class.
+     *
+     * @param isUserInput boolean value to distinguish user input from value set in code
+     */
+    constructor(isUserInput: boolean);
+    /**
+     * Gets a value that determines whether invalid value was
+     * provided by user or set in code
+     */
+    readonly isUserInput: boolean;
+}
 /**
  * The {@link InputDate} control allows users to type in dates using any format
  * supported by the {@link Globalize} class, or to pick dates from a drop-down
@@ -2601,6 +2618,9 @@ export declare class InputDate extends DropDown {
     private _clicked;
     private _rangeChanged;
     private _textInitialized;
+    private _previousText;
+    private _keepInvalidText;
+    protected _currentInput: string;
     /**
      * Initializes a new instance of the {@link InputDate} class.
      *
@@ -2608,6 +2628,7 @@ export declare class InputDate extends DropDown {
      * @param options The JavaScript object containing initialization data for the control.
      */
     constructor(element: any, options?: any);
+    protected _mouseWheel(e: WheelEvent): void;
     /**
      * Gets or sets the currently selected date.
      *
@@ -2644,6 +2665,16 @@ export declare class InputDate extends DropDown {
      * there is no maximum value for range lengths.
      */
     rangeMax: number;
+    /**
+     * Gets or sets whether to allow invalid text
+     *
+     * This property is used only when invalid text is set through
+     * {@link text} property in code and does not affect the behavior
+     * when invalid value is set by the end user
+     *
+     * The default value for this property is false.
+     */
+    keepInvalidText: boolean;
     /**
      * Gets or sets the text shown on the control.
      */
@@ -2963,8 +2994,11 @@ export declare class InputDate extends DropDown {
     onIsDroppedDownChanging(e: CancelEventArgs): boolean;
     onIsDroppedDownChanged(e?: EventArgs): void;
     _updateDropDown(): void;
+    onGotFocus(e?: EventArgs): void;
     protected _keydown(e: KeyboardEvent): void;
     protected _expandSelection(): void;
+    protected _updateDateTimeValue(step: number, specialChars: any, actualFormat: string): void;
+    protected _reselectText(specialChars: string[], currentPos: number): void;
     _refreshText(): void;
     protected _selectAll(): void;
     _closeOnChange(): void;
@@ -2972,8 +3006,10 @@ export declare class InputDate extends DropDown {
     _clamp(value: Date): Date;
     protected _getText(): string;
     protected _commitText(noFocus?: boolean): void;
+    protected _triggerInvalidInputEvent(cancelEvtArgs: InputDateEventArgs, val: Date, rangeEnd?: Date): void;
+    protected _nullValueInvalidInput(cancelEvtArgs: InputDateEventArgs): void;
     protected _fromDateTime(value: Date): Date;
-    private _canChangeValue;
+    protected _canChangeValue(): boolean;
     protected _isValidDate(value: Date): boolean;
     private _getRanges;
     private _updateRangeSelection;
@@ -3001,6 +3037,9 @@ export declare class InputDateRange extends InputDate {
      */
     constructor(element: any, options?: any);
     selectionMode: DateSelectionMode;
+    protected _mouseWheel(e: WheelEvent): void;
+    onGotFocus(e?: EventArgs): void;
+    protected _keydown(e: KeyboardEvent): void;
 }
 /**
  * The {@link InputColor} control allows users to select colors by typing in
@@ -3037,6 +3076,14 @@ export declare class InputColor extends DropDown {
      * Gets or sets the text shown on the control.
      */
     text: string;
+    /**
+     * Gets or sets the "type" attribute of the HTML input element hosted
+     * by the control.
+     *
+     * Use this property to change the default setting if the default does not work well
+     * for the current culture, device, or application. In those cases, try changing
+     * the value to "tel" or "text"
+     */
     inputType: string;
     /**
      * Gets or sets a value indicating whether the {@link ColorPicker}
@@ -3119,6 +3166,7 @@ export declare class ComboBox<T = any> extends DropDown {
     _delKey: number;
     _draggingText: boolean;
     _composing: boolean;
+    _textIsComposing: string;
     _settingText: boolean;
     _pathHdr: Binding;
     _bsCollapse: boolean;
@@ -3160,7 +3208,7 @@ export declare class ComboBox<T = any> extends DropDown {
      * The default value for this property is a very big number, meaning virtualization is
      * disabled. To enable virtualization, set its value to 0 or a positive number.
      *
-     * For more detals, please see the {@link ListBox.virtializationThreshold}
+     * For more detals, please see the {@link ListBox.virtualizationThreshold}
      * property.
      */
     virtualizationThreshold: number;
@@ -3360,7 +3408,7 @@ export declare class ComboBox<T = any> extends DropDown {
     protected _createDropDown(): void;
     protected _wheel(e: WheelEvent): void;
     protected _dropDownClick(e: MouseEvent): void;
-    protected _setText(text: string, fullMatch: boolean): void;
+    protected _setText(text: string, fullMatch: boolean, isDateTime?: boolean): void;
     protected _findNext(search: string, step: number, start?: number): number;
     protected _keydown(e: KeyboardEvent): void;
     protected _input(e: Event): void;
@@ -3550,7 +3598,7 @@ export declare class MultiSelect extends ComboBox {
  *
  * For details, please see the {@link Menu.command} property.
  */
-interface ICommand {
+export interface ICommand {
     /**
      * Executes the command with a given parameter.
      *
@@ -3613,6 +3661,8 @@ export declare class Menu extends ComboBox {
     _hoverEnterBnd: any;
     _hoverLeaveBnd: any;
     _hoverOverBnd: any;
+    _ariaLabel: string;
+    _aFEnabledItem: boolean;
     static _evtHover: MouseEvent;
     /**
      * Initializes a new instance of the {@link Menu} class.
@@ -3621,6 +3671,19 @@ export declare class Menu extends ComboBox {
      * @param options The JavaScript object containing initialization data for the control.
      */
     constructor(element: any, options?: any);
+    /**
+     * Gets or sets the aria-label attribute of {@link Menu} element.
+     *
+     * The default value for this property is "Menu".
+     */
+    ariaLabel: string;
+    /**
+     * Gets or sets a value that determines whether the first enabled item is automatically focused/selected in the {@link dropDown}.
+     * Used to add provide appropriate navigation when accessibility tools are used.
+     *
+     * The default value for this property is false.
+     */
+    autoSelectOnFocus: boolean;
     /**
      * Gets or sets the HTML text shown in the {@link Menu} element.
      *
@@ -3957,7 +4020,12 @@ export declare class InputTime extends ComboBox {
     protected _updateInputSelection(start: number): void;
     protected _updateItems(): void;
     private _getTime;
+    protected _getText(): string;
+    protected _canChangeValue(): boolean;
+    protected getSeconds(val: Date): number;
     protected _keydown(e: KeyboardEvent): void;
+    protected _updateTimeValue(step: number, specialChars: any, actualFormat: string): void;
+    private _reselectText;
     protected _commitText(): void;
     protected _copy(key: string, value: any): boolean;
 }
@@ -4050,6 +4118,10 @@ export declare class InputDateTime extends InputDate {
     protected _updateBtn(): void;
     protected _setDropdown(e: HTMLElement): boolean;
     _updateDropDown(): void;
+    protected _mouseWheel(e: WheelEvent): void;
+    protected _keydown(e: KeyboardEvent): void;
+    protected _updateDateTimeValue(step: number, specialChars: any, actualFormat: string): void;
+    protected _commitText(): void;
 }
 /**
  * Represents a method that returns data items asynchronously as the user types.
@@ -4095,6 +4167,7 @@ export declare class AutoComplete extends ComboBox {
     private _itemCount;
     private _beginsWith;
     private _delay;
+    _selItems: any;
     private _toSearch;
     private _query;
     private _rxSrch;
@@ -4102,6 +4175,7 @@ export declare class AutoComplete extends ComboBox {
     private _inCallback;
     private _srchProps;
     private _oldSelectedIndex;
+    _pendingSearchFn: any;
     /**
      * Initializes a new instance of the {@link AutoComplete} class.
      *
@@ -4204,8 +4278,13 @@ export declare class AutoComplete extends ComboBox {
     */
     onSelectedIndexChanged(e?: EventArgs): void;
     _keydown(e: KeyboardEvent): void;
+    private _isBlurInput;
+    protected _commitText(noFocus?: boolean): void;
     _setText(text: string | null): void;
     onLostFocus(e?: EventArgs): void;
+    private _ctrlReset;
+    onGotFocus(e?: EventArgs): void;
+    reset(): void;
     _itemSourceFunctionCallback(result: any[]): void;
     onIsDroppedDownChanged(e?: EventArgs): void;
     protected _updateItems(): void;
@@ -4228,7 +4307,6 @@ export declare class MultiAutoComplete extends AutoComplete {
     private _wjTpl;
     private _wjInput;
     private _helperInput;
-    private _selItems;
     private _maxSelItems;
     private _lastInputValue;
     private _selPath;