DesignerActionHeaderItem Classe

Referência

Definição

Namespace:: System.ComponentModel.Design

Assembly:: System.Design.dll

Assembly:: System.Windows.Forms.Design.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Representa um item de cabeçalho estático em um painel de marcações inteligentes. Essa classe não pode ser herdada.

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

Herança: Object

DesignerActionItem

DesignerActionTextItem
DesignerActionHeaderItem

Exemplos

O exemplo de código a seguir demonstra como criar uma coleção de DesignerActionItem objetos.

Para obter um exemplo completo de implementação de marcas inteligentes, consulte Como anexar marcas inteligentes a um componente do Windows Forms.

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

Comentários

Assim como a DesignerActionTextItem classe base, DesignerActionHeaderItem representa itens de texto estático individuais em um painel de marcas inteligentes. No entanto, DesignerActionHeaderItem as entradas são exibidas usando texto em negrito. Normalmente, um item de cabeçalho é usado para criar um título para um grupo de itens em um painel. Clicar em um item de cabeçalho não causa nenhuma ação.

Os itens de painel individuais são associados para formar um painel chamando o GetSortedActionItems método da DesignerActionList classe .

Construtores

DesignerActionHeaderItem(String)	Inicializa uma nova instância da classe DesignerActionHeaderItem usando a cadeia de caracteres de nome fornecida.
DesignerActionHeaderItem(String, String)	Inicializa uma nova instância da classe DesignerActionHeaderItem usando as cadeias de caracteres de nome e de categoria fornecidas.

Propriedades

AllowAssociate	Obtém ou define um valor que indica se você deseja permitir que este item seja colocado em um grupo de itens que têm o mesmo valor da propriedade Category. (Herdado de DesignerActionItem)
Category	Obtém o nome do grupo para um item. (Herdado de DesignerActionItem)
Description	Obtém o texto suplementar para o item. (Herdado de DesignerActionItem)
DisplayName	Obtém o texto para esse item. (Herdado de DesignerActionItem)
Properties	Obtém uma referência a uma coleção que pode ser usada para armazenar pares chave-valor definidos pelo programador. (Herdado de DesignerActionItem)
ShowInSourceView	Obtém ou define um valor que indica se esse item aparece na exibição de código-fonte. (Herdado de DesignerActionItem)

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Aplica-se a

Compartilhar via