FrameworkElement.OnPropertyChanged(DependencyPropertyChangedEventArgs) メソッド

定義

名前空間:
System.Windows
アセンブリ:
PresentationFramework.dll

この FrameworkElement の依存関係プロパティの有効な値が更新されるたびに呼び出されます。 変更された特定の依存関係プロパティは、引数パラメーターで報告されます。 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

変更されたプロパティと、古い値と新しい値を記述するイベント データ。

注釈

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

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

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

注意 (継承者)

実装の最初の操作として、常に基本実装を呼び出します。 これを行わないと、WPF プロパティ システム全体が大幅に無効になり、正しくない値が報告されます。 また、特定の FrameworkElement 実装は、表示されるユーザー インターフェイスに影響を与えるさまざまなプロパティの適切な状態を維持する役割も担います。 これには、適切な時期にスタイルの変更に基づいてビジュアル ツリーを無効にすることが含まれます。

適用対象

こちらもご覧ください