Compartilhar via


DesignerActionItem Classe

Definição

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

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

Confira também