ItemsSourceAttribute Class

Represents an attribute that is set on a property to identify the IItemsSource-derived class that will be used.

Syntax

Visual Basic
C#

'Declaration
 
<AttributeUsageAttribute(AttributeTargets.All, 
   Inherited=True, 
   AllowMultiple=False)>
Public Class ItemsSourceAttribute 
   Inherits System.Attribute

'Usage
 
Dim instance As ItemsSourceAttribute

[AttributeUsage(AttributeTargets.All, 
   Inherited=true, 
   AllowMultiple=false)]
public class ItemsSourceAttribute : System.Attribute

Remarks

Use this attribute on a property when a scenario calls for use of a collection of values represented by a ComboBox for a given property.

Example

First, create a class that implements IItemsSource.

public class FontSizeItemsSource : IItemsSource
{
    public ItemCollection GetValues()
    {
        ItemCollection sizes = new ItemCollection();
        sizes.Add(5.0, "Five");
        sizes.Add(5.5);
        sizes.Add(6.0, "Six");
        sizes.Add(6.5);
        sizes.Add(7.0, "Seven");
        sizes.Add(7.5);
        sizes.Add(8.0, "Eight");
        sizes.Add(8.5);
        sizes.Add(9.0, "Nine");
        sizes.Add(9.5);
        sizes.Add(10.0);
        sizes.Add(12.0, "Twelve");
        sizes.Add(14.0);
        sizes.Add(16.0);
        sizes.Add(18.0);
        sizes.Add(20.0);
        return sizes;
    }
}

Then decorate the property with the ItemsSource attribute.

public class Person
{
    [Category("Writing")]
    [DisplayName("Writing Font Size")]
    [Description("This property uses the DoubleUpDown as the default editor.")]
    [ItemsSource(typeof(FontSizeItemsSource))]
    public double WritingFontSize { get; set; }
}

Inheritance Hierarchy

System.Object
System.Attribute
Xceed.Wpf.Toolkit.PropertyGrid.Attributes.ItemsSourceAttribute

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

Reference

ItemsSourceAttribute Members
Xceed.Wpf.Toolkit.PropertyGrid.Attributes Namespace