The WinDateTimeEditor™ control now automatically displays localized Japanese character separators between the Year, Month, and Day components when Windows regional settings are set to the Japanese culture. The characters will be displayed when the control’s MaskInput property is left unassigned, or assigned a mask that begins with the {LOC} character sequence.
The following screen shot illustrates how the control appears when the Japanese regional settings are in effect:
A LimitToList property, an ItemNotInList event, and overloaded IsItemInList methods have been added to the WinComboEditor™ control. The LimitToList property gets/sets a value indicating whether the control will retain focus upon validation whenever the entered value does not correspond to an item in the control’s Items collection. The ItemNotInList event is fired before the Validating event of the control whenever the text value entered into the editor portion of the control does not correspond to an item in the control’s Items collection. The event passes a ValidationErrorEventArgs object that contains InvalidText and LastValidValue properties, as well as properties for specifying that the control should retain focus or beep to provide an auditory cue. The IsItemInList overloaded methods return a boolean indicating whether the value of the control’s Text property, or a specified string, corresponds to an item in the control’s Items collection. The LimitToList functionality can be used, for example, to validate the contents of the control’s edit portion, and alert the end user when the entered value does not match an item in the list, as illustrated by the screenshot below. For more information about the LimitToList functionality, see Limit the Number of Items Added to the MRU List.
The WinOptionSet™ control and its associated embeddable editor, OptionSetEditor now expose MinColumnWidth and MaxColumnWidth properties. If the width of an item exceeds the MaxColumnWidth of a column the item’s text is automatically wrapped (i.e., the item becomes multi-line), as illustrated by the following screen shot:
A SpinWrap property (now deprecated) has been added to the UltraWinEditorMaskedControlBase class (WinNumericEditor™, WinCurrencyEditor™, WinDateTimeEditor), as well as the WinMaskedEdit™, and WinCalendarCombo™ controls. The SpinWrap property gets/sets a value indicating whether the control’s spin button should wrap around when its value has reached the minimum or maximum. If set to true, the spin button will wrap the value incremented/decremented based on the value of the MinValue / MaxValue properties. The following illustration demonstrates the control’s behavior when the SpinWrap property is set to true, and a spin button is clicked when the control’s value is at the maximum or minimum:
OverflowIndicatorImage properties have been added to the TextEditorControlBase -derived controls. If ShowOverflowIndicator is set to true, and the text of the control is not entirely visible when the control is not in edit mode, an overflow indicator image, functionally similar to an ellipsis, appears in the right side of the text area. Hovering the mouse cursor over the image will display a tooltip with the full text. The OverflowIndicatorImage property permits a customized image to be displayed instead of the default image. The following screen shot illustrates the visual overflow indicator functionality:
