[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
  Prerequisites
 [Expand]What's Installed
 [Expand].NET Core 3 Support
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Expand]Controls and Libraries
 [Expand]Scaffolding Wizard
 [Expand]Localization
  Redistribution and Deployment
  Get More Help
 [Collapse]API Reference
  [Expand]DevExpress.Charts.Designer
  [Expand]DevExpress.Data
  [Expand]DevExpress.Mvvm.UI
  [Expand]DevExpress.Mvvm.UI.Interactivity
  [Expand]DevExpress.Mvvm.UI.ModuleInjection
  [Expand]DevExpress.Xpf.Accordion
  [Expand]DevExpress.Xpf.Bars
  [Expand]DevExpress.Xpf.Carousel
  [Expand]DevExpress.Xpf.Charts
  [Expand]DevExpress.Xpf.Charts.Localization
  [Expand]DevExpress.Xpf.Charts.RangeControlClient
  [Expand]DevExpress.Xpf.ChunkList
  [Expand]DevExpress.Xpf.Controls
  [Expand]DevExpress.Xpf.Core
  [Expand]DevExpress.Xpf.Core.ConditionalFormatting
  [Expand]DevExpress.Xpf.Core.DataSources
  [Expand]DevExpress.Xpf.Core.FilteringUI
  [Expand]DevExpress.Xpf.Core.Native
  [Expand]DevExpress.Xpf.Core.ServerMode
  [Expand]DevExpress.Xpf.Data
  [Expand]DevExpress.Xpf.DataAccess
  [Expand]DevExpress.Xpf.DataAccess.DataSourceWizard
  [Expand]DevExpress.Xpf.Diagram
  [Expand]DevExpress.Xpf.Dialogs
  [Expand]DevExpress.Xpf.Docking
  [Expand]DevExpress.Xpf.Docking.Base
  [Expand]DevExpress.Xpf.DocumentViewer
  [Expand]DevExpress.Xpf.DXBinding
  [Collapse]DevExpress.Xpf.Editors
    ActivationAction Enumeration
   [Expand]AreaSparklineStyleSettings Class
    AutoCompleteType Enumeration
   [Expand]AutoSuggestEdit Class
    AutoSuggestEditChangeTextReason Enumeration
   [Expand]AutoSuggestEditCustomPopupHighlightedTextEventArgs Class
   [Expand]AutoSuggestEditQuerySubmittedEventArgs Class
   [Expand]AutoSuggestEditSuggestionChoosingEventArgs Class
   [Expand]AutoSuggestEditSuggestionChosenEventArgs Class
   [Expand]AutoSuggestEditTextChangedEventArgs Class
   [Expand]BarCodeEdit Class
   [Expand]BarCodePropertyProvider Class
   [Expand]BarSparklineStyleSettings Class
   [Expand]BaseComboBoxStyleSettings Class
   [Collapse]BaseEdit Class
     BaseEdit Members
    [Expand]BaseEdit Properties
    [Expand]BaseEdit Events
    [Expand]BaseEdit Methods
   [Expand]BaseEditStyleSettings Class
   [Expand]BaseProgressBarStyleSettings Class
   [Expand]ButtonEdit Class
   [Expand]ButtonInfo Class
   [Expand]ButtonInfoBase Class
   [Expand]ButtonInfoCollection Class
    ButtonKind Enumeration
   [Expand]Calculator Class
   [Expand]CalculatorCustomErrorTextEventArgs Class
    CalculatorCustomErrorTextEventHandler Delegate
   [Expand]CameraControl Class
   [Expand]CameraDevice Class
   [Expand]CheckedComboBoxStyleSettings Class
   [Expand]CheckEdit Class
   [Expand]CheckEditBox Class
    CheckEditDisplayMode Enumeration
   [Expand]CheckedListBoxEditStyleSettings Class
   [Expand]CheckedTokenComboBoxStyleSettings Class
    ChipSize Enumeration
   [Expand]ClosePopupEventArgs Class
    ClosePopupEventHandler Delegate
    ColorDisplayFormat Enumeration
   [Expand]ColorEdit Class
   [Expand]ColorPalette Class
   [Expand]ComboBoxEdit Class
   [Expand]ComboBoxEditItem Class
   [Expand]ComboBoxStyleSettings Class
    ContentDisplayMode Enumeration
   [Expand]ConvertEditValueEventArgs Class
   [Expand]CustomDisplayTextEventArgs Class
    CustomDisplayTextEventHandler Delegate
   [Expand]CustomPalette Class
   [Expand]DateEdit Class
   [Expand]DateEditCalendarStyleSettings Class
   [Expand]DateEditNavigatorStyleSettings Class
   [Expand]DateEditNavigatorWithTimePickerStyleSettings Class
   [Expand]DateEditPickerStyleSettings Class
    DateEditPopupContentType Enumeration
   [Expand]DateEditTimePickerStyleSettings Class
   [Expand]DeleteButtonInfo Class
   [Expand]EditableDataObject Class
    EditMode Enumeration
   [Expand]EditorLocalizer Class
    EditorPlacement Enumeration
    EditorStringId Enumeration
   [Expand]EditValueChangedEventArgs Class
    EditValueChangedEventHandler Delegate
   [Expand]EditValueChangingEventArgs Class
    EditValueChangingEventHandler Delegate
   [Expand]ErrorControl Class
    FindMode Enumeration
   [Expand]FontEdit Class
    GlyphKind Enumeration
    HighlightedTextCriteria Enumeration
   [Expand]HyperlinkEdit Class
   [Expand]HyperlinkEditRequestNavigationEventArgs Class
   [Expand]ImageCheckEditStyleSettings Class
   [Expand]ImageEdit Class
   [Expand]LineSparklineStyleSettings Class
   [Expand]ListBoxEdit Class
   [Expand]ListBoxEditItem Class
   [Expand]ListBoxEditStyleSettings Class
   [Expand]LoadingIndicatorButtonInfo Class
   [Expand]LookUpEditBase Class
    MaskType Enumeration
   [Expand]MemoEdit Class
    NewTokenPosition Enumeration
   [Expand]NumericMaskOptions Class
   [Expand]PagerControl Class
   [Expand]PaletteCollection Class
   [Expand]PasswordBoxEdit Class
    PasswordStrength Enumeration
   [Expand]PasswordStrengthEventArgs Class
   [Expand]PopupBaseEdit Class
   [Expand]PopupCalcEdit Class
    PopupCloseMode Enumeration
   [Expand]PopupColorEdit Class
    PopupFooterButtons Enumeration
   [Expand]PopupImageEdit Class
    PostMode Enumeration
   [Expand]PredefinedColorCollections Class
   [Expand]PredefinedPaletteCollections Class
   [Expand]ProcessNewValueEventArgs Class
    ProcessNewValueEventHandler Delegate
   [Expand]ProgressBarEdit Class
   [Expand]ProgressBarMarqueeStyleSettings Class
   [Expand]ProgressBarStyleSettings Class
   [Expand]RadioComboBoxStyleSettings Class
   [Expand]RadioListBoxEditStyleSettings Class
   [Expand]Range Class
   [Expand]RangeBaseEdit Class
   [Expand]RatingControl Class
   [Expand]RatingEdit Class
   [Expand]RatingItem Class
    RatingPrecision Enumeration
    ScrollUnit Enumeration
   [Expand]SearchControl Class
    SearchPanelParseMode Enumeration
    ShowLoadDialogOnClickMode Enumeration
    ShowMenuMode Enumeration
   [Expand]SparklineEdit Class
    SparklineSortOrder Enumeration
   [Expand]SparklineStyleSettings Class
    SparklineViewType Enumeration
   [Expand]SpinEdit Class
   [Expand]SpinEventArgs Class
    SpinEventHandler Delegate
    SpinStyle Enumeration
   [Expand]TextEdit Class
   [Expand]TextEditBase Class
   [Expand]TimePicker Class
   [Expand]TimePickerDateTimeChangedEventArgs Class
    TimePickerDateTimeChangedEventHandler Delegate
    TimeSpanInputMode Enumeration
   [Expand]TimeSpanMaskOptions Class
    TimeSpanPart Enumeration
   [Expand]ToggleSwitch Class
    ToggleSwitchAnimationMode Enumeration
    ToggleSwitchContentPlacement Enumeration
   [Expand]ToggleSwitchEdit Class
   [Expand]TokenActivatingEventArgs Class
   [Expand]TokenComboBoxStyleSettings Class
   [Expand]TokenEditorBehavior Class
   [Expand]TokensChangedEventArgs Class
   [Expand]TokensChangingEventArgs Class
   [Expand]TokenStateChangedEventArgs Class
   [Expand]TokenTextChangingEventArgs Class
   [Expand]TrackBarEdit Class
   [Expand]TrackBarEditRange Class
    TrackBarIncrementTargetEnum Enumeration
   [Expand]TrackBarRangeStyleSettings Class
   [Expand]TrackBarStyleSettings Class
   [Expand]TrackBarZoomRangeStyleSettings Class
   [Expand]TrackBarZoomStyleSettings Class
   [Expand]ValidationEventArgs Class
   [Expand]WinLossSparklineStyleSettings Class
  [Expand]DevExpress.Xpf.Editors.DataPager
  [Expand]DevExpress.Xpf.Editors.DateNavigator
  [Expand]DevExpress.Xpf.Editors.ExpressionEditor
  [Expand]DevExpress.Xpf.Editors.ExpressionEditor.Native
  [Expand]DevExpress.Xpf.Editors.Filtering
  [Expand]DevExpress.Xpf.Editors.Flyout
  [Expand]DevExpress.Xpf.Editors.Flyout.Native
  [Expand]DevExpress.Xpf.Editors.Helpers
  [Expand]DevExpress.Xpf.Editors.Native
  [Expand]DevExpress.Xpf.Editors.Popups
  [Expand]DevExpress.Xpf.Editors.RangeControl
  [Expand]DevExpress.Xpf.Editors.Settings
  [Expand]DevExpress.Xpf.Editors.Validation
  [Expand]DevExpress.Xpf.ExpressionEditor
  [Expand]DevExpress.Xpf.Gantt
  [Expand]DevExpress.Xpf.Gauges
  [Expand]DevExpress.Xpf.Gauges.Localization
  [Expand]DevExpress.Xpf.Grid
  [Expand]DevExpress.Xpf.Grid.ConditionalFormatting
  [Expand]DevExpress.Xpf.Grid.LookUp
  [Expand]DevExpress.Xpf.Grid.TreeList
  [Expand]DevExpress.Xpf.Layout.Core
  [Expand]DevExpress.Xpf.LayoutControl
  [Expand]DevExpress.Xpf.Map
  [Expand]DevExpress.Xpf.NavBar
  [Expand]DevExpress.Xpf.Navigation
  [Expand]DevExpress.Xpf.PdfViewer
  [Expand]DevExpress.Xpf.PivotGrid
  [Expand]DevExpress.Xpf.PivotGrid.Printing
  [Expand]DevExpress.Xpf.Printing
  [Expand]DevExpress.Xpf.Printing.Parameters
  [Expand]DevExpress.Xpf.Printing.Parameters.Models
  [Expand]DevExpress.Xpf.Printing.PreviewControl
  [Expand]DevExpress.Xpf.Printing.PreviewControl.Bars
  [Expand]DevExpress.Xpf.Prism
  [Expand]DevExpress.Xpf.PropertyGrid
  [Expand]DevExpress.Xpf.Reports.UserDesigner
  [Expand]DevExpress.Xpf.Reports.UserDesigner.Extensions
  [Expand]DevExpress.Xpf.Reports.UserDesigner.Localization
  [Expand]DevExpress.Xpf.Reports.UserDesigner.ReportWizard
  [Expand]DevExpress.Xpf.Reports.UserDesigner.ReportWizard.Pages
  [Expand]DevExpress.Xpf.Ribbon
  [Expand]DevExpress.Xpf.RichEdit
  [Expand]DevExpress.Xpf.RichEdit.Menu
  [Expand]DevExpress.Xpf.Scheduler
  [Expand]DevExpress.Xpf.Scheduler.Drawing
  [Expand]DevExpress.Xpf.Scheduler.Menu
  [Expand]DevExpress.Xpf.Scheduler.Reporting
  [Expand]DevExpress.Xpf.Scheduler.UI
  [Expand]DevExpress.Xpf.Scheduling
  [Expand]DevExpress.Xpf.Scheduling.Common
  [Expand]DevExpress.Xpf.Scheduling.Editors
  [Expand]DevExpress.Xpf.Scheduling.iCalendar
  [Expand]DevExpress.Xpf.Scheduling.Reporting
  [Expand]DevExpress.Xpf.Scheduling.Visual
  [Expand]DevExpress.Xpf.Scheduling.VisualData
  [Expand]DevExpress.Xpf.SpellChecker
  [Expand]DevExpress.Xpf.Spreadsheet
  [Expand]DevExpress.Xpf.Spreadsheet.Menu
  [Expand]DevExpress.Xpf.TreeMap
  [Expand]DevExpress.Xpf.Utils.Themes
  [Expand]DevExpress.Xpf.WindowsUI
  [Expand]DevExpress.Xpf.WindowsUI.Internal
  [Expand]DevExpress.Xpf.WindowsUI.Navigation
  [Expand]DevExpress.XtraRichEdit
  [Expand]DevExpress.XtraRichEdit.Printing
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

BaseEdit Class

Serves as the base for all editors that can be used as standalone editors and for inplace editing in container controls (e.g., within the GridControl).

Namespace:DevExpress.Xpf.Editors
Assembly:DevExpress.Xpf.Core.v19.2.dll

Expanded Syntax

Expanded Remarks

The BaseEdit abstract class implements basic functionality for editors that can be used as standalone editors and for inplace editing in container controls (GridControl, TreeListControl, etc.).

Note

The BaseEdit class does not implement any editor-specific functionality. If you want to create a custom editor that has no features in common with any existing editor, the custom editor should inherit from the BaseEdit class.

To use a custom editor within a data aware control (GridControl, TreeListControl, etc.), implement a ColumnBase.CellTemplate.

Editor Value

The EditValue property contains an editor's current value which is valid. If an end user has entered an invalid value, it is not posted to EditValue until it is corrected.

The EditValueChanging event is raised when the editor's value is about to be changed (a user types or deletes a character, chooses a value from a drop-down list, etc.).

The EditValueChanged event occurs after the edit value has been validated and changed.

Tip

The Obtaining Editor Values section describes how to obtain editor value, and how to synchronize values between an editor and its bound source.

Useful API

Display Value

The text displayed within the editor depends on the EditValue (see EditValue) property and EditValueType (see EditValueType). Use the DisplayFormatString (see DisplayFormatString) property to format the text value (for example, to display a currency amount).

The image below illustrates the result.

You can display a custom text within the editor by handling the CustomDisplayText event.

The DisplayText property returns the string currently displayed within the editor.

Validation

Refer to the Input Validation documentation section for information on how to validate end-user input.

Useful API

Null Value and Null Text

The TextEditBase class descendants can display a prompt text (NullText) when the editor's value is null.

The NullValue (see NullValue) property allows you to specify a null value for TextEdit-derived editors, in addition to null value.

Use the ShowNullText property to control the Null Text visibility.

Useful API

Expanded Inheritance Hierarchy

System.Object
    System.Windows.Threading.DispatcherObject
       System.Windows.DependencyObject
          System.Windows.Media.Visual
             System.Windows.UIElement
                System.Windows.FrameworkElement
                   System.Windows.Controls.Control
                      BaseEdit
                         AppointmentLabelEdit
                         AppointmentLabelEdit
                         AppointmentResourceEdit
                         AppointmentResourceEdit
                         AppointmentResourcesEdit
                         AppointmentResourcesEdit
                         AppointmentStatusEdit
                         AppointmentStatusEdit
                         AutoSuggestEdit
                         BarCodeEdit
                         BrushEdit
                         DevExpress.Xpf.Editors.BrushEditBase
                         ButtonEdit
                         CheckEdit
                         DevExpress.Xpf.Scheduler.UI.CheckedResourcesComboBoxControlBase
                         ColorEdit
                         ComboBoxEdit
                         DateEdit
                         DurationEdit
                         DevExpress.Xpf.Scheduler.UI.FixedSourceComboBoxEdit
                         FontEdit
                         HyperlinkEdit
                         ImageEdit
                         ItemComboBoxEdit
                         ListBoxEdit
                         LookUpEdit
                         LookUpEditBase
                         MemoEdit
                         MonthEdit
                         PasswordBoxEdit
                         PopupBaseEdit
                         PopupBrushEdit
                         DevExpress.Xpf.Editors.PopupBrushEditBase
                         PopupCalcEdit
                         PopupColorEdit
                         PopupImageEdit
                         ProgressBarEdit
                         RangeBaseEdit
                         RatingEdit
                         ResourcesCheckedListBoxControl
                         ResourcesComboBoxControl
                         DevExpress.Xpf.Scheduler.UI.ResourcesComboBoxControlBase
                         ResourcesPopupCheckedListBoxControl
                         DevExpress.Xpf.Scheduler.UI.SchedulerBoundComboBoxEdit
                         SparklineEdit
                         SpinEdit
                         DevExpress.Xpf.Scheduler.UI.StorageBoundComboBoxEdit
                         TextEdit
                         TextEditBase
                         TimeZoneEdit
                         TimeZoneEdit
                         ToggleSwitchEdit
                         TrackBarEdit
                         WeekDaysEdit
                         WeekOfMonthEdit

Expanded See Also

Is this topic helpful?​​​​​​​