CategoryEditor Class

An abstract class for creating custom category editors.

Inheritance Hierarchy


Namespace:  Microsoft.Windows.Design.PropertyEditing
Assembly:  Microsoft.Windows.Design.Interaction (in Microsoft.Windows.Design.Interaction.dll)


Public MustInherit Class CategoryEditor
public abstract class CategoryEditor
public ref class CategoryEditor abstract
type CategoryEditor =  class end
public abstract class CategoryEditor

The CategoryEditor type exposes the following members.


  Name Description
Protected method CategoryEditor Initializes a new instance of the CategoryEditor class.



  Name Description
Public property EditorTemplate When overridden in a derived class, gets a DataTemplate that acts as the UI for a CategoryEditor.
Public property TargetCategory When overridden in a derived class, gets a localized string that indicates which category this editor belongs to.



  Name Description
Public method ConsumesProperty When overridden in a derived class, called once for each property in the category to determine which properties are edited by this CategoryEditor.
Public methodStatic member CreateEditorAttribute(Type) Utility method that creates a new EditorAttribute for the specified CategoryEditor type.
Public methodStatic member CreateEditorAttribute(CategoryEditor) Utility method that creates a new EditorAttribute for the specified CategoryEditor.
Public method Equals Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected method Finalize Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public method GetHashCode Serves as a hash function for a particular type. (Inherited from Object.)
Public method GetImage When overridden in a derived class, returns an object that the host can place into a ContentControl in order to display it.
Public method GetType Gets the Type of the current instance. (Inherited from Object.)
Protected method MemberwiseClone Creates a shallow copy of the current Object. (Inherited from Object.)
Public method ToString Returns a string that represents the current object. (Inherited from Object.)



Derive from this class to provide a custom CategoryEditor for a set of properties in a property browser host. This class represents a custom user interface for editing a related set of properties, such as the properties in the Text category.

The TargetCategory property indicates the category of related properties that this editor is meant to edit. For example, several text-related properties are displayed in the Properties window under the Text category. If an editor is designed to edit these properties, the TargetCategory property returns "Text".

The EditorTemplate property returns the XAML template for the visual interface for this editor. This is typically provided in a ResourceDictionary elsewhere in the project.

Note that before a CategoryEditor will be used by the designer, it must be registered. For more information, see Providing Design-time Metadata.


The following code example shows how to use the CategoryEditor class. For more information, see Walkthrough: Creating a Category Editor.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also


Microsoft.Windows.Design.PropertyEditing Namespace

Other Resources

Property Editing Architecture

WPF Designer Extensibility