NotifyParentPropertyAttribute クラス

定義

名前空間:

System.ComponentModel

アセンブリ:

System.ComponentModel.Primitives.dll

ソース:

NotifyParentPropertyAttribute.cs

属性が適用されているプロパティの値が変更された場合に、親プロパティに通知することを示します。 このクラスは継承できません。

C#

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

継承

Object

Attribute

NotifyParentPropertyAttribute

属性

AttributeUsageAttribute

例

次のコード例では、 クラスと ExpandableObjectConverter クラスを使用NotifyParentPropertyAttributeして、カスタム コントロールに展開可能なプロパティを作成する方法を示します。

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

注釈

親プロパティがプロパティの値に対する変更の通知を受け取る必要がある場合は、プロパティに適用 NotifyParentPropertyAttribute します。 たとえば、プロパティ ウィンドウでは、 DataGridView.RowTemplate プロパティには や DefaultCellStyleなどのHeight入れ子になったプロパティがあります。 これらの入れ子になったプロパティは で NotifyParentPropertyAttribute(true) マークされるため、親プロパティにその値を更新し、プロパティ値が変更されたときに表示されるように通知します。

属性の使用の詳細については、「 属性」を参照してください。

コンストラクター

NotifyParentPropertyAttribute(Boolean)

プロパティの値が変更されたことを親プロパティに通知するかどうかを決定する値を指定して、NotifyParentPropertyAttribute クラスの新しいインスタンスを初期化します。

フィールド

Default	属性の状態が既定であることを示します。既定の状態では、プロパティの値が変更されても親プロパティには通知しません。 このフィールドは読み取り専用です。
No	プロパティの値が変更されたことを親プロパティに通知しないことを示します。 このフィールドは読み取り専用です。
Yes	プロパティの値が変更されたことを親プロパティに通知することを示します。 このフィールドは読み取り専用です。

プロパティ

NotifyParent	プロパティの値が変更されたことを親プロパティに通知するかどうかを示す値を取得または設定します。
TypeId	派生クラスで実装されると、この Attribute の一意の識別子を取得します。 (継承元 Attribute)

メソッド

Equals(Object)	指定したオブジェクトが現在のオブジェクトと同じかどうかを示す値を取得します。
GetHashCode()	オブジェクトのハッシュ コードを取得します。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
IsDefaultAttribute()	属性の現在の値が既定値かどうかを示す値を取得します。
Match(Object)	派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 (継承元 Attribute)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

適用対象

こちらもご覧ください

• ExpandableObjectConverter
• Attribute