Table of Contents

Editors

The Eremex Controls library includes multiple editors that provide advanced data editing capabilities. The editors allow you to display and edit data of different data types (numeric, Boolean, date-time, enumerations, etc.). They support the data validation mechanism to inform users about errors during data input.

data-editors

You can embed the Eremex data editors in cells in container controls (DataGrid, TreeList, PropertyGrid, and ToolbarManager) to present and edit cell data. Although you can embed any custom control in cells, the use of Eremex data editors has many benefits from an application performance perspective.


  • ButtonEditor — A text editor with built-in buttons.
    • Regular and toggle buttons.
    • Displaying text and images in buttons.
    • Aligning buttons to the left and right edges.
    • Tooltips.
    • Built-in 'x' button to clear the editor's value.
    • Watermarks.

  • CheckEditor — Displays a check box which is toggled on a click.
    • Supports two or three check states (checked state, unchecked state and indeterminate state).
    • The validation mechanism modifies the appearance of the control to inform users about errors.

  • ComboBoxEditor — Allows a user to select an item from an item list displayed in an associated popup window.
    • Supported items sources: a list of strings, list of business objects, and an enumeration type.
    • Support for data templates used to render items in a custom manner.
    • Single and multiple item selection modes.
    • Built-in check boxes in multiple selection mode.
    • The text auto-completion feature predicts an item selection when a user starts typing text in the edit box in single selection mode.

  • DateEditor — An editor with an embedded dropdown calendar that allows users to pick a date.
    • Built-in 'Today' and 'Clear' buttons.
    • Support for multiple date display formats.
    • Navigation bar in the dropdown calendar allows for browsing through months and years.
    • Three calendar views: month view, year view, and year range view.
    • An option to limit the available date range.

  • HyperlinkEditor — Displays a clickable hyperlink.
    • Allows you to specify a command to handle clicks on a hyperlink.

  • MemoEditor — A dropdown text editor.
    • A text editor embedded in the dropdown window.
    • To indicate the presence of text in the dropdown editor, the edit box can display a special icon or the first line of the dropdown text.

  • PopupColorEditor — Allows a user to select a color in a popup window.
    • Three color palettes — Default, Standard, Custom.
    • The Default color palette can be initialized in code.
    • The Standard color palette displays predefined standard colors.
    • The Custom color palette allows users to add and modify colors using the built-in Color Picker.
    • Ability to specify colors in the RGB and HSB formats.

  • PopupEditor — The base class for editors that have dropdown windows.

  • SegmentedEditor — Displays segments (items), one of which can be selected by a user.
    • Horizontal arrangement of segments.
    • A user can click a segment to select it and unselect other segments.
    • A Ctrl-click on a selected item clears the selection.
    • Supported items sources: a list of strings, list of business objects, and an enumeration type.
    • Use data templates to render items in a custom manner.

  • SpinEditor — Allows you to edit numeric values using spin buttons.
    • Built-in spin buttons allow a user to increase and decrease a value.
    • Limiting the available value range.
    • Custom increment value.
    • Displaying custom prefix and suffix in the edit box.

  • TextEditor — A text editor featuring the base text editing functionality.
    • The ancestor of all text-based Eremex editors.
    • Masked input.
    • Support for the data validation mechanism used to show errors to users.

Common Features

  • Masks
    • Text editors support masked input, which prevents users from entering invalid values.
    • Masks can be used to format cell text in container controls in display mode (when text editing is not active).
    • Supported mask types: Numeric and DateTime.
    • DateEditor uses a DateTime input mask by default.
    • SpinEditor uses a Numeric input mask by default.

  • Data Validation
    • The built-in value validation mechanism allows you to show errors to users in all text editors and CheckEditor.
    • Text editors can display validation errors within edit boxes or below them.

  • Eremex Application Themes
    • Eremex application themes allow you to modify the appearance of the Eremex controls.
    • You can apply the Eremex application themes to a set of standard Avalonia UI Controls.
    • Eremex editors support the primary and secondary color variants for each theme. These color variants help you give a slightly different color accent to the editors by changing a single property.