Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase DesignerActionPropertyItem

 

Publicado: octubre de 2016

Representa un elemento de panel que está asociado a una propiedad en una clase derivada de DesignerActionList. Esta clase no puede heredarse.

Espacio de nombres:   System.ComponentModel.Design
Ensamblado:  System.Design (en System.Design.dll)

System.Object
  System.ComponentModel.Design.DesignerActionItem
    System.ComponentModel.Design.DesignerActionPropertyItem

public sealed class DesignerActionPropertyItem : DesignerActionItem

NombreDescripción
System_CAPS_pubmethodDesignerActionPropertyItem(String, String)

Inicializa una nueva instancia de la DesignerActionPropertyItem clase con la propiedad especificada y nombres para mostrar.

System_CAPS_pubmethodDesignerActionPropertyItem(String, String, String)

Inicializa una nueva instancia de la DesignerActionPropertyItem clase con la propiedad especificada y los nombres de categoría y mostrar texto.

System_CAPS_pubmethodDesignerActionPropertyItem(String, String, String, String)

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

NombreDescripción
System_CAPS_pubpropertyAllowAssociate

Obtiene o establece un valor que indica si se permite que este se coloca en un grupo de elementos que tienen el mismo Category valor de propiedad.(Heredado de DesignerActionItem).

System_CAPS_pubpropertyCategory

Obtiene el nombre de grupo para un elemento.(Heredado de DesignerActionItem).

System_CAPS_pubpropertyDescription

Obtiene el texto complementario para el elemento.(Heredado de DesignerActionItem).

System_CAPS_pubpropertyDisplayName

Obtiene el texto de este elemento.(Heredado de DesignerActionItem).

System_CAPS_pubpropertyMemberName

Obtiene el nombre de la propiedad que está asociado este elemento.

System_CAPS_pubpropertyProperties

Obtiene una referencia a una colección que puede utilizarse para almacenar los pares clave/valor definidos por el programador.(Heredado de DesignerActionItem).

System_CAPS_pubpropertyRelatedComponent

Obtiene o establece un componente que contribuye con sus elementos al panel actual.

System_CAPS_pubpropertyShowInSourceView

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

NombreDescripción
System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

La DesignerActionPropertyItem clase representa elementos individuales de un panel de etiquetas inteligentes. Cada elemento se suelen asociar a una propiedad en una clase que se deriva la DesignerActionList clase y proporcionado por el autor del componente. La asociación se mantiene a través del nombre de la propiedad, como se almacena en el MemberName propiedad.

Elementos de panel individuales se asocian entre sí para formar un panel mediante una llamada a la GetSortedActionItems el método de la DesignerActionList clase.

Para mostrar el valor de la propiedad asociada, ésta 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 manera en que el panel permite la edición directa de un elemento de propiedad por el usuario depende de la información de tipo auxiliar presente para el tipo de datos de la propiedad asociada. La siguiente tabla muestra los posibles esquemas.

Información de tipo de propiedad

Interfaz de usuario (IU) de edición de elemento de propiedad

Tiene un editor de tipos asociado (UITypeEditor)

Para editar el valor de la propiedad, se muestra el editor de tipos asociado a la propiedad subyacente.

Tiene un convertidor de tipos asociado a un tipo conocido (TypeConverter)

Para editar el valor de la propiedad, se muestra el editor de tipos para el tipo conocido. Por ejemplo, un convertidor de tipos para String debe mostrar probablemente un TextBox.

Valor booleano

Se muestra el elemento con una interfaz de usuario binaria, como una marca de verificación.

Ninguno de los anteriores.

El elemento se muestra como una cadena de texto no modificable utilizando el tipo de datos ToString (método).

Todos los tipos fundamentales, como System.Boolean, y common .NET Framework tipos de datos, como System.String, proporcionar estándar convertidores y editores. Para obtener más información sobre convertidores de tipos, vea How to: Implement a Type Converter o Generalized Type Conversion. Para obtener más información acerca de los editores de tipo, consulte How to: Implement a UI Type Editor.

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 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;
}

.NET Framework
Disponible desde 2.0

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: