Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Classe DesignerActionPropertyItem

 

Representa um item do painel que está associado uma propriedade em uma classe derivada de DesignerActionList. Essa classe não pode ser herdada.

Namespace:   System.ComponentModel.Design
Assembly:  System.Design (em System.Design.dll)

System.Object
  System.ComponentModel.Design.DesignerActionItem
    System.ComponentModel.Design.DesignerActionPropertyItem

public sealed class DesignerActionPropertyItem : DesignerActionItem

NomeDescrição
System_CAPS_pubmethodDesignerActionPropertyItem(String, String)

Inicializa uma nova instância do DesignerActionPropertyItem classe, com a propriedade especificada e nomes para exibição.

System_CAPS_pubmethodDesignerActionPropertyItem(String, String, String)

Inicializa uma nova instância de DesignerActionPropertyItem classe, com a propriedade especificada e nomes de categoria e exibir o texto.

System_CAPS_pubmethodDesignerActionPropertyItem(String, String, String, String)

Inicializa uma nova instância de DesignerActionPropertyItem classe, com o texto de exibição e a descrição e a nomes de propriedade e a categoria especificados.

NomeDescrição
System_CAPS_pubpropertyAllowAssociate

Obtém ou define um valor que indica se deseja permitir que este item para ser colocado em um grupo de itens que têm o mesmo Category valor da propriedade.(Herdado de DesignerActionItem.)

System_CAPS_pubpropertyCategory

Obtém o nome do grupo para um item.(Herdado de DesignerActionItem.)

System_CAPS_pubpropertyDescription

Obtém o texto complementar para o item.(Herdado de DesignerActionItem.)

System_CAPS_pubpropertyDisplayName

Obtém o texto para este item.(Herdado de DesignerActionItem.)

System_CAPS_pubpropertyMemberName

Obtém o nome da propriedade que este item está associado.

System_CAPS_pubpropertyProperties

Obtém uma referência a uma coleção que pode ser usada para armazenar pares chave/valor definidos pelo programador.(Herdado de DesignerActionItem.)

System_CAPS_pubpropertyRelatedComponent

Obtém ou define um componente que contribui com seus itens no painel atual.

System_CAPS_pubpropertyShowInSourceView

Obtém ou define um valor que indica se este item aparece na exibição de código fonte.(Herdado de DesignerActionItem.)

NomeDescrição
System_CAPS_pubmethodEquals(Object)

Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)

System_CAPS_pubmethodGetHashCode()

Serve como a função de hash padrão.(Herdado de Object.)

System_CAPS_pubmethodGetType()

Obtém o Type da instância atual.(Herdado de Object.)

System_CAPS_pubmethodToString()

Retorna uma string que representa o objeto atual.(Herdado de Object.)

O DesignerActionPropertyItem classe representa os itens individuais no painel de marcas inteligentes. Cada item é geralmente associada uma propriedade em uma classe que deriva de DesignerActionList classe e fornecidos pelo autor do componente. A associação é mantida através do nome da propriedade, conforme armazenado no MemberName propriedade.

Itens do painel individuais associados para formar um painel por uma chamada para o GetSortedActionItems método o DesignerActionList classe.

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

Informações de tipo de propriedade

Edição de interface do usuário (UI) de propriedade item

Tem um editor de tipo associado (UITypeEditor)

O editor do tipo associado à propriedade subjacente é exibido para editar o valor da propriedade.

Tem um conversor de tipo associado a um tipo conhecido (TypeConverter)

O editor de tipo 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.

Nenhum dos itens acima.

O item é exibido como uma cadeia de caracteres de texto não editável usando o tipo de dados ToString método.

Todos os tipos fundamentais, como System.Boolean, comuns e .NET Framework tipos de dados, como System.String, fornecer editores e conversores de tipo padrão. Para obter mais informações sobre conversores de tipo, consulte How to: Implement a Type Converter ou Generalized Type Conversion. Para obter mais informações sobre editores de tipo, consulte How to: Implement a UI Type Editor.

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 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;
}

.NET Framework
Disponível desde 2.0

Quaisquer membros estáticos públicos ( Compartilhado no Visual Basic) desse tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Retornar ao início
Mostrar: