DesignerActionItem 类

  • 参考

定义

命名空间:
System.ComponentModel.Design
程序集:
System.Design.dll
程序集:
System.Windows.Forms.Design.dll

为表示智能标记面板上的面板项的类型提供基类。

public ref class DesignerActionItem abstract
public abstract class DesignerActionItem
type DesignerActionItem = class
Public MustInherit Class DesignerActionItem
继承
Object
DesignerActionItem
派生

示例

下面的代码示例演示如何创建 对象的集合 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

注解

类 DesignerActionItem 充当类的抽象基，这些类表示智能标记面板中的各个面板项，该类表示智能标记 (UI) 的类似菜单的用户界面。 .NET Framework提供派生类，这些类表示智能标记面板中的不同常见条目，包括纯文本、标头文本、关联DesignerActionList类的属性和方法以及设计器谓词。

通常，功能 DesignerAction 是在程序员提供的派生自 DesignerActionList的类中定义的，该类包含一种将各个面板项组合在一 GetSortedActionItems 起以形成智能标记面板的方法。 DesignerActionPropertyItem和 DesignerActionMethodItem 类型与派生自 DesignerActionList的 类的成员相关联，DesignerActionMethodItem当用户选择其关联的面板条目时，对象将激活。

注意

派生自 DesignerActionList的类的成员可以显示Forms和对话框。 默认情况下，这些窗口的父窗口将是智能标记面板的容器窗口。 将这些子窗口显式父级到另一个服务或窗口可能会导致项显示不正确。

构造函数

DesignerActionItem(String, String, String)

初始化 DesignerActionItem 类的新实例。

属性

AllowAssociate

获取或设置一个值，该值表示是否允许将此项放入具有相同 Category 属性值的一组项中。
Category

获取某个项的组名。
Description

获取项的补充文本。
DisplayName

获取此项的文本。
Properties

获取对一个集合的引用，该集合可用于存储程序员定义的键/值对。
ShowInSourceView

获取或设置指示此项目是否在源代码视图中显示的值。

方法

Equals(Object)

确定指定对象是否等于当前对象。

(继承自 Object)
GetHashCode()

作为默认哈希函数。

(继承自 Object)
GetType()

获取当前实例的 Type。

(继承自 Object)
MemberwiseClone()

创建当前 Object 的浅表副本。

(继承自 Object)
ToString()

返回表示当前对象的字符串。

(继承自 Object)

适用于

另请参阅