DesignerActionHeaderItem Clase

Definición

Espacio de nombres:

System.ComponentModel.Design

Ensamblado:

System.Windows.Forms.Design.dll

Representa un elemento de encabezado estático en un panel de etiquetas inteligentes. Esta clase no puede heredarse.

public ref class DesignerActionHeaderItem sealed : System::ComponentModel::Design::DesignerActionTextItem

public sealed class DesignerActionHeaderItem : System.ComponentModel.Design.DesignerActionTextItem

type DesignerActionHeaderItem = class
    inherit DesignerActionTextItem

Public NotInheritable Class DesignerActionHeaderItem
Inherits DesignerActionTextItem

Herencia

Object

DesignerActionItem

DesignerActionTextItem

DesignerActionHeaderItem

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear una colección de DesignerActionItem objetos .

Para obtener un ejemplo completo de cómo implementar etiquetas inteligentes, vea 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;
}

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

Comentarios

Al igual que la DesignerActionTextItem clase base, DesignerActionHeaderItem representa elementos de texto estático individuales en un panel de etiquetas inteligentes. Sin embargo, DesignerActionHeaderItem las entradas se muestran con texto en negrita. Normalmente, se usa un elemento de encabezado para crear un encabezado para un grupo de elementos de un panel. Al hacer clic en un elemento de encabezado no se produce ninguna acción.

Los elementos de panel individuales se asocian juntos para formar un panel mediante una llamada al GetSortedActionItems método de la DesignerActionList clase .

Constructores

DesignerActionHeaderItem(String)	Inicializa una nueva instancia de la clase DesignerActionHeaderItem con la cadena de nombre proporcionada.
DesignerActionHeaderItem(String, String)	Inicializa una nueva instancia de la clase DesignerActionHeaderItem con las cadenas de nombre y categoría proporcionadas.

Propiedades

AllowAssociate	Obtiene o establece un valor que indica si se permite colocar este elemento en un grupo de elementos cuya propiedad Category tenga el mismo valor. (Heredado de DesignerActionItem)
Category	Obtiene el nombre de grupo para un elemento. (Heredado de DesignerActionItem)
Description	Obtiene el texto complementario para el elemento. (Heredado de DesignerActionItem)
DisplayName	Obtiene el texto para este elemento. (Heredado de DesignerActionItem)
Properties	Obtiene una referencia a una colección que se puede utilizar para almacenar los pares de clave/valor definidos por programador. (Heredado de DesignerActionItem)
ShowInSourceView	Obtiene o establece un valor que indica si este elemento aparece en la vista de código fuente. (Heredado de DesignerActionItem)

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Consulte también

• GetSortedActionItems()
• Comandos del diseñador y modelo de objetos de DesignerAction para formularios Windows Forms