DesignerActionMethodItem 类

定义

命名空间:

System.ComponentModel.Design

程序集:

System.Windows.Forms.Design.dll

Source:

DesignerActionMethodItem.cs

表示与派生自 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

继承

Object

DesignerActionItem

DesignerActionMethodItem

示例

下面的代码示例演示如何创建对象的集合 DesignerActionItem 。

有关实现智能标记的完整示例，请参阅 “如何：将智能标记附加到 Windows 窗体组件”。

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 类表示智能标记面板中的各个项。 此类型的项显示为活动用户界面元素（如超链接），该元素在派生自 DesignerActionList的类中调用程序员提供的方法。 项与方法之间的关联通过属性的值 MemberName 进行维护。 此项调用的方法既不能采用参数，也不能返回值。

单个面板项通过对类方法的GetSortedActionItems调用DesignerActionList来形成面板。

构造函数

名称	说明
DesignerActionMethodItem(DesignerActionList, String, String, Boolean)	使用指定的方法和显示名称初始化类的新实例 DesignerActionMethodItem ，以及指示该项是否应出现在其他用户界面上下文中的标志。
DesignerActionMethodItem(DesignerActionList, String, String, String, Boolean)	使用指定的方法、显示和类别名称初始化类的新实例 DesignerActionMethodItem ，以及指示该项是否应出现在其他用户界面上下文中的标志。
DesignerActionMethodItem(DesignerActionList, String, String, String, String, Boolean)	使用指定的方法和类别名称、显示和说明文本以及指示该项是否应出现在其他用户界面上下文中的标志初始化该类的新实例 DesignerActionMethodItem 。
DesignerActionMethodItem(DesignerActionList, String, String, String, String)	使用指定的方法和类别名称以及显示和说明文本初始化类的新实例 DesignerActionMethodItem 。
DesignerActionMethodItem(DesignerActionList, String, String, String)	使用指定的方法、显示和类别名称初始化类的新实例 DesignerActionMethodItem 。
DesignerActionMethodItem(DesignerActionList, String, String)	使用指定的方法和显示名称初始化类的新实例 DesignerActionMethodItem 。

属性

名称	说明
AllowAssociate	获取或设置一个值，该值指示是否允许将此项放入具有相同 Category 属性值的一组项中。 (继承自 DesignerActionItem)
Category	获取项的组名称。 (继承自 DesignerActionItem)
Description	获取项的补充文本。 (继承自 DesignerActionItem)
DisplayName	获取此项的文本。 (继承自 DesignerActionItem)
IncludeAsDesignerVerb	获取一个值，该值指示 DesignerActionMethodItem 应在其他用户界面上下文中显示。
MemberName	获取与此 DesignerActionMethodItem 关联的方法的名称。
Properties	获取对可用于存储程序员定义的键/值对的集合的引用。 (继承自 DesignerActionItem)
RelatedComponent	获取或设置一个组件，该组件将对象 DesignerActionMethodItem 贡献给当前面板。
ShowInSourceView	获取或设置一个值，该值指示此项是否出现在源代码视图中。 (继承自 DesignerActionItem)

方法

名称	说明
Invoke()	以编程方式执行与 . DesignerActionMethodItem.

另请参阅

• DesignerActionList
• GetSortedActionItems()
• MemberName
• 适用于 Windows 窗体的 Designer 命令和 DesignerAction 对象模型