Язык программирования C#9 и платформа .NET5

    new UIPropertyMetadata(100),

    new ValidateValueCallback(ValidateCurrentNumber));

// Простое бизнес-правило: значение должно находиться

// в диапазоне между 0 и 500.

public static bool ValidateCurrentNumber(object value) =>

  Convert.ToInt32(value) >= 0 && Convert.ToInt32(value) <= 500;

Реагирование на изменение свойства

Итак, допустимое число уже есть, но анимация по-прежнему отсутствует. Последнее изменение, которое потребуется внести — передать во втором аргументе конструктора UIPropertyMrtadata объект PropertyChangedCallback. Данный делегат может указывать на любой метод, принимающий DependencyObject в первом параметре и DependencyPropertyChangeEventArgs во втором. Модифицируйте код следующим образом:

// Обратите внимание на второй параметр конструктора UIPropertyMetadata.

public static readonly DependencyProperty CurrentNumberProperty =

  DependencyProperty.Register("CurrentNumber", typeof(int),

    typeof(ShowNumberControl),

  new UIPropertyMetadata(100,

  new PropertyChangedCallback(CurrentNumberChanged)),

  new ValidateValueCallback(ValidateCurrentNumber));

Конечной целью внутри метода CurrentNumberChamged будет изменение свойства Content объекта Label на новое значение, присвоенное свойству CurrentNumber. Однако возникает серьезная проблема:метод CurrentNumberChanged является статическим, т.к. он должен работать со статическим объектом DependencyProperty. Как тогда получить доступ к объекту Label для текущего экземпляра ShowNumberControl? Нужная ссылка содержится в первом параметре DependencyObject. Новое значение можно найти с применением входных аргументов события. Ниже показан необходимый код, который будет изменять свойство Content объекта Label:

private static void CurrentNumberChanged(DependencyObject depObj,   

DependencyPropertyChangedEventArgs args)

{

  // Привести DependencyObject к ShowNumberControl.

  ShowNumberControl c = (ShowNumberControl)depObj;

  // Получить элемент управления Label в ShowNumberControl.

  Label theLabel = c.numberDisplay;

  // Установить для Label новое значение.

  theLabel.Content = args.NewValue.ToString;

}

Видите, насколько долгий путь пришлось пройти, чтобы всего лишь изменить содержимое метки! Преимущество заключается в том, что теперь свойство зависимости CurrentNumber может быть целью для стиля WPF, объекта анимации, операции привязки данных и т.д. Снова запустив приложение, вы легко заметите, что значение изменяется во время выполнения.

На этом обзор свойств зависимости WPF завершен. Хотя теперь вы должны гораздо лучше понимать, что они позволяют делать, и как создавать собственные свойства подобного рода, имейте в виду, что многие детали здесь не были раскрыты.

Если вам однажды понадобится создавать множество собственных элементов управления, поддерживающих специальные свойства, тогда загляните в подраздел "Properties" ("Свойства") раздела "Systems" ("Системы") документации по WPF (https://docs.microsoft.com/ru-ru/dotnet/desktop/wpf/).Там вы найдете намного больше примеров построения свойств зависимости, присоединяемых свойств, разнообразных способов конфигурирования метаданных и массу других подробных сведений.

Резюме

В главе рассматривались некоторые аспекты элементов управления WPF, начиная с обзора набора инструментов для элементов управления и роли диспетчеров компоновки (панелей). Первый пример был посвящен построению простого приложения текстового процессора. В нем демонстрировалось использование интегрированной в WPF функциональности проверки правописания, а также создание главного окна с системой меню, строкой состояния и панелью инструментов.