DesignerActionMethodItem Класс

Определение

Представляет элемент области смарт-тега, сопоставленный методу в классе, производном от класса DesignerActionList.Represents a smart tag panel item that is associated with a method in a class derived from DesignerActionList.

public ref class DesignerActionMethodItem : System::ComponentModel::Design::DesignerActionItem
public class DesignerActionMethodItem : System.ComponentModel.Design.DesignerActionItem
type DesignerActionMethodItem = class
    inherit DesignerActionItem
Public Class DesignerActionMethodItem
Inherits DesignerActionItem
Наследование
DesignerActionMethodItem

Примеры

В следующем примере кода показано, как создать коллекцию 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

Комментарии

DesignerActionMethodItem Класс представляет отдельные элементы в области смарт-тега.The DesignerActionMethodItem class represents individual items in a smart tag panel. Элемент этого типа отображается как активный элемент пользовательского интерфейса, например гиперссылка, который вызывает предоставляемый программистом метод в классе, производном от DesignerActionList.An item of this type is displayed as an active user interface element, such as a hyperlink, that invokes a programmer-supplied method in a class derived from DesignerActionList. Связь между элементом и методом сохраняется через значение MemberName свойства.The association between the item and the method is maintained through the value of the MemberName property. Метод, который вызывает этот элемент, не должен ни принимать параметры, ни возвращать значение.The method that this item invokes must neither take parameters nor return a value.

Отдельные элементы панели связаны друг с другом, образуя панель с помощью вызова GetSortedActionItems метода DesignerActionList класса.Individual panel items are associated together to form a panel by a call to the GetSortedActionItems method of the DesignerActionList class.

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

DesignerActionMethodItem(DesignerActionList, String, String)

Инициализирует новый экземпляр класса DesignerActionMethodItem с заданным именем метода и отображаемым именем.Initializes a new instance of the DesignerActionMethodItem class, with the specified method and display names.

DesignerActionMethodItem(DesignerActionList, String, String, Boolean)

Инициализирует новый экземпляр класса DesignerActionMethodItem с указанным именем метода и отображаемым именем, а также флагом, который указывает, должен ли отображаться элемент в других контекстах пользовательского интерфейса.Initializes a new instance of the DesignerActionMethodItem class, with the specified method and display names, and a flag that indicates whether the item should appear in other user interface contexts.

DesignerActionMethodItem(DesignerActionList, String, String, String)

Инициализирует новый экземпляр класса DesignerActionMethodItem с заданными именами метода и категории, а также отображаемым именем.Initializes a new instance of the DesignerActionMethodItem class, with the specified method, display, and category names.

DesignerActionMethodItem(DesignerActionList, String, String, String, Boolean)

Инициализирует новый экземпляр класса DesignerActionMethodItem с указанными именами метода и категории, отображаемым именем, а также флагом, который указывает, должен ли отображаться этот элемент в других контекстах пользовательского интерфейса.Initializes a new instance of the DesignerActionMethodItem class, with the specified method, display, and category names, and a flag that indicates whether the item should appear in other user interface contexts.

DesignerActionMethodItem(DesignerActionList, String, String, String, String)

Инициализирует новый экземпляр класса DesignerActionMethodItem с заданными именами метода и категории, а также отображаемым текстом и описанием.Initializes a new instance of the DesignerActionMethodItem class, with the specified method and category names, and display and description text.

DesignerActionMethodItem(DesignerActionList, String, String, String, String, Boolean)

Инициализирует новый экземпляр класса DesignerActionMethodItem с указанными именами метода и категории, отображаемым текстом и описанием, а также флагом, который указывает, должен ли отображаться этот элемент в других контекстах пользовательского интерфейса.Initializes a new instance of the DesignerActionMethodItem class, with the specified method and category names, display and description text, and a flag that indicates whether the item should appear in other user interface contexts.

Свойства

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.

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

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

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

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

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

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

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

Возвращает значение, указывающее, что элемент DesignerActionMethodItem должен отображаться в других контекстах пользовательского интерфейса.Gets a value that indicates the DesignerActionMethodItem should appear in other user interface contexts.

MemberName

Возвращает имя метода, которому сопоставлен этот объект DesignerActionMethodItem.Gets the name of the method that this DesignerActionMethodItem is associated with.

Properties

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

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

Получает или задает компонент, объекты DesignerActionMethodItem которого помещаются в текущую область.Gets or sets a component that contributes its DesignerActionMethodItem objects to the current panel.

ShowInSourceView

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

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

Методы

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)
Invoke()

Программным способом выполняет метод, сопоставленный элементу DesignerActionMethodItem.Programmatically executes the method associated with the DesignerActionMethodItem.

MemberwiseClone()

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

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

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

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

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

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