DesignerActionTextItem Classe

Definição

Namespace:

System.ComponentModel.Design

Assembly:

System.Windows.Forms.Design.dll

Representa um item de texto estático em um painel de marcações inteligentes.

public ref class DesignerActionTextItem : System::ComponentModel::Design::DesignerActionItem

public class DesignerActionTextItem : System.ComponentModel.Design.DesignerActionItem

type DesignerActionTextItem = class
    inherit DesignerActionItem

Public Class DesignerActionTextItem
Inherits DesignerActionItem

Herança

Object

DesignerActionItem

DesignerActionTextItem

Derivado

System.ComponentModel.Design.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 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 DesignerActionTextItem classe representa itens de texto estáticos individuais em um painel de marcas inteligentes. Itens individuais são associados juntos para formar um painel retornando o grupo de uma chamada para o GetSortedActionItems método .

Mais comumente, um item de texto estático é usado para criar um rótulo informativo em um painel. Clicar em um item de texto estático não causa nenhuma ação. O tipo DesignerActionHeaderItem derivado normalmente é usado para criar rótulos para separar categorias.

Construtores

DesignerActionTextItem(String, String)

Inicializa uma nova instância da classe DesignerActionTextItem.

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)

Confira também

• GetSortedActionItems()
• DesignerActionHeaderItem
• Comandos de designer e o modelo de objeto DesignerAction para Windows Forms