DesignerActionItem 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.

Fornece a classe base para tipos que representam um item do painel no painel de marcações inteligentes.

public ref class DesignerActionItem abstract

public abstract class DesignerActionItem

type DesignerActionItem = class

Public MustInherit Class DesignerActionItem

Herança: Object
DesignerActionItem

Derivado: System.ComponentModel.Design.DesignerActionMethodItem

System.ComponentModel.Design.DesignerActionPropertyItem

System.ComponentModel.Design.DesignerActionTextItem

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

A DesignerActionItem classe serve como uma base abstrata para classes que representam itens de painel individuais em um painel de marcas inteligentes, que representa uma interface do usuário (interface do usuário) semelhante a um menu para marcas inteligentes. O .NET Framework fornece classes derivadas que representam as diferentes entradas comuns em um painel de marcas inteligentes, incluindo texto sem formatação, texto de cabeçalho, propriedades e métodos da classe associada DesignerActionList e verbos de designer.

Normalmente, seu DesignerAction recurso é definido em uma classe fornecida pelo programador derivada de DesignerActionList, que contém um GetSortedActionItems método que agrupa itens de painel individuais para formar o painel de marcas inteligentes. Os DesignerActionPropertyItem tipos e DesignerActionMethodItem são associados a membros da classe derivada de DesignerActionList, e DesignerActionMethodItem os objetos são ativados quando sua entrada de painel associada é selecionada pelo usuário.

Observação

Formulários e caixas de diálogo podem ser exibidos por membros da classe derivada de DesignerActionList. Por padrão, o pai dessas janelas será a janela de contêiner para o painel de marcas inteligentes. A criação explícita dessas janelas filho para outro serviço ou janela pode fazer com que os itens sejam exibidos incorretamente.

Construtores

DesignerActionItem(String, String, String)

Inicializa uma nova instância da classe DesignerActionItem.

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.
Category	Obtém o nome do grupo para um item.
Description	Obtém o texto suplementar para o item.
DisplayName	Obtém o texto para esse item.
Properties	Obtém uma referência a uma coleção que pode ser usada para armazenar pares chave-valor definidos pelo programador.
ShowInSourceView	Obtém ou define um valor que indica se esse item aparece na exibição de código-fonte.

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