FrameworkElement.OnPropertyChanged(DependencyPropertyChangedEventArgs) FrameworkElement.OnPropertyChanged(DependencyPropertyChangedEventArgs) FrameworkElement.OnPropertyChanged(DependencyPropertyChangedEventArgs) FrameworkElement.OnPropertyChanged(DependencyPropertyChangedEventArgs) Method

定義

この FrameworkElement の依存関係プロパティの有効値が更新された場合に必ず呼び出されます。Invoked whenever the effective value of any dependency property on this FrameworkElement has been updated. 変更が発生した特定の依存関係プロパティが引数パラメーターで報告されます。The specific dependency property that changed is reported in the arguments parameter. OnPropertyChanged(DependencyPropertyChangedEventArgs) をオーバーライドします。Overrides OnPropertyChanged(DependencyPropertyChangedEventArgs).

protected:
 override void OnPropertyChanged(System::Windows::DependencyPropertyChangedEventArgs e);
protected override void OnPropertyChanged (System.Windows.DependencyPropertyChangedEventArgs e);
override this.OnPropertyChanged : System.Windows.DependencyPropertyChangedEventArgs -> unit
Protected Overrides Sub OnPropertyChanged (e As DependencyPropertyChangedEventArgs)

パラメーター

e
DependencyPropertyChangedEventArgs DependencyPropertyChangedEventArgs DependencyPropertyChangedEventArgs DependencyPropertyChangedEventArgs

変更されたプロパティと、新旧の値を記述するイベント データ。The event data that describes the property that changed, as well as old and new values.

注釈

このメソッドは、一般的にプロパティの変更または無効化を検出するものではありません。This method is not intended to generally detect property changes or invalidations. 代わりにものでは、無効化の一般的なパターンを変更するためのプロパティの広範な分類について特定の情報がわかっている場合。It is instead intended for modifications of the general invalidation pattern if certain information is known about wide classifications of properties.

このメソッドでは、オブジェクトの有効期間中に何度もを呼び出す可能性があります。This method is potentially invoked many times during the life of an object. 固有のプロパティのメタデータをオーバーライドし、適用する場合、パフォーマンスが向上を実現するそのため、CoerceValueCallbackまたはPropertyChangedCallback個々 のプロパティ。Therefore, you can achieve better performance if you override the metadata of specific properties and then attach CoerceValueCallback or PropertyChangedCallback functions for individual properties. 場合にこのメソッドを使用すると、FrameworkElement多数値と相互に依存関係プロパティにはが含まれています動作をレンダリングする必要がありますを再実行するいくつかの関連プロパティの無効化のケースのようにロジックが含まれている場合またはします。However, you would use this method if a FrameworkElement includes a significant number of value-interrelated dependency properties, or if it includes logic such as rendering behavior that must be rerun for several related cases of property invalidations.

同じ名前に注意してください。OnPropertyChanged異なるシグネチャを持つメソッド (パラメーターの型がPropertyChangedEventArgs) クラスの数で表示されることができます。Note that there is an identically named OnPropertyChanged method with a different signature (the parameter type is PropertyChangedEventArgs) that can appear on a number of classes. あるOnPropertyChangedのコントラクトの一部であり、データ オブジェクトの通知に使用INotifyPropertyChangedします。That OnPropertyChanged is used for data object notifications, and is part of the contract for INotifyPropertyChanged.

注意 (継承者)

常に、実装の最初の操作として基本の実装を呼び出します。Always call the base implementation, as the first operation in your implementation. これに失敗には、全体が無効になりますが大幅にWPFWPFプロパティ システムは、不適切な値を報告するために発生します。Failure to do this will significantly disable the entire WPFWPF property system, which causes incorrect values to be reported. 特定FrameworkElement実装はさまざまな表示されるユーザー インターフェイスに影響を与えるプロパティの適切な状態を維持することもできます。The specific FrameworkElement implementation is also responsible for maintaining proper state for a variety of properties that affect the visible user interface. 適切なタイミングでスタイルを設定する変更に基づいて、ビジュアル ツリーを無効化が含まれます。These include invalidating the visual tree based on changes to style at appropriate times.

適用対象

こちらもご覧ください