DesignerActionPropertyItem Clase

Definición

Espacio de nombres:

System.ComponentModel.Design

Ensamblado:

System.Windows.Forms.Design.dll

Representa un elemento de panel asociado a una propiedad en una clase que se deriva de DesignerActionList. Esta clase no puede heredarse.

public ref class DesignerActionPropertyItem sealed : System::ComponentModel::Design::DesignerActionItem

public sealed class DesignerActionPropertyItem : System.ComponentModel.Design.DesignerActionItem

type DesignerActionPropertyItem = class
    inherit DesignerActionItem

Public NotInheritable Class DesignerActionPropertyItem
Inherits DesignerActionItem

Herencia

Object

DesignerActionItem

DesignerActionPropertyItem

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 DesignerActionPropertyItem clase representa elementos individuales en un panel de etiquetas inteligentes. Cada elemento normalmente está asociado a una propiedad de una clase derivada de la DesignerActionList clase y proporcionada por el autor del componente. La asociación se mantiene a través del nombre de la propiedad , como se almacena en la MemberName propiedad .

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

Para mostrar el valor de la propiedad asociada, esa propiedad debe tener un get método de descriptor de acceso; para permitir la edición, la propiedad debe tener un set método de descriptor de acceso. La forma en que el panel permite la edición directa de un elemento de propiedad por parte del usuario depende de la información de tipo auxiliar presente para el tipo de datos de la propiedad asociada. En la tabla siguiente se muestra el esquema probable.

Información del tipo de propiedad	Interfaz de usuario (UI) de edición de elementos de propiedad
Tiene un editor de tipos asociado (UITypeEditor)	El editor de tipos asociado a la propiedad subyacente se muestra para editar el valor de la propiedad.
Tiene un convertidor de tipos asociado a un tipo conocido (TypeConverter)	El editor de tipos del tipo conocido se muestra para editar el valor de la propiedad. Por ejemplo, es probable que un convertidor de tipos muestre String un TextBox.
Valor booleano	El elemento se muestra mediante una interfaz de usuario binaria, como una marca de verificación.
Nada de lo anterior.	El elemento se muestra como una cadena de texto no editable mediante el método del tipo de ToString datos.

Todos los tipos fundamentales, como System.Boolean, y tipos de datos comunes de .NET Framework, como System.String, proporcionan convertidores de tipos estándar y editores. Para obtener más información sobre los convertidores de tipos, vea How to: Implement a Type Converter o Generalized Type Conversion. Para obtener más información sobre los editores de tipos, vea Cómo: Implementar un tipo de interfaz de usuario Editor.

Constructores

DesignerActionPropertyItem(String, String)	Inicializa una nueva instancia de la clase DesignerActionPropertyItem con los nombres para mostrar y de propiedad especificados.
DesignerActionPropertyItem(String, String, String)	Inicializa una nueva instancia de la clase DesignerActionPropertyItem con los nombres de categoría y propiedad especificados, así como texto para mostrar.
DesignerActionPropertyItem(String, String, String, String)	Inicializa una nueva instancia de la clase DesignerActionPropertyItem con los nombres de categoría y propiedad especificados, así como texto para mostrar y de descripción.

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)
MemberName	Obtiene el nombre de la propiedad a la que está asociado este elemento.
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)
RelatedComponent	Obtiene o establece un componente que contribuye con sus elementos 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

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

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