@grapecity/wijmo.input 5.20241.19 → 5.20242.30

package/index.d.ts

@@ -1,6 +1,6 @@
 /*!
     *
-    * Wijmo Library 5.20241.19
+    * Wijmo Library 5.20242.30
     * https://developer.mescius.com/wijmo
     *
     * Copyright(c) MESCIUS inc. All rights reserved.
@@ -20,6 +20,106 @@
 export declare var ___keepComment: any;
 import { Control, Event, EventArgs, CancelEventArgs, Binding, Rect, ICollectionView, CollectionViewGroup, _ClickRepeater, CollectionView, _MaskProvider, PopupPosition } from '@grapecity/wijmo';
 import * as selfModule from '@grapecity/wijmo.input';
+export declare const AutoCompleteClsNames: {
+    hostElement: string;
+};
+export declare const CalendarClsNames: {
+    buttonsOutside: string;
+    calendarHeader: string;
+    calendarMonth: string;
+    calendarMultiMonth: string;
+    calendarOuter: string;
+    calendarYear: string;
+    dayOtherMonth: string;
+    dayToday: string;
+    dayWeekend: string;
+    header: string;
+    hostElement: string;
+    monthSelect: string;
+    weekAfter: string;
+    weekBefore: string;
+    yearPicker: string;
+};
+export declare const CollectionViewNavigatorClsNames: {
+    hostElement: string;
+    pager: string;
+};
+export declare const ColorPickerClsNames: {
+    colorBox: string;
+    hostElement: string;
+};
+export declare const ComboBoxClsNames: {
+    hostElement: string;
+    stateMatch: string;
+};
+export declare const DropDownClsNames: {
+    dropDownPanel: string;
+    hostElement: string;
+};
+export declare const InputClsNames: {
+    input: string;
+    inputBtnVisible: string;
+    inputGroup: string;
+    inputGroupBtn: string;
+};
+export declare const InputColorClsNames: {
+    hostElement: string;
+    inputColorBox: string;
+};
+export declare const InputDateClsNames: {
+    hostElement: string;
+    inputDateDropDown: string;
+};
+export declare const InputDateRangeClsNames: {
+    hostElement: string;
+};
+export declare const InputDateTimeClsNames: {
+    hostElement: string;
+};
+export declare const InputMaskClsNames: {
+    hostElement: string;
+};
+export declare const InputNumberClsNames: {
+    hostElement: string;
+    numeric: string;
+    showSpinner: string;
+};
+export declare const InputTimeClsNames: {
+    hostElement: string;
+};
+export declare const ListBoxClsNames: {
+    header: string;
+    hostElement: string;
+    listBoxItem: string;
+};
+export declare const MenuClsNames: {
+    hostElement: string;
+    menuItems: string;
+    subItems: string;
+};
+export declare const MultiAutoCompleteClsNames: {
+    hostElement: string;
+    token: string;
+    tokenActive: string;
+    tokenClose: string;
+    tokenHelper: string;
+    tokenLabel: string;
+};
+export declare const MultiSelectClsNames: {
+    hostElement: string;
+};
+export declare const MultiSelectListBoxClsNames: {
+    header: string;
+    hostElement: string;
+    selectAll: string;
+};
+export declare const PopupClsNames: {
+    dialogHeader: string;
+    hostElement: string;
+    popupBackDrop: string;
+    dialogBody: string;
+    dialogFooter: string;
+};
 /**
  * The {@link InputNumber} control allows users to enter numbers.
  *
@@ -72,6 +172,7 @@ export declare class InputNumber extends Control {
     _rptUp: _ClickRepeater;
     _rptDn: _ClickRepeater;
     _fromKb: boolean;
+    static _ctrlTemplate: string;
     /**
      * Gets or sets the template used to instantiate {@link InputNumber} controls.
      */
@@ -285,6 +386,7 @@ export declare class InputMask extends Control {
     _value: string;
     _msk: _MaskProvider;
     _fullEdit: boolean;
+    static _ctrlTemplate: string;
     /**
      * Gets or sets the template used to instantiate {@link InputMask} controls.
      */
@@ -386,7 +488,6 @@ export declare class InputMask extends Control {
     _commitText(): void;
     dispose(): void;
     refresh(fullUpdate?: boolean): void;
-    _isGridImeEnabled(): boolean;
     onGotFocus(e: any): void;
 }
 /**
@@ -414,6 +515,7 @@ export declare class ColorPicker extends Control {
     _ePreview: HTMLElement;
     _eText: HTMLElement;
     _htDown: Element;
+    static _ctrlTemplate: string;
     /**
      * Gets or sets the template used to instantiate {@link ColorPicker} controls.
      */
@@ -513,6 +615,7 @@ export declare class CollectionViewNavigator<T = any> extends Control {
     private _rptNext;
     private _rptPrev;
     private _fmt;
+    static _ctrlTemplate: string;
     /**
      * Gets or sets the template used to instantiate {@link  CollectionViewNavigator} controls.
      */
@@ -1045,6 +1148,7 @@ export declare class MultiSelectListBox<T = any> extends Control {
     _delay: number;
     _toSearch: any;
     static _DEF_CHECKED_PATH: string;
+    static _ctrlTemplate: string;
     /**
      * Gets or sets the template used to instantiate {@link MultiSelectListBox} controls.
      */
@@ -1072,7 +1176,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;
@@ -1377,6 +1481,7 @@ export declare class Calendar extends Control {
     private _fmtDay;
     private _fmtMonths;
     static _DATE_KEY: string;
+    static _ctrlTemplate: string;
     /**
      * Gets or sets the template used to instantiate {@link Calendar} controls.
      */
@@ -1794,6 +1899,8 @@ export declare class DropDown extends Control {
     _oldText: string;
     _minWidthDropdown: string;
     _escapeIE: boolean;
+    _isInvalidInputCancelled: boolean;
+    static _ctrlTemplate: string;
     /**
      * Gets or sets the template used to instantiate {@link DropDown} controls.
      */
@@ -1862,7 +1969,7 @@ export declare class DropDown extends Control {
      * The default value for this property is **false**.
      */
     isDroppedDown: boolean;
-    _toogleDropDown(isDroppedDown: boolean): void;
+    _toggleDropDown(isDroppedDown: boolean): void;
     /**
      * Gets the drop down element shown when the {@link isDroppedDown}
      * property is set to true.
@@ -1934,7 +2041,7 @@ export declare class DropDown extends Control {
     _handleResize(): void;
     protected _dropDownClick(e: MouseEvent): void;
     protected _expandSelection(): void;
-    protected _getCharType(text: string, pos: number): 1 | -1 | 0;
+    protected _getCharType(text: string, pos: number): 0 | 1 | -1;
     protected _keydown(e: KeyboardEvent): void;
     protected _isHiddenEditor(): boolean;
     protected _keypress(e: KeyboardEvent): void;
@@ -2554,6 +2661,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
@@ -2598,9 +2722,13 @@ export declare class InputDate extends DropDown {
     private _showCal;
     private _clsOnSel;
     private _handleWheel;
+    private _preserveCalendarNavigation;
     private _clicked;
     private _rangeChanged;
     private _textInitialized;
+    private _previousText;
+    private _keepInvalidText;
+    protected _currentInput: string;
     /**
      * Initializes a new instance of the {@link InputDate} class.
      *
@@ -2645,6 +2773,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.
      */
@@ -2895,6 +3033,13 @@ export declare class InputDate extends DropDown {
      * the value to "tel" or "text"
      */
     inputType: string;
+    /**
+     * Gets or sets a value that determines whether to preserve the month
+     * when user navigates to a different month than the selected date.
+     *
+     * The default value for this property is **true**.
+     */
+    preserveCalendarNavigation: boolean;
     /**
      * Gets or sets a validator function to determine whether dates are valid for selection.
      *
@@ -2976,6 +3121,8 @@ 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;
     protected _canChangeValue(): boolean;
     protected _isValidDate(value: Date): boolean;
@@ -3143,6 +3290,7 @@ export declare class ComboBox<T = any> extends DropDown {
     _oldIndexToBeRestoredOnBlur: null | number;
     _restoreComboboxTbxVal: boolean;
     _isWheel: boolean;
+    _selItems: any;
     /**
      * Initializes a new instance of the {@link ComboBox} class.
      *
@@ -3176,7 +3324,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;
@@ -4022,6 +4170,7 @@ export declare class InputDateTime extends InputDate {
     private _inputTime;
     private _ddDate;
     private _ddTime;
+    static _ctrlTemplate: string;
     /**
      * Gets or sets the template used to instantiate {@link InputDateTime} controls.
      */
@@ -4089,6 +4238,7 @@ export declare class InputDateTime extends InputDate {
     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.
@@ -4134,6 +4284,7 @@ export declare class AutoComplete extends ComboBox {
     private _itemCount;
     private _beginsWith;
     private _delay;
+    _selItems: any;
     private _toSearch;
     private _query;
     private _rxSrch;
@@ -4244,8 +4395,12 @@ 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;
+    onGotFocus(e?: EventArgs): void;
+    reset(): void;
     _itemSourceFunctionCallback(result: any[]): void;
     onIsDroppedDownChanged(e?: EventArgs): void;
     protected _updateItems(): void;
@@ -4268,7 +4423,6 @@ export declare class MultiAutoComplete extends AutoComplete {
     private _wjTpl;
     private _wjInput;
     private _helperInput;
-    private _selItems;
     private _maxSelItems;
     private _lastInputValue;
     private _selPath;