System.Design 2.0.0.0 System.ComponentModel.Design.DesignerActionItem

The class represents individual items in a smart tag panel. Each item is typically associated with a property in a class that is derived from the class and supplied by the component author. The association is maintained through the name of the property, as stored in the property.

Individual panel items are associated together to form a panel by a call to the method of the class.

To display the value of the associated property, that property must have a get accessor method; to allow editing, the property must have a set accessor method. The way in which the panel allows direct editing of a property item by the user depends on the supporting type information present for the data type of the associated property. The following table shows the likely scheme.

Property type information

Property item editing user interface (UI)

Has an associated type editor ()

The type editor associated with the underlying property is displayed for editing the property's value.

Has an associated type converter to a known type ()

The type editor for the known type is displayed for editing the property's value. For example, a type converter to will likely display a .

Boolean value

The item is displayed using a binary UI, such as a check mark.

None of the above.

The item is displayed as a non-editable text string using the data type's method.

All fundamental types, such as , and common dnprdnshort data types, such as , supply standard type converters and editors. For more information about type converters, see How to: Implement a Type Converter or Generalized Type Conversion. For more information about type editors, see How to: Implement a UI Type Editor.

Represents a panel item that is associated with a property in a class derived from . This class cannot be inherited.

- Constructor
  2.0.0.0

  The constructor sets the and properties to null.

  The parameter refers to the name of the associated property that is a member of the programmer-supplied class derived from the class.

  Initializes a new instance of the class, with the specified property and display names.

  The case-sensitive name of the property associated with this panel item.
  The panel text for this item.
- Constructor
  2.0.0.0

  The constructor sets the property to null.

  For more information about how the parameter is used to group items on a panel, see the method.

  The parameter refers to the name of the associated property that is a member of the programmer-supplied class derived from .

  Initializes a new instance of the class, with the specified property and category names, and display text.

  The case-sensitive name of the property associated with this panel item.
  The panel text for this item.
  The case-sensitive used to group similar items on the panel.
- Constructor
  2.0.0.0

  For more information about how the parameter is used to group items on a panel, see the method.

  The parameter refers to the name of the associated property that is a member of the programmer-supplied class derived from the class.

  Initializes a new instance of the class, with the specified property and category names, and display and description text.

  The case-sensitive name of the property associated with this panel item.
  The panel text for this item.
  The case-sensitive used to group similar items on the panel.
  Supplemental text for this item, used in ToolTips or the status bar.
- Property
  2.0.0.0
  System.String To be added.

  The property specifies which property—in the class derived from the class—the item should be bound to. When the programmer interacts with the panel item through the user interface (UI), this associated property will be set.

  is set in the constructor. Its value is case-sensitive.

  Gets the name of the property that this item is associated with.

- Property
  2.0.0.0
  System.ComponentModel.IComponent To be added.

  With the property, another component can lend its pull-model panel items to the current list. For example, a user control might aggregate the objects from one or more of its constituent controls.

  This property works in conjunction with the property.

  Gets or sets a component that contributes its items to the current panel.