DesignerActionPropertyItem 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 do painel que está associado a uma propriedade em uma classe derivada de DesignerActionList. Essa classe não pode ser herdada.

public ref class DesignerActionPropertyItem sealed : System::ComponentModel::Design::DesignerActionItem

public sealed class DesignerActionPropertyItem : System.ComponentModel.Design.DesignerActionItem

type DesignerActionPropertyItem = class
    inherit DesignerActionItem

Public NotInheritable Class DesignerActionPropertyItem
Inherits DesignerActionItem

Herança: Object

DesignerActionItem
DesignerActionPropertyItem

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 DesignerActionPropertyItem classe representa itens individuais em um painel de marcas inteligentes. Cada item normalmente é associado a uma propriedade em uma classe derivada da DesignerActionList classe e fornecida pelo autor do componente. A associação é mantida por meio do nome da propriedade, conforme armazenado na MemberName propriedade .

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

Para exibir o valor da propriedade associada, essa propriedade deve ter um get método de acessador; para permitir a edição, a propriedade deve ter um set método acessador. A maneira como o painel permite a edição direta de um item de propriedade pelo usuário depende das informações de tipo de suporte presentes para o tipo de dados da propriedade associada. A tabela a seguir mostra o esquema provável.

Informações de tipo de propriedade	Interface do usuário (interface do usuário) de edição de item de propriedade
Tem um editor de tipos associado (UITypeEditor)	O editor de tipos associado à propriedade subjacente é exibido para editar o valor da propriedade.
Tem um conversor de tipo associado a um tipo conhecido (TypeConverter)	O editor de tipos para o tipo conhecido é exibido para editar o valor da propriedade. Por exemplo, um conversor de tipo para String provavelmente exibirá um TextBox.
Valor booliano	O item é exibido usando uma interface do usuário binária, como uma marca de seleção.
Nenhuma das opções acima.	O item é exibido como uma cadeia de caracteres de texto não editável usando o método do tipo de ToString dados.

Todos os tipos fundamentais, como System.Boolean, e tipos de dados comuns do .NET Framework, como System.String, fornecem conversores de tipo padrão e editores. Para obter mais informações sobre conversores de tipo, consulte Como implementar um conversor de tipo ou conversão de tipo generalizado. Para obter mais informações sobre editores de tipos, consulte Como implementar um editor de tipo de interface do usuário.

Construtores

DesignerActionPropertyItem(String, String)	Inicializa uma nova instância da classe DesignerActionPropertyItem com os nomes de exibição e de propriedade especificados.
DesignerActionPropertyItem(String, String, String)	Inicializa uma nova instância da classe DesignerActionPropertyItem com o texto de exibição e os nomes de categoria e de propriedade especificados.
DesignerActionPropertyItem(String, String, String, String)	Inicializa uma nova instância da classe DesignerActionPropertyItem com o texto de exibição e de descrição e os nomes de categoria e de propriedade especificados.

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)
MemberName	Obtém o nome da propriedade à qual este item está associado.
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)
RelatedComponent	Obtém ou define um componente que contribui com os respectivos itens no painel atual.
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

Partilhar via