DesignerActionPropertyItem Clase

Definición

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
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 la implementación de etiquetas inteligentes, consulte Cómo: Adjuntar 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 DesignerActionPropertyItem clase representa elementos individuales en un panel de etiquetas inteligentes. Normalmente, cada elemento 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 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 de tipo de propiedad Interfaz de usuario (UI) de edición de elementos de propiedad
Tiene un editor de tipos asociado (UITypeEditor) Se muestra el editor de tipos asociado a la propiedad subyacente 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 String de tipos muestre 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 los 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 editor de tipos de interfaz de usuario.

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)

Se aplica a

Consulte también