バージョン

NotifyPropChange(Enum,PropChangeInfo) メソッド

オブジェクトの状態が変更された際、リスナーに通知します。
シンタックス
'宣言
 
Protected Overloads Sub NotifyPropChange( _
   ByVal propId As Enum, _
   ByVal trigger As Infragistics.Shared.PropChangeInfo _
) 
protected void NotifyPropChange( 
   Enum propId,
   Infragistics.Shared.PropChangeInfo trigger
)

パラメータ

propId
プロパティを表す ID。
trigger
オプション。プロパティ変更の通知時に使用され、変更を発生させたコンテキストの完全なチェインを作成します。
使用例
Imports Infragistics.Shared
Imports Infragistics.Win

Public Class ExampleClass
    Inherits SubObjectBase

    Private appearanceHolder As appearanceHolder
    Private enabledValue As Boolean

    ' Listens for property change notifications of the object's sub objects.
    Protected Overrides Sub OnSubObjectPropChanged(ByVal pci As Infragistics.Shared.PropChangeInfo)

        ' Check if the source is our appearance object.
        If Not Me.appearanceHolder Is Nothing _
        AndAlso pci.Source.Equals(Me.appearanceHolder.RootAppearance) Then

            ' Do what needs to be done (if anything) based on the 
            ' nature of the change
            Dim propId As AppearancePropIds

            propId = pci.PropId

            If propId = AppearancePropIds.Image _
            OrElse propId = AppearancePropIds.ImageHAlign _
            OrElse propId = AppearancePropIds.ImageVAlign Then
                Me.DirtyImage()
            Else
                Me.DirtyText()
            End If

            ' Call NotifyPropChange with the appropriate property id
            ' and the PropChangeInfo instance that was passed into
            ' this method.
            Me.NotifyPropChange(StatusBarPropertyIds.Appearance, pci)

            ' Note: If there are any listeners to our 'SubObjectPropChanged' 
            ' event, the event will be raised with a new PropChangeInfo
            ' event argument whose properties will be set as follows:
            ' 1. The Source property will refer to this object.
            ' 2. The PropId property will be StatusBarPropertyIds.Appearance.
            ' 3. The Trigger property will be the passed in PropChangeInfo.
            '
            ' This will effectively create a chain of PropChangeInfo
            ' objects, with the new one at the head, that exposes
            ' complete context information regarding the change. 
            Return
        End If

        ' There is an overload to the 'NotifyPropChange' method
        ' that just takes the passed in PropChangeInfo object.
        ' This is useful if you want to pass the notification
        ' along to this object's listeners 'as is'. In other words,
        ' without creating a new PropChangeInfo to add to the 
        ' head of the chain (refer to above comments).
        Me.NotifyPropChange(pci)

        Dim sb As System.Text.StringBuilder

        ' The following code walks up the PropChangeInfo chain
        ' and writes out the source and property id of each
        ' object.
        While Not pci Is Nothing

            sb = New System.Text.StringBuilder()

            sb.Append("Property Id: ")
            sb.Append(pci.PropId.ToString())
            sb.Append(", source: ")
            sb.Append(pci.Source.ToString())
            sb.Append(". type: ")
            sb.Append(pci.Source.GetType().ToString())

            Debug.WriteLine(sb.ToString())
            Debug.Indent()
        End While

        ' Get the next PropChangeInfo object in the chain 
        pci = pci.Trigger

        ' Reset the indent level of the Debug object
        Debug.IndentLevel = 0

        ' Alternatively there are 'Find...' methods that
        ' will walk up the chain until they find the 
        ' requested PropChangeInfo object to return or
        ' they will return null.
        pci = pci.FindPropId(AppearancePropIds.BackGradientStyle)
        pci = pci.FindTrigger(Me.appearanceHolder.RootAppearance)

        ' There is also a 'FindSource' method which will
        ' return the source object based on the passed
        ' in type. If no source object of that type is
        ' found in the chain this method will return null.
        Dim source As Object
        source = pci.FindSource(GetType(Infragistics.Win.Appearance))

    End Sub

    Public Property Enabled() As Boolean

        Get
            Return Me.enabledValue
        End Get

        Set(ByVal Value As Boolean)
            If Not Me.enabledValue = Value Then
                Me.enabledValue = Value

                ' Call the overload to the 'NotifyPropChange' method
                ' that just takes a property id. 
                Me.NotifyPropChange(StatusBarPropertyIds.Enabled)

                ' Note: If there are any listeners to our 'SubObjectPropChanged' 
                ' event, the event will be raised with a PropChangeInfo
                ' event argument whose properties will be` set as follows:
                ' 1. The Source property will refer to this object.
                ' 2. The PropId property will be StatusBarPropertyIds.Enabled.
                ' 3. The Trigger property will be null.
            End If
        End Set

    End Property

    Public ReadOnly Property Appearance() As AppearanceBase

        Get
            ' Lazily create the appearance holder
            If Me.appearanceHolder Is Nothing Then

                Me.appearanceHolder = New AppearanceHolder()

                ' Listen in to property changes generated by the
                ' object. When one of its properties changes our 
                ' 'OnSubObjectPropChanged' method will be called.
                AddHandler Me.appearanceHolder.SubObjectPropChanged, Me.SubObjectPropChangeHandler
            End If

            Return Me.appearanceHolder.Appearance

        End Get

    End Property

    Protected Overrides Sub OnDispose()

        If Not Me.appearanceHolder Is Nothing Then
            ' Remove ourselves as a listener
            RemoveHandler Me.appearanceHolder.SubObjectPropChanged, Me.SubObjectPropChangeHandler
        End If

    End Sub

    Private Sub DirtyImage()
    End Sub

    Private Sub DirtyText()
    End Sub
End Class

Public Enum StatusBarPropertyIds
    Appearance = 1
    Enabled = 2
End Enum
using System;
using System.Diagnostics;
using Infragistics.Shared;
using Infragistics.Win;

namespace SharedSnippets
{
	public class ExampleClass : SubObjectBase
	{
		private AppearanceHolder appearanceHolder = null;
		private bool			 enabled = true;

		// Listens for property change notifications of the object's sub objects.
		protected override void OnSubObjectPropChanged( PropChangeInfo pci )
		{
			// Check if the source is our appearance object.
			if (this.appearanceHolder != null && 
				pci.Source == this.appearanceHolder.RootAppearance)
			{
				// Do what needs to be done (if anything) based on the 
				// nature of the change
				switch ( (AppearancePropIds)pci.PropId )
				{
					case AppearancePropIds.Image:
					case AppearancePropIds.ImageHAlign:
					case AppearancePropIds.ImageVAlign:
					{
						this.DirtyImage();
						break;
					}
					default:
						this.DirtyText();
						break;
				}

				// Call NotifyPropChange with the appropriate property id
				// and the PropChangeInfo instance that was passed into
				// this method.
				this.NotifyPropChange( StatusBarPropertyIds.Appearance, pci );

				// Note: If there are any listeners to our 'SubObjectPropChanged' 
				// event, the event will be raised with a new PropChangeInfo
				// event argument whose properties will be set as follows:
				// 1. The Source property will refer to this object.
				// 2. The PropId property will be StatusBarPropertyIds.Appearance.
				// 3. The Trigger property will be the passed in PropChangeInfo.
				//
				// This will effectively create a chain of PropChangeInfo
				// objects, with the new one at the head, that exposes
				// complete context information regarding the change. 
				
				return;
			}

			// There is an overload to the 'NotifyPropChange' method
			// that just takes the passed in PropChangeInfo object.
			// This is useful if you want to pass the notification
			// along to this object's listeners 'as is'. In other words,
			// without creating a new PropChangeInfo to add to the 
			// head of the chain (refer to above comments).
			this.NotifyPropChange( pci );
			
			// The following code walks up the PropChangeInfo chain
			// and writes out the source and property id of each
			// object.
			while ( pci != null )
			{
				System.Text.StringBuilder sb = new System.Text.StringBuilder();
				
				sb.Append("Property Id: ");
				sb.Append(pci.PropId.ToString());
				sb.Append(", source: ");
				sb.Append(pci.Source.ToString());
				sb.Append(". type: ");
				sb.Append(pci.Source.GetType().ToString());

				Debug.WriteLine( sb.ToString() );
				Debug.Indent();

				// Get the next PropChangeInfo object in the chain 
				pci = pci.Trigger;
			}

			// Reset the indent level of the Debug object
			Debug.IndentLevel = 0;

			// Alternatively there are 'Find...' methods that
			// will walk up the chain until they find the 
			// requested PropChangeInfo object to return or
			// they will return null.
			pci = pci.FindPropId( AppearancePropIds.BackGradientStyle );
			pci = pci.FindTrigger( this.appearanceHolder.RootAppearance );

			// There is also a 'FindSource' method which will
			// return the source object based on the passed
			// in type. If no source object of that type is
			// found in the chain this method will return null.
			object source = pci.FindSource( typeof(Infragistics.Win.Appearance ) );

		}

		public bool Enabled
		{

			get { return this.enabled; }

			set
			{
				if (this.enabled != value)
				{
					this.enabled = value;

					// Call the overload to the 'NotifyPropChange' method
					// that just takes a property id. 
					this.NotifyPropChange( StatusBarPropertyIds.Enabled );

					// Note: If there are any listeners to our 'SubObjectPropChanged' 
					// event, the event will be raised with a PropChangeInfo
					// event argument whose properties will be` set as follows:
					// 1. The Source property will refer to this object.
					// 2. The PropId property will be StatusBarPropertyIds.Enabled.
					// 3. The Trigger property will be null.
				}
			}

		}

		public AppearanceBase Appearance
		{

			get
			{
				// Lazily create the appearance holder
				if (this.appearanceHolder == null)
				{
					this.appearanceHolder = new AppearanceHolder();

					// Listen in to property changes generated by the
					// object. When one of its properties changes our 
					// 'OnSubObjectPropChanged' method will be called.
					this.appearanceHolder.SubObjectPropChanged += this.SubObjectPropChangeHandler;
				}
				return this.appearanceHolder.Appearance;
			}

		}

		protected override void OnDispose()
		{

			if ( this.appearanceHolder != null )
			{
				// Remove ourselves as a listener
				this.appearanceHolder.SubObjectPropChanged -= this.SubObjectPropChangeHandler;
			}

		} 

		private void DirtyImage(){} 
		private void DirtyText(){} 
	}

	public enum StatusBarPropertyIds
	{
		Appearance = 1,
		Enabled = 2
	}
}
参照