Udostępnij za pośrednictwem


FrameworkElement.OnPropertyChanged(DependencyPropertyChangedEventArgs) Metoda

Definicja

Wywoływane za każdym razem, gdy zostanie zaktualizowana efektywna wartość dowolnej właściwości FrameworkElement zależności. Określona właściwość zależności, która uległa zmianie, jest zgłaszana w parametrze argumentów. Zastępuje metodę 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)

Parametry

e
DependencyPropertyChangedEventArgs

Dane zdarzenia opisujące zmienioną właściwość, a także stare i nowe wartości.

Uwagi

Ta metoda nie jest przeznaczona do wykrywania zmian lub unieważnień właściwości. Zamiast tego jest przeznaczony do modyfikacji ogólnego wzorca unieważniania, jeśli niektóre informacje są znane z szerokiej klasyfikacji właściwości.

Ta metoda jest potencjalnie wywoływana wiele razy w okresie życia obiektu. W związku z tym można osiągnąć lepszą wydajność, jeśli zastąpisz metadane określonych właściwości, a następnie dołącz lub CoerceValueCallbackPropertyChangedCallback funkcje dla poszczególnych właściwości. Można jednak użyć tej metody, jeśli element FrameworkElement zawiera znaczną liczbę właściwości zależności powiązanych z wartością lub jeśli zawiera logikę, taką jak zachowanie renderowania, które należy ponownie uruchomić w przypadku kilku powiązanych przypadków unieważnienia właściwości.

Należy pamiętać, że istnieje identycznie nazwana OnPropertyChanged metoda z innym podpisem (typ parametru to PropertyChangedEventArgs), który może występować w wielu klasach. Jest to OnPropertyChanged używane na potrzeby powiadomień dotyczących obiektów danych i jest częścią kontraktu dla elementu INotifyPropertyChanged.

Uwagi dotyczące dziedziczenia

Zawsze należy wywołać implementację podstawową jako pierwszą operację w implementacji. Nie można tego zrobić spowoduje znaczne wyłączenie całego systemu właściwości WPF, co powoduje zgłaszanie nieprawidłowych wartości. FrameworkElement Konkretna implementacja jest również odpowiedzialna za utrzymanie odpowiedniego stanu dla różnych właściwości, które mają wpływ na widoczny interfejs użytkownika. Obejmują one unieważnienie drzewa wizualnego na podstawie zmian stylu w odpowiednim czasie.

Dotyczy

Zobacz też