FrameworkContentElement.OnPropertyChanged メソッド

定義

この FrameworkContentElement の依存関係プロパティの有効値が更新された場合に必ず呼び出されます。 変更が発生した特定の依存関係プロパティが引数パラメーターで報告されます。 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

変更されたプロパティ (古い値と新しい値を含む) を示すイベント データ。

注釈

このメソッドは、一般的にプロパティの変更や無効化を検出するためのものではありません。 代わりに、プロパティの広範な分類に関する特定の情報がわかっていれば、一般的な無効化パターンを変更することを目的としています。

このメソッドは、オブジェクトの有効期間中に何度も呼び出される可能性があります。 したがって、特定のプロパティのメタデータをオーバーライドし、個々のプロパティに対してアタッチまたはPropertyChangedCallback関数をアタッチCoerceValueCallbackすると、パフォーマンスを向上させることができます。 ただし、値と相互に関連する依存関係プロパティの数が多い場合 FrameworkContentElement や、プロパティの無効化のいくつかの関連するケースで再実行する必要があるレンダリング動作などのロジックが含まれている場合は、このメソッドを使用します。

異なるシグネチャ (パラメーター型) を持つ同じ名前 OnPropertyChanged のメソッドがあり、 PropertyChangedEventArgs多数のクラスで使用できることに注意してください。 これは OnPropertyChanged データ オブジェクト通知に使用され INotifyPropertyChanged、.

注意 (継承者)

実装の最初の操作として、常に基本実装を呼び出します。 これを行わないと、WPF プロパティ システム全体が大幅に無効になり、正しくない値が報告されます。

適用対象

こちらもご覧ください