devexpress-winforms-editors
Installation
SKILL.md
DevExpress WinForms Data Editors
The DevExpress Editors suite (DevExpress.XtraEditors) is a family of standalone WinForms input controls plus the repository-item infrastructure that lets the same editor be embedded into data-aware controls (Data Grid, TreeList, Ribbon, etc.). Almost every editor derives from BaseEdit, which contributes the bindable EditValue property; a smaller set of controls inherit from BaseControl directly and are used for display, action, or layout — buttons, labels, list boxes, navigators.
This skill covers three things at once:
- The editor hierarchy — the
BaseEdittree (TextEdit branch, BaseCheckEdit branch, PictureEdit, ProgressBar, RadioGroup, RatingControl, TrackBar, TokenEdit, SparklineEdit), the non-BaseEditcontrols, and how to pick the right one. - Masks — the input-mask system shared across
TextEditdescendants:Numeric,DateTime/DateOnly/TimeOnly/DateTimeOffset,Simple,TimeSpan,RegEx(Extended Regular Expressions),Simplified RegEx, including theMaskSettings.Configure<>fluent API and theEditMaskdata-annotation attributes. - Editor buttons —
EditorButton,ButtonPredefines,EditorButtonImageOptions,Properties.Buttonscollection, click handling, captions/icons/tooltips, inButtonEditdescendants (ButtonEdit,ComboBoxEdit,LookUpEdit,SpinEdit,BrowsePathEdit,PopupBaseEdit,ColorPickEdit,PopupGalleryEdit,PopupContainerEdit).
When to Use This Skill
- Adding any DevExpress editor to a form for text, number, date, time, lookup, color, image, file path, etc.
- Choosing between editor families (
TextEditvsButtonEditvsComboBoxEditvsLookUpEditvsGridLookUpEditvsSearchLookUpEdit;DateEditvsTimeEditvsDateTimeOffsetEdit;CheckEditvsToggleSwitch;ProgressBarControlvsMarqueeProgressBarControl). - Knowing what is not a
BaseEdit(noEditValue) and when to use a simple control instead — labels, buttons, list boxes, breadcrumb, navigator. - Applying input masks, including DateTime, Numeric (
c,n,p,f,d), Simple metacharacter patterns, RegEx patterns, and culture-aware behavior. - Adding, customizing, hiding, or removing buttons in
ButtonEditdescendants — predefined glyphs (ButtonPredefines.Ellipsis,Search,Plus,Minus,Up,Down,Clear,Delete,OK,Close,Right,Left,Combo,DropDown, …), custom SVG/raster images, captions, alignment, tooltips, and click events. - Hiding the text box (
TextEditStyle.HideTextEditor) or making it read-only (DisableTextEditor). - Embedding editors into the Grid / TreeList / Ribbon via repository items.