DesignerActionHeaderItem Класс

Определение

Представляет элемент статического заголовка в области смарт-тега.Represents a static header item on a smart tag panel. Этот класс не наследуется.This class cannot be inherited.

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
Наследование

Примеры

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

Комментарии

DesignerActionHeaderItem Как и DesignerActionTextItem базовый класс, представляет отдельные статические текстовые элементы в панели смарт-тегов.Like the DesignerActionTextItem base class, DesignerActionHeaderItem represents individual static text items in a smart tag panel. DesignerActionHeaderItem Однако записи отображаются с помощью полужирного текста.However, DesignerActionHeaderItem entries are displayed using bold text. Как правило, элемент заголовка используется для создания заголовка для группы элементов на панели.Typically, a header item is used to create a heading for a group of items in a panel. При щелчке элемента заголовка не происходит никаких действий.Clicking on a header item causes no action.

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

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

DesignerActionHeaderItem(String)

Выполняет инициализацию нового экземпляра класса DesignerActionHeaderItem с использованием указанной строки имени.Initializes a new instance of the DesignerActionHeaderItem class using the provided name string.

DesignerActionHeaderItem(String, String)

Выполняет инициализацию нового экземпляра класса DesignerActionHeaderItem с использованием указанных строк имени и категории.Initializes a new instance of the DesignerActionHeaderItem class using the provided name and category strings.

Свойства

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)
Properties

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

(Унаследовано от DesignerActionItem)
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)
MemberwiseClone()

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

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

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

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

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

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