DesignerActionItem Clase

  • Referencia

Definición

Espacio de nombres:
System.ComponentModel.Design
Ensamblado:
System.Design.dll
Ensamblado:
System.Windows.Forms.Design.dll

Proporciona la clase base para los tipos que representan un elemento de panel en un panel de etiquetas inteligentes.

public ref class DesignerActionItem abstract
public abstract class DesignerActionItem
type DesignerActionItem = class
Public MustInherit Class DesignerActionItem
Herencia
Object
DesignerActionItem
Derivado

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

La DesignerActionItem clase sirve como base abstracta para las clases que representan elementos de panel individuales en un panel de etiquetas inteligentes, que representa una interfaz de usuario (UI) similar a un menú para etiquetas inteligentes. .NET Framework proporciona clases derivadas que representan las distintas entradas comunes en un panel de etiquetas inteligentes, incluidos texto sin formato, texto de encabezado, propiedades y métodos de la clase asociada DesignerActionList y verbos del diseñador.

Normalmente, la DesignerAction característica se define en una clase proporcionada por el programador derivada de DesignerActionList, que contiene un GetSortedActionItems método que agrupa elementos de panel individuales para formar el panel de etiquetas inteligentes. Los DesignerActionPropertyItem tipos y DesignerActionMethodItem están asociados a los miembros de la clase derivada de DesignerActionList, y DesignerActionMethodItem los objetos se activan cuando el usuario selecciona su entrada del panel asociado.

Nota:

Los miembros de la clase derivada de pueden mostrar formularios y cuadros de diálogo.DesignerActionList De forma predeterminada, el elemento primario de estas ventanas será la ventana contenedora del panel de etiquetas inteligentes. La creación explícita de estas ventanas secundarias en otro servicio o ventana puede provocar que los elementos se muestren incorrectamente.

Constructores

DesignerActionItem(String, String, String)

Inicializa una nueva instancia de la clase DesignerActionItem.

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.
Category

Obtiene el nombre de grupo para un elemento.
Description

Obtiene el texto complementario para el elemento.
DisplayName

Obtiene el texto para este elemento.
Properties

Obtiene una referencia a una colección que se puede utilizar para almacenar los pares de clave/valor definidos por programador.
ShowInSourceView

Obtiene o establece un valor que indica si este elemento aparece en la vista de código fuente.

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)

Se aplica a

Consulte también