DesignerActionMethodItem Clase

Definición

Espacio de nombres:

System.ComponentModel.Design

Ensamblado:

System.Windows.Forms.Design.dll

Source:

DesignerActionMethodItem.cs

Representa un elemento de panel de etiquetas inteligentes asociado a un método de una clase derivada de DesignerActionList.

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

public class DesignerActionMethodItem : System.ComponentModel.Design.DesignerActionItem

type DesignerActionMethodItem = class
    inherit DesignerActionItem

Public Class DesignerActionMethodItem
Inherits DesignerActionItem

Herencia

Object

DesignerActionItem

DesignerActionMethodItem

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 la implementación de etiquetas inteligentes, vea Cómo: Asociar etiquetas inteligentes a un componente de 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

Comentarios

La DesignerActionMethodItem clase representa elementos individuales en un panel de etiquetas inteligentes. Un elemento de este tipo se muestra como un elemento de interfaz de usuario activo, como un hipervínculo, que invoca un método proporcionado por el programador en una clase derivada de DesignerActionList. La asociación entre el elemento y el método se mantiene a través del valor de la MemberName propiedad . El método que invoca este elemento no debe tomar parámetros ni devolver un valor.

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

Constructores

Nombre	Description
DesignerActionMethodItem(DesignerActionList, String, String, Boolean)	Inicializa una nueva instancia de la DesignerActionMethodItem clase, con el método y los nombres para mostrar especificados, y una marca que indica si el elemento debe aparecer en otros contextos de interfaz de usuario.
DesignerActionMethodItem(DesignerActionList, String, String, String, Boolean)	Inicializa una nueva instancia de la DesignerActionMethodItem clase, con el método, la presentación y los nombres de categoría especificados, y una marca que indica si el elemento debe aparecer en otros contextos de interfaz de usuario.
DesignerActionMethodItem(DesignerActionList, String, String, String, String, Boolean)	Inicializa una nueva instancia de la DesignerActionMethodItem clase, con los nombres de método y categoría especificados, el texto para mostrar y la descripción, y una marca que indica si el elemento debe aparecer en otros contextos de la interfaz de usuario.
DesignerActionMethodItem(DesignerActionList, String, String, String, String)	Inicializa una nueva instancia de la DesignerActionMethodItem clase, con los nombres de método y categoría especificados, y muestra y el texto de descripción.
DesignerActionMethodItem(DesignerActionList, String, String, String)	Inicializa una nueva instancia de la DesignerActionMethodItem clase, con el método, la presentación y los nombres de categoría especificados.
DesignerActionMethodItem(DesignerActionList, String, String)	Inicializa una nueva instancia de la DesignerActionMethodItem clase , con el método y los nombres para mostrar especificados.

Propiedades

Nombre	Description
AllowAssociate	Obtiene o establece un valor que indica si se debe permitir que este elemento se coloque en un grupo de elementos que tengan el mismo Category valor de propiedad. (Heredado de DesignerActionItem)
Category	Obtiene el nombre del grupo de un elemento. (Heredado de DesignerActionItem)
Description	Obtiene el texto complementario del elemento. (Heredado de DesignerActionItem)
DisplayName	Obtiene el texto de este elemento. (Heredado de DesignerActionItem)
IncludeAsDesignerVerb	Obtiene un valor que indica DesignerActionMethodItem que debe aparecer en otros contextos de interfaz de usuario.
MemberName	Obtiene el nombre del método al que DesignerActionMethodItem está asociado.
Properties	Obtiene una referencia a una colección que se puede usar para almacenar pares clave-valor definidos por el programador. (Heredado de DesignerActionItem)
RelatedComponent	Obtiene o establece un componente que contribuye a sus DesignerActionMethodItem objetos al panel actual.
ShowInSourceView	Obtiene o establece un valor que indica si este elemento aparece en la vista de código fuente. (Heredado de DesignerActionItem)

Métodos

Nombre	Description
Invoke()	Ejecuta mediante programación el método asociado a .DesignerActionMethodItem

Consulte también

• DesignerActionList
• GetSortedActionItems()
• MemberName
• Comandos del diseñador y el modelo de objetos DesignerAction para Formularios Windows Forms