DesignerActionHeaderItem 类

定义

命名空间:

System.ComponentModel.Design

程序集:

System.Windows.Forms.Design.dll

表示智能标记面板的静态标题项。 此类不能被继承。

public ref class DesignerActionHeaderItem sealed : System::ComponentModel::Design::DesignerActionTextItem

public sealed class DesignerActionHeaderItem : System.ComponentModel.Design.DesignerActionTextItem

type DesignerActionHeaderItem = class
    inherit DesignerActionTextItem

Public NotInheritable Class DesignerActionHeaderItem
Inherits DesignerActionTextItem

继承

Object

DesignerActionItem

DesignerActionTextItem

DesignerActionHeaderItem

示例

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

注解

DesignerActionTextItem与基类一样， DesignerActionHeaderItem 表示智能标记面板中的各个静态文本项。 但是， DesignerActionHeaderItem 条目使用粗体文本显示。 通常，标题项用于为面板中的一组项创建标题。 单击标题项不会导致执行任何操作。

通过调用 GetSortedActionItems 类的 DesignerActionList 方法，将各个面板项关联在一起以形成面板。

构造函数

DesignerActionHeaderItem(String)	使用提供的名称字符串初始化 DesignerActionHeaderItem 类的新实例。
DesignerActionHeaderItem(String, String)	使用提供的名称和类别字符串初始化 DesignerActionHeaderItem 类的新实例。

属性

AllowAssociate	获取或设置一个值，该值表示是否允许将此项放入具有相同 Category 属性值的一组项中。 (继承自 DesignerActionItem)
Category	获取某个项的组名。 (继承自 DesignerActionItem)
Description	获取项的补充文本。 (继承自 DesignerActionItem)
DisplayName	获取此项的文本。 (继承自 DesignerActionItem)
Properties	获取对一个集合的引用，该集合可用于存储程序员定义的键/值对。 (继承自 DesignerActionItem)
ShowInSourceView	获取或设置指示此项目是否在源代码视图中显示的值。 (继承自 DesignerActionItem)

方法

Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前对象的字符串。 (继承自 Object)

另请参阅

• GetSortedActionItems()
• Windows 窗体的设计器命令和 DesignerAction 对象模型