DesignerActionItem Класс

Определение

Предоставляет базовый класс для типов, которые представляют элемент области смарт-тега.Provides the base class for types that represent a panel item on a smart tag panel.

public ref class DesignerActionItem abstract
public abstract class DesignerActionItem
type DesignerActionItem = class
Public MustInherit Class DesignerActionItem
Наследование
DesignerActionItem
Производный

Примеры

В следующем примере кода показано, как создать коллекцию DesignerActionItem объектов.The following code example demonstrates how to create a collection of DesignerActionItem objects.

Полный пример реализации смарт-тегов см. в разделе как Присоединение смарт-тегов к компонентуWindows Forms.For a full example of implementing smart tags, see How to: Attach Smart Tags to a Windows Forms Component.

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

Комментарии

DesignerActionItem Класс выступает в качестве абстрактной базы для классов, представляющих отдельные элементы Panel в панели смарт-тегов, которая представляет пользовательский интерфейс в виде меню для смарт-тегов.The DesignerActionItem class serves as an abstract base for classes that represent individual panel items in a smart tag panel, which represents a menu-like user interface (UI) for smart tags. Класс предоставляет производные классы, представляющие различные общие записи в панели смарт-тегов, включая обычный текст, текст заголовка, свойства и методы связанного DesignerActionList класса, а также команды конструктора. .NET Framework.NET FrameworkThe .NET Framework.NET Framework supplies derived classes that represent the different common entries in a smart tag panel, including plain text, header text, properties and methods of the associated DesignerActionList class, and designer verbs.

Как правило, DesignerAction функция определяется в предоставляемом программистом классе, производном DesignerActionListот, который содержит GetSortedActionItems метод, группирующий отдельные элементы панели для формирования панели смарт-тега.Typically, your DesignerAction feature is defined in a programmer-supplied class derived from DesignerActionList, which contains a GetSortedActionItems method that groups individual panel items together to form the smart tag panel. DesignerActionList DesignerActionMethodItem Типы и связаныDesignerActionMethodItem с членами класса, производного от, а объекты активируются, когда пользователь выбирает соответствующую запись в панели. DesignerActionPropertyItemThe DesignerActionPropertyItem and DesignerActionMethodItem types are associated with members of the class derived from DesignerActionList, and DesignerActionMethodItem objects are activated when their associated panel entry is selected by the user.

Примечание

Формы и диалоговые окна могут отображаться членами класса, производного от DesignerActionList.Forms and dialog boxes can be displayed by members of the class derived from DesignerActionList. По умолчанию родительским элементом этих окон будет окно контейнера для панели смарт-тегов.By default, the parent of these windows will be the container window for the smart tag panel. Явное наследование этих дочерних окон к другой службе или окну может привести к неправильному отображению элементов.Explicitly parenting these child windows to another service or window may cause items to display improperly.

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

DesignerActionItem(String, String, String)

Инициализирует новый экземпляр класса DesignerActionItem.Initializes a new instance of the DesignerActionItem class.

Свойства

AllowAssociate

Получает или задает значение, указывающее, разрешается ли поместить этот элемент в группу элементов с одинаковыми значениями свойств Category.Gets or sets a value indicating whether to allow this item to be placed into a group of items that have the same Category property value.

Category

Возвращает имя группы для элемента.Gets the group name for an item.

Description

Возвращает дополняющий текст для элемента.Gets the supplemental text for the item.

DisplayName

Получает текст для данного элемента.Gets the text for this item.

Properties

Возвращает ссылку на коллекцию, которая может использоваться для хранения определенных программистом пар ключ/значение.Gets a reference to a collection that can be used to store programmer-defined key/value pairs.

ShowInSourceView

Получает или задает значение, указывающее, отображается ли данный элемент в представлении исходного кода.Gets or sets a value that indicates whether this item appears in source code view.

Методы

Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

Применяется к

Дополнительно