NotifyParentPropertyAttribute Clase

Definición

Espacio de nombres:

System.ComponentModel

Ensamblado:

System.ComponentModel.Primitives.dll

Source:

NotifyParentPropertyAttribute.cs

Indica que la propiedad principal se notifica cuando cambia el valor de la propiedad a la que se aplica este atributo. Esta clase no puede heredarse.

C#

[System.AttributeUsage(System.AttributeTargets.Property)]
public sealed class NotifyParentPropertyAttribute : Attribute

Herencia

Object

Attribute

NotifyParentPropertyAttribute

Atributos

AttributeUsageAttribute

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar y NotifyParentPropertyAttribute la ExpandableObjectConverter clase para crear una propiedad expandible en un control personalizado.

C#

using System;
using System.ComponentModel;
using System.Drawing;
using System.Globalization;
using System.Windows.Forms;

namespace ExpandableObjectDemo
{
    public partial class DemoControl : UserControl
    {
        BorderAppearance borderAppearanceValue = new BorderAppearance();
        private System.ComponentModel.IContainer components = null;

        public DemoControl()
        {
            InitializeComponent();
        }

        protected override void Dispose(bool disposing)
        {
            if (disposing && (components != null))
            {
                components.Dispose();
            }
            base.Dispose(disposing);
        }

        [Browsable(true)]
        [EditorBrowsable(EditorBrowsableState.Always)]
        [Category("Demo")]
        [DesignerSerializationVisibility(DesignerSerializationVisibility.Content)]
        public BorderAppearance Border
        {
            get
            {
                return this.borderAppearanceValue;
            }

            set
            {
                this.borderAppearanceValue = value;
            }
        }

        private void InitializeComponent()
        {
            components = new System.ComponentModel.Container();
            this.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Font;
        }
    }

    [TypeConverter(typeof(BorderAppearanceConverter))]
    public class BorderAppearance
    {
        private int borderSizeValue = 1;
        private Color borderColorValue = Color.Empty;

        [Browsable(true),
        NotifyParentProperty(true),
        EditorBrowsable(EditorBrowsableState.Always),
        DefaultValue(1)]
        public int BorderSize
        {
            get
            {
                return borderSizeValue;
            }
            set
            {
                if (value < 0)
                {
                    throw new ArgumentOutOfRangeException(
                        "BorderSize",
                        value,
                        "must be >= 0");
                }

                if (borderSizeValue != value)
                {
                    borderSizeValue = value;
                }
            }
        }

        [Browsable(true)]
        [NotifyParentProperty(true)]
        [EditorBrowsable(EditorBrowsableState.Always)]
        [DefaultValue(typeof(Color), "")]
        public Color BorderColor
        {
            get
            {
                return borderColorValue;
            }
            set
            {
                if (value.Equals(Color.Transparent))
                {
                    throw new NotSupportedException("Transparent colors are not supported.");
                }

                if (borderColorValue != value)
                {
                    borderColorValue = value;
                }
            }
        }
    }

    public class BorderAppearanceConverter : ExpandableObjectConverter
    {
        // This override prevents the PropertyGrid from 
        // displaying the full type name in the value cell.
        public override object ConvertTo(
            ITypeDescriptorContext context,
            CultureInfo culture,
            object value,
            Type destinationType)
        {
            if (destinationType == typeof(string))
            {
                return "";
            }

            return base.ConvertTo(
                context,
                culture,
                value,
                destinationType);
        }
    }
}

Comentarios

Se aplica NotifyParentPropertyAttribute a una propiedad si su propiedad primaria debe recibir notificaciones de cambios en los valores de la propiedad. Por ejemplo, en el ventana Propiedades, la DataGridView.RowTemplate propiedad tiene propiedades anidadas como Height y DefaultCellStyle. Estas propiedades anidadas se marcan con NotifyParentPropertyAttribute(true) para que notifiquen a la propiedad primaria que actualice su valor y se muestren cuando cambian los valores de propiedad.

Para obtener más información sobre el uso de atributos, vea Atributos.

Constructores

NotifyParentPropertyAttribute(Boolean)

Inicializa una nueva instancia de la clase NotifyParentPropertyAttribute utilizando el valor especificado para determinar si a la propiedad principal se le notifican los cambios en el valor de la propiedad.

Campos

Default	Indica el estado de atributo predeterminado, que indica que la propiedad principal no recibirá notificación de los cambios en su valor. Este campo es de solo lectura.
No	Indica que a la propiedad principal no se le notifican los cambios en el valor de la propiedad. Este campo es de solo lectura.
Yes	Indica que a la propiedad principal se le notifican los cambios en el valor de la propiedad. Este campo es de solo lectura.

Propiedades

NotifyParent	Obtiene o establece un valor que indica si a la propiedad principal se le deben notificar los cambios en el valor de la propiedad.
TypeId	Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute. (Heredado de Attribute)

Métodos

Equals(Object)	Obtiene un valor que indica si el objeto especificado es el mismo que el objeto actual.
GetHashCode()	Obtiene el código hash de este objeto.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IsDefaultAttribute()	Obtiene un valor que indica si el valor actual del atributo es su valor predeterminado.
Match(Object)	Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado. (Heredado de Attribute)
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

• ExpandableObjectConverter
• Attribute