Xceed Toolkit Plus for WPF v4.6 Documentation
EditorDefinitionBase Class
Members  Example 


Xceed.Wpf.Toolkit Assembly > Xceed.Wpf.Toolkit.PropertyGrid Namespace : EditorDefinitionBase Class
Base class of the "editor definitions."
Syntax
'Declaration
 
<TypeDescriptionProviderAttribute(MS.Internal.ComponentModel.DependencyObjectProvider)>
<NameScopePropertyAttribute("NameScope", System.Windows.NameScope)>
Public MustInherit Class EditorDefinitionBase 
   Inherits PropertyDefinitionBase
'Usage
 
Dim instance As EditorDefinitionBase
[TypeDescriptionProvider(MS.Internal.ComponentModel.DependencyObjectProvider)]
[NameScopeProperty("NameScope", System.Windows.NameScope)]
public abstract class EditorDefinitionBase : PropertyDefinitionBase 
Remarks

EditorDefinitionBase-derived classes allow you to customize how the values of your properties are displayed in the PropertyGrid. These instances should be added to PropertyGrid.EditorCollections collection.

An "editor definition" is used to instantiate the editor (e.g., FrameworkElement instances) for one or more properties. The EditorDefinitionBase.TargetProperties property allows you to specify the definition keys that identify the ^properties targeted by the editor definition. TargetProperties is a collection of objects that contains custom keys (e.g., usually a string) or Type keys (e.g., instance of Type class).

When preparing a PropertyItemBase instance to be displayed by the PropertyGrid, the PropertyGrid will try to create an editor for the PropertyItemBase instance unless the PropertyItemBase.Editor property is already initialized by the user (see PropertyGrid.PropertyContainerStyle property and PropertyGrid.PreparePropertyItem event).

If the Editor property is not initialized, the PropertyGrid.EditorDefinitions collection will be consulted to determine the corresponding editor to display.

The priority of the definition keys to be used in order to find the appropriate editor for the property item is as follows:

1. The value provided by the PropertyItemBase.DefinitionKey property.

2. The value of the binding result of PropertyGrid.PropertyNameBinding applied on the underlying item.

3. The value type (e.g., value.GetType()) of the binding result of PropertyGrid.PropertyValueBinding applied on the underlying item. (A lookup based on a Type instance will recursively perform the look-up using base classes to find any matching editor definition.)

4. If PropertyGrid.PropertyValueBinding is null, the type of the underlying item. (A lookup based on a Type instance will recursively perform the look-up using base classes to find any matching editor definition.)

When no specific EditorDefinitionBase is found in the PropertyGrid.EditorDefinitions collection, the PropertyGrid will try to automatically create an appropriate editor based on the type of the value. (See default editors.)

If no appropriate editor is found, the EditorDefintionBase found in the PropertyGrid.DefaultEditorDefinition will be used.

Finally, if no editor is created, a TextBlock will be used to display the value.

 

The following is a list of the default editors that are automatically instantiated based on the type of the targeted property (when using SelectedObject[s]) or the type of the Value of the property (when using Properties or PropertiesSource).

- bool: CheckBox
- DateTime: DateTimeUpDown
- Color: ColorPicker
- decimal: DecimalUpDown
- double: DoubleUpDown
- float: SingleUpDown
- byte: ByteUpDown
- sbyte: SByteUpDown*
- short: ShortUpDown
- ushort: UShortUpDown*
- int: IntegerUpDown
- uint: UIntegerUpDown*
- long: LongUpDown
- ulong: ULongUpDown*
- enum: ComboBox with fields in the enumeration
- FontFamily: ComboBox populated with the available font families
- FontWeight: ComboBox populated with the possible font weights
- FontStyle: ComboBox populated with the possible font styles
- FontStretch: ComboBox populated with the possible font stretches

For CLS compliance, these editor are not available on the public API.

When using SelectedObject[s] only:
- object: TextBox
- TimeSpan: DateTimeUpDown using a converter
- IList<T>:
a) When T is one of the primitive type or a string: PrimitiveTypeCollectionControl
b) When T is NOT a primitive type or a string : CollectionEditor

 

These are the available built-in EditorDefintionBase-derived classes that allow you to easily customize the display the editor of the properties.

- EditorTemplateDefinition

- EditorComboBoxDefinition

- EditorCheckBoxDefinition

- EditorColorPickerDefinition

- EditorTextDefinition

- EditorDateTimeUpDownDefinition

- EditorByteUpDownDefinition

- EditorDecimalUpDownDefinition

- EditorDoubleUpDownDefinition

- EditorIntegerUpDownDefinition

- EditorLongUpDownDefinition

- EditorShortUpDownDefinition

- EditorSingleUpDownDefinition

Each editor definition has its own custom properties that allow you to easily customize the display of the represented editor. With the exception of EditorTemplateDefinition, they all provide the EditingElementStyle that allows you to style and get a more in-depth customizing scenario. 

Example
Adding an editor definition to a property grid
<xctk:PropertyGrid>
   <xctk:PropertyGrid.EditorDefinitions>
      <xctk:EditorTemplateDefinition ... />
   </xctk:PropertyGrid.EditorDefinitions>
</xctk:PropertyGrid>
This editor definition will be use to create the editor of the FirstName and LastName properties
<xctk:EditorTemplateDefinition TargetProperties="FirstName,LastName" ... />
This editor definition will be used to create the editor of all properties of type "int"
<xctk:EditorTemplateDefinition TargetProperties="{x:Type s:Int32}" ... />
This editor definition will be used to create the editor of all properties named "Age" and/or of type "int"
<xctk:EditorTemplateDefinition  ... >
      <xctk:EditorTemplateDefinition.TargetProperties>
         <s:String>Age</s:String>
         <xctk:TargetPropertyType Type="{x:Type s:Int32}" />
      </xctk:EditorTemplateDefinition.TargetProperties>
   </xctk:EditorTemplateDefinition>
Inheritance Hierarchy

System.Object
   System.Windows.Threading.DispatcherObject
      System.Windows.DependencyObject
         Xceed.Wpf.Toolkit.PropertyGrid.DefinitionBase
            Xceed.Wpf.Toolkit.PropertyGrid.PropertyDefinitionBase
               Xceed.Wpf.Toolkit.PropertyGrid.EditorDefinitionBase
                  Xceed.Wpf.Toolkit.PropertyGrid.EditorBoundDefinition
                  Xceed.Wpf.Toolkit.PropertyGrid.EditorComboBoxDefinition
                  Xceed.Wpf.Toolkit.PropertyGrid.EditorTemplateDefinition

Requirements

Target Platforms: Windows 11, Windows 10, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also

Reference

EditorDefinitionBase Members
Xceed.Wpf.Toolkit.PropertyGrid Namespace