DesignerActionPropertyItem Класс

Определение

Пространство имен:

System.ComponentModel.Design

Сборка:

System.Windows.Forms.Design.dll

Исходный код:

DesignerActionPropertyItem.cs

Представляет элемент панели, связанный со свойством в классе, производным от DesignerActionList. Этот класс не может быть унаследован.

public ref class DesignerActionPropertyItem sealed : System::ComponentModel::Design::DesignerActionItem

public sealed class DesignerActionPropertyItem : System.ComponentModel.Design.DesignerActionItem

type DesignerActionPropertyItem = class
    inherit DesignerActionItem

Public NotInheritable Class DesignerActionPropertyItem
Inherits DesignerActionItem

Наследование

Object

DesignerActionItem

DesignerActionPropertyItem

Примеры

В следующем примере кода показано, как создать коллекцию DesignerActionItem объектов. Полный пример реализации смарт-тегов см. в статье "Практическое руководство. Присоединение смарт-тегов к компоненту Windows Forms".

public override DesignerActionItemCollection GetSortedActionItems()
{
    DesignerActionItemCollection items = new DesignerActionItemCollection();

    //Define static section header entries.
    items.Add(new DesignerActionHeaderItem("Appearance"));
    items.Add(new DesignerActionHeaderItem("Information"));

    //Boolean property for locking color selections.
    items.Add(new DesignerActionPropertyItem("LockColors",
                     "Lock Colors", "Appearance",
                     "Locks the color properties."));
    if (!LockColors)
    {
        items.Add(new DesignerActionPropertyItem("BackColor",
                         "Back Color", "Appearance",
                         "Selects the background color."));
        items.Add(new DesignerActionPropertyItem("ForeColor",
                         "Fore Color", "Appearance",
                         "Selects the foreground color."));

        //This next method item is also added to the context menu 
        // (as a designer verb).
        items.Add(new DesignerActionMethodItem(this,
                         "InvertColors", "Invert Colors",
                         "Appearance",
                         "Inverts the fore and background colors.",
                          true));
    }
    items.Add(new DesignerActionPropertyItem("Text",
                     "Text String", "Appearance",
                     "Sets the display text."));

    //Create entries for static Information section.
    StringBuilder location = new StringBuilder("Location: ");
    location.Append(colLabel.Location);
    StringBuilder size = new StringBuilder("Size: ");
    size.Append(colLabel.Size);
    items.Add(new DesignerActionTextItem(location.ToString(),
                     "Information"));
    items.Add(new DesignerActionTextItem(size.ToString(),
                     "Information"));

    return items;
}

Public Overrides Function GetSortedActionItems() _
As DesignerActionItemCollection
    Dim items As New DesignerActionItemCollection()

    'Define static section header entries.
    items.Add(New DesignerActionHeaderItem("Appearance"))
    items.Add(New DesignerActionHeaderItem("Information"))

    'Boolean property for locking color selections.
    items.Add(New DesignerActionPropertyItem( _
    "LockColors", _
    "Lock Colors", _
    "Appearance", _
    "Locks the color properties."))

    If Not LockColors Then
        items.Add( _
        New DesignerActionPropertyItem( _
        "BackColor", _
        "Back Color", _
        "Appearance", _
        "Selects the background color."))

        items.Add( _
        New DesignerActionPropertyItem( _
        "ForeColor", _
        "Fore Color", _
        "Appearance", _
        "Selects the foreground color."))

        'This next method item is also added to the context menu 
        ' (as a designer verb).
        items.Add( _
        New DesignerActionMethodItem( _
        Me, _
        "InvertColors", _
        "Invert Colors", _
        "Appearance", _
        "Inverts the fore and background colors.", _
        True))
    End If
    items.Add( _
    New DesignerActionPropertyItem( _
    "Text", _
    "Text String", _
    "Appearance", _
    "Sets the display text."))

    'Create entries for static Information section.
    Dim location As New StringBuilder("Location: ")
    location.Append(colLabel.Location)
    Dim size As New StringBuilder("Size: ")
    size.Append(colLabel.Size)

    items.Add( _
    New DesignerActionTextItem( _
    location.ToString(), _
    "Information"))

    items.Add( _
    New DesignerActionTextItem( _
    size.ToString(), _
    "Information"))

    Return items
End Function

Комментарии

Класс DesignerActionPropertyItem представляет отдельные элементы на панели смарт-тегов. Каждый элемент обычно связан со свойством в классе, производным от DesignerActionList класса и предоставленным автором компонента. Связь сохраняется через имя свойства, как хранится в свойстве MemberName .

Отдельные элементы панели связаны вместе для формирования панели путем вызова GetSortedActionItems метода DesignerActionList класса.

Чтобы отобразить значение связанного свойства, это свойство должно иметь get метод доступа; чтобы разрешить редактирование, свойство должно иметь set метод доступа. Способ, в котором панель разрешает прямое редактирование элемента свойства пользователем, зависит от сведений о вспомогательных типах, присутствующих для типа данных связанного свойства. В следующей таблице показана скорее схема.

Сведения о типе свойства	Элемент свойства редактирования пользовательского интерфейса (пользовательский интерфейс)
Имеет связанный редактор типов (UITypeEditor)	Редактор типов, связанный с базовым свойством, отображается для редактирования значения свойства.
Имеет связанный преобразователь типов с известным типом (TypeConverter)	Редактор типов для известного типа отображается для редактирования значения свойства. Например, преобразователь типов, который String , скорее всего, будет отображаться TextBox.
Логическое значение	Элемент отображается с помощью двоичного пользовательского интерфейса, например флажка.
Ничего из вышеперечисленного.	Элемент отображается как не редактируемая текстовая строка с помощью метода типа ToString данных.

Все основные типы, такие как System.Booleanи распространенные типы данных .NET Framework, например System.String, предоставляют стандартные преобразователи типов и редакторы. Дополнительные сведения о преобразователях типов см. в статье "Практическое руководство. Реализация преобразователя типов или обобщенного преобразования типов". Дополнительные сведения о редакторах типов см. в статье "Практическое руководство. Реализация редактора типов пользовательского интерфейса".

Конструкторы

Имя	Описание
DesignerActionPropertyItem(String, String, String, String)	Инициализирует новый экземпляр DesignerActionPropertyItem класса с указанными именами свойств и категорий, а также текстом отображения и описания.
DesignerActionPropertyItem(String, String, String)	Инициализирует новый экземпляр DesignerActionPropertyItem класса с указанными именами свойств и категорий и отображаемым текстом.
DesignerActionPropertyItem(String, String)	Инициализирует новый экземпляр DesignerActionPropertyItem класса с указанным свойством и отображаемыми именами.

Свойства

Имя	Описание
AllowAssociate	Возвращает или задает значение, указывающее, следует ли разрешить этому элементу помещаться в группу элементов с одинаковым Category значением свойства. (Унаследовано от DesignerActionItem)
Category	Возвращает имя группы для элемента. (Унаследовано от DesignerActionItem)
Description	Получает дополнительный текст для элемента. (Унаследовано от DesignerActionItem)
DisplayName	Возвращает текст для этого элемента. (Унаследовано от DesignerActionItem)
MemberName	Возвращает имя свойства, с которым связан этот элемент.
Properties	Возвращает ссылку на коллекцию, которую можно использовать для хранения пар ключей и значений, определенных программистом. (Унаследовано от DesignerActionItem)
RelatedComponent	Возвращает или задает компонент, который вносит свой вклад в текущую панель.
ShowInSourceView	Возвращает или задает значение, указывающее, отображается ли этот элемент в представлении исходного кода. (Унаследовано от DesignerActionItem)

См. также раздел

• MemberName
• DesignerActionList
• GetSortedActionItems()
• Команды конструктора и объектная модель DesignerAction для Windows Forms