Click here to Skip to main content
15,867,594 members
Articles / Programming Languages / C#
Article

A UITypeEditor for easy editing of flag enum properties in the property browser

Rate me:
Please Sign up or sign in to vote.
4.93/5 (36 votes)
14 Apr 20063 min read 125.7K   3.2K   65   26
A UITypeEditor for easy editing of flag enum properties in the property browser.

Image 1

Introduction

The design time support in Visual Studio .NET is very good, and makes it very easy to quickly develop forms and user controls. Even so, it has some minor shortcomings - some irritating, and some causing inconvenience. One such shortcoming is the lack of a good way to edit 'flag enum properties' in the design time property browser. Flag enum properties are properties whose type is an enum which has the FlagsAttribute applied to it. This attribute indicates that the enum can be treated as a bit field; that is, a set of flags. An example of such an enum is the FontStyle enum. It contains bit values for the Bold, Italic, and Underline styles, which can be combined together if needed. However, the property grid has no inbuilt support for such flag enums - if you want to specify that your font should be Bold as well as Italic, the only way to do so is to write equivalent code.

This article presents a simple UITypeEditor which can be applied to such flag enums and makes it very easy to edit such properties using the design time property browser.

Background

Before discussing the code, it is necessary to give a brief introduction on what an UI Type Editor is. In situations where the simple string-to-value and value-to-string conversion provided by the property browser is not sufficient or convenient, a UI type editor can be used to provide an advanced UI for editing the property. For example, the Dock and Anchor properties of all controls use a UI type editor for easy editing of the properties. To specify that a property should use a UI type editor, the EditorAttribute is applied to the type of the property or to the property itself. In the first case, the UI type editor is used whenever a property has the type to which the attribute is applied. In the second case, the UI type editor is used only for that property.

The FlagEnumUIEditor class

The UI type editor used for flag enums is called FlagEnumUIEditor, and is derived from UITypeEditor. It is a dropdown style editor, which means that a small drop-down button is displayed in the property browser when the property is selected. When this button is clicked, a control is shown which can be used to edit the property. The FlagEnumUIEditor uses a class derived from CheckedListBox to display the flag enums.

The FlagCheckedListBox class

The FlagCheckedListBox class is derived from CheckedListBox and contains items of type FlagCheckedListBoxItem. Each item has a value and a description for the value corresponding to the values and names of the enum members. The EnumValue property is used to associate an enum value with the FlagCheckedListBox:

C#
public Enum EnumValue
{
    get
    {
        object e = Enum.ToObject(enumType,GetCurrentValue());
        return (Enum)e;
    }
    set
    {
        
        Items.Clear();
        enumValue = value; // Store the current enum value
        enumType = value.GetType(); // Store enum type
        FillEnumMembers(); // Add items for enum members
        ApplyEnumValue(); // Check/uncheck items depending on enum value
     }
}

The FillEnumMembers and ApplyEnumValue functions are as follows:

C#
// Adds items to the checklistbox based on the members of the enum
private void FillEnumMembers()
{
    foreach ( string name in Enum.GetNames(enumType))
    {
        object val = Enum.Parse(enumType,name);
        int intVal = (int)Convert.ChangeType(val, typeof(int));

        Add(intVal,name);
    }
}

// Checks/unchecks items based on the current value of the enum variable
private void ApplyEnumValue()
{
    int intVal = (int)Convert.ChangeType(enumValue, typeof(int));
    UpdateCheckedItems(intVal);

}
        
// Checks/Unchecks items depending on the give bitvalue
protected void UpdateCheckedItems(int value)
{

    isUpdatingCheckStates = true;

    // Iterate over all items
    for(int i=0;i<Items.Count;i++)
    {
        FlagCheckedListBoxItem item = Items[i] as FlagCheckedListBoxItem;

        // If the bit for the current item is on in the bitvalue, check it
        if( (item.value & value)== item.value && item.value!=0)
            SetItemChecked(i,true);
        // Otherwise uncheck it
        else
            SetItemChecked(i,false);
    }

    isUpdatingCheckStates = false;

}

The OnItemCheck function of CheckListBox is overridden to update all other items whenever any item is checked or unchecked:

C#
protected override void OnItemCheck(ItemCheckEventArgs e)
{
    base.OnItemCheck(e);

    if (isUpdatingCheckStates)
        return;

    // Get the checked/unchecked item
    FlagCheckedListBoxItem item = Items[e.Index] as FlagCheckedListBoxItem;
    // Update other items
    UpdateCheckedItems(item, e.NewValue);
}

// Updates items in the checklistbox
// composite = The item that was checked/unchecked
// cs = The check state of that item
protected void UpdateCheckedItems(FlagCheckedListBoxItem composite, 
                                  CheckState cs)
{

    // If the value of the item is 0, call directly.
    if(composite.value==0)
        UpdateCheckedItems(0);


    // Get the total value of all checked items
    int sum = 0;
    for(int i=0;i<Items.Count;i++)
    {
        FlagCheckedListBoxItem item = Items[i] as FlagCheckedListBoxItem;

        // If item is checked, add its value to the sum.
        if(GetItemChecked(i))
            sum |= item.value;
    }

    // If the item has been unchecked, remove its bits from the sum
    if(cs==CheckState.Unchecked)
        sum = sum & (~composite.value);
    // If the item has been checked, combine its bits with the sum
    else
        sum |= composite.value;

    // Update all items in the checklistbox based on the final bit value
    UpdateCheckedItems(sum);

}

Finally, when the user is done editing the property, the GetCurrentValue method is used to return the bit value corresponding to all checked items in the CheckListBox.

C#
// Gets the current bit value corresponding to all checked items
public int GetCurrentValue()
{
    int sum = 0;

    for(int i=0;i<Items.Count;i++)
    {
        FlagCheckedListBoxItem item = 
                   Items[i] as FlagCheckedListBoxItem;

        if( GetItemChecked(i))
            sum |= item.value;
    }

    return sum;
}

Using the code

Using the code in your own project is very easy. Simply add the FlagEnumEditor.cs file to your project, and apply the UI type editor to your enums or properties as follows:

C#
[Editor(typeof(Utils.FlagEnumUIEditor), 
        typeof(System.Drawing.Design.UITypeEditor))]

The source code zip file contains a Visual Studio .NET solution with a single Windows Application project. To see the FlagEnumUIEditor in action, simply compile and run this solution. The main form has a property grid which is assigned an object of type TestObject which is just a dummy type written only for demonstration purposes. TestObject has three properties, all of type flag enums, namely:

  • TestEnum: A flag enum defined for demonstration purposes. Contains enum values which are composites of two other flag members of the enum.
  • SecurityPermissionFlag: A flag enum from the System.Security.Permissions namespace.
  • FontStyle: A flag enum from the System.Drawing namespace.

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here



Comments and Discussions

 
GeneralMy vote of 5 Pin
BillWoodruff17-Apr-17 22:44
professionalBillWoodruff17-Apr-17 22:44 
QuestionWhat license is this released under? Pin
Member 1116735221-Oct-14 4:34
Member 1116735221-Oct-14 4:34 
QuestionAdd simple Drop list auto-sizing Pin
jacktid22-Feb-14 6:26
jacktid22-Feb-14 6:26 
QuestionDesign time support Pin
Member 102861155-Oct-13 23:47
Member 102861155-Oct-13 23:47 
GeneralMy vote of 4 Pin
Member 205900413-Aug-13 4:17
Member 205900413-Aug-13 4:17 
GeneralMy vote of 5 Pin
Member 864854217-Dec-12 1:09
Member 864854217-Dec-12 1:09 
GeneralMy vote of 5 Pin
Klaus Ruttkowski7-Feb-12 22:45
Klaus Ruttkowski7-Feb-12 22:45 
GeneralMy vote of 5 Pin
Richard James Moss1-Oct-11 17:51
professionalRichard James Moss1-Oct-11 17:51 
GeneralMy vote of 5 Pin
TomGarratt21-Feb-11 0:16
TomGarratt21-Feb-11 0:16 
General[My vote of 1] Nothing new :( Pin
vla_dd2-Jul-10 5:32
vla_dd2-Jul-10 5:32 
GeneralRe: [My vote of 1] Nothing new :( Pin
phil.o17-Oct-15 3:14
professionalphil.o17-Oct-15 3:14 
GeneralExcellent work Pin
ozbear11-Aug-09 22:41
ozbear11-Aug-09 22:41 
GeneralProblem when host PropertyGrid is Docked Pin
Mike Hofer31-Jul-09 5:01
Mike Hofer31-Jul-09 5:01 
GeneralRe: Problem when host PropertyGrid is Docked Pin
LogicNP2-Aug-09 22:48
LogicNP2-Aug-09 22:48 
GeneralThanks Pin
Alex B. Clarke8-Jan-09 3:55
Alex B. Clarke8-Jan-09 3:55 
Just a quick note to say thanks for this piece of code. I was in hurry working on a web control and desperatly need this functionality. You saved me a lot of time!!!
Thanks, again.

Alex B. Clarke
It's easy when you know it.

GeneralRe: Thanks Pin
LogicNP8-Jan-09 17:26
LogicNP8-Jan-09 17:26 
QuestionDynamic enum with EnumBuilder as a PropertyGrid item/property Pin
papacol2-Sep-08 3:44
papacol2-Sep-08 3:44 
AnswerRe: Dynamic enum with EnumBuilder as a PropertyGrid item/property Pin
bfis10813727-Oct-08 11:54
bfis10813727-Oct-08 11:54 
QuestionRegular-Non-flag enum? Pin
twesterd6-Jun-06 20:56
twesterd6-Jun-06 20:56 
AnswerRe: Regular-Non-flag enum? Pin
Vyacheslav Trubarov15-Jan-07 4:30
Vyacheslav Trubarov15-Jan-07 4:30 
GeneralEnum 0 value Pin
Laurent Muller18-Apr-06 20:36
professionalLaurent Muller18-Apr-06 20:36 
GeneralRe: Enum 0 value Pin
LogicNP19-Apr-06 0:49
LogicNP19-Apr-06 0:49 
QuestionWhat about localization support? Pin
Amadrias15-Apr-06 12:58
Amadrias15-Apr-06 12:58 
AnswerRe: What about localization support? Pin
LogicNP16-Apr-06 19:37
LogicNP16-Apr-06 19:37 
GeneralRe: What about localization support? Pin
Amadrias17-Apr-06 14:34
Amadrias17-Apr-06 14:34 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.