Расширение функциональности элементов управления Windows с помощью AttachedProperty

в 13:36, , рубрики: attached properties, C#, silverlight, universal apps, windows, windows phone, windows store, wpf, XAML, разработка под windows, разработка под windows phone

Расширение функциональности элементов управления Windows с помощью AttachedProperty - 1

Краеугольным камнем разработки приложений для Windows (WPF, SilverLight, WP, WinRT) является паттерн MVVP. Который основан на концепции связывания данных модели представления и пользовательского интерфейса, что позволяет, используя декларативное описание UI посредством XAML избавится от codebegind (так я и не придумал/нашел русского перевода) и перенести всю логику работы с пользовательским интерфейсом в модель представления.

К сожалению, реализовать все возможные функции в фреймвоках производителю физически невозможно и часто возникает ситуация, когда решить требуемую задачу имеющимися средствами нельзя. Если проблема простая и единовременная, то решается она быстро в месте возникновения, через codebehind представления. Но если одна и та же функциональность нужна в многих местах, необходимо реализовать удобный механизм повторного использования решения.

Написать данную статью меня побудила статья habrahabr.ru/company/edusty/blog/253635/. В статье найдено решение конкретной проблемы и предложено работающее решение. Однако для его использования необходимо в codebehind для каждого текстового блока вызывать код. Более того если данные предполагают изменение в процессе работы необходимо следить за их изменением. В процессе своей работы такие решения встречаю довольно часто, они отличаются реализацией, но их все отличает одно неизменное свойство, сложность поддержки и сопровождения кода.

Для решения подобных задач, необходимо использовать присоединяемые свойства (AttachedProperty), данная технология предоставляет три необходимые для решения задачи возможности:

1) Хранить любое значение в контексте элемента управления для которого оно было задано
2) Уведомлять об изменении данных свойства
3) Использоваться для декларативного связывания в XAML

Решим задачу из приведенного выше примера с помощью присоединяемого свойства, для этого создадим новый статический класс с именем RtbEx и добавим в него описание нового AttachedProperty:

public static readonly DependencyProperty TextProperty = DependencyProperty.RegisterAttached("Text", typeof(string), typeof(RtbEx), new PropertyMetadata(default(string)));
        
public static void SetText(DependencyObject element, string value)
{
    element.SetValue(TextProperty, value);
}

public static string GetText(DependencyObject element)
{
    return (string) element.GetValue(TextProperty);
}

Мы указали для свойства имя Text и тип значения string. Отдельно обращу внимание на методы [Set|Get]Text они добавлены для следования рекомендованному шаблону объявления свойств и предназначены для упрощения доступа к значению свойства. Теперь мы можем использовать это свойство для хранения связанных с элементом управления данных.

var someText = “Some Text”;
RtbEx.SetText(richTextBlock, someText);
someText = RtbEx.GetText(richTextBlock);

Но для реализации дополнительного поведения нам надо при изменении свойства выполнить работу по разбору текста и формированию RTB содержимого, для этого для каждого свойства можно определить обработчик вызываемый каждый раз при изменении значения свойства.
Указать обработчик события необходимо в описании присоединяемого свойства во втором параметре метаданных свойства:

public static readonly DependencyProperty TextProperty = DependencyProperty.RegisterAttached("Text", typeof(string), typeof(RtbEx), new PropertyMetadata(default(string), OnTextChanged));

Обработчик события изменения свойства должен иметь тип PropertyChangedCallback

private static void OnTextChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
{
     var richTextBlock = d as RichTextBlock;
     if (richTextBlock == null)
     {
         return;
     }

     richTextBlock.Blocks.Clear();

     var text = e.NewValue as string;
     if (string.IsNullOrWhiteSpace(text))
     {
         return;
     }

     richTextBlock.Blocks.Add(CreateParagraph(text));
}

Обработчик максимально прост, он определяет, что вызван для RichTextBlock, очищает данные элемента управления и в случае если новое значение свойства не пустая строка, производит заполнение элемента управления новыми данными.

private static Paragraph CreateParagraph(string text)
{
    var paragraph = new Paragraph();

    var splitResult = Regex.Split(text, @"(https?://S+)");
    foreach (var part in splitResult)
    {
        if (part.StartsWith("http", StringComparison.OrdinalIgnoreCase))
        {
            var hyperLink = new Hyperlink {NavigateUri = new Uri(part)};
            hyperLink.Inlines.Add(new Run {Text = part});

            paragraph.Inlines.Add(hyperLink);
            continue;
        }
                    
        paragraph.Inlines.Add(new Run {Text = part});
    }

    return paragraph;
}

Код формирования наполнения RTB не важен в контексте задачи и далек от идеала, он просто делит строку на блоки с ссылками и простым текстом, после чего строит иерархию представления документа RichTextBlock.

Оформленное таким образом расширение можно использовать из XAML с использованием обычных привязок данных, без использования дополнительного кода.

Для этого в документ XAML добавим пространство имен содержащее расширение

xmlns:ex="using:RtbEx.Extensions"

И зададим связывание с помощью обычного {binding}

<RichTextBlock ex:RtbEx.Text="{Binding SomeText}" FontSize="20"/>

Использование присоединяемых свойств ограничено только вашим воображением, используя их можно реализовать множество удобных расширений, которые значительно упростят разработку, повторное использование и поддержку вашего кода.

Код тестового приложения доступен на Github: https://github.com/Viacheslav01/RtbEx

Автор: Viacheslav01

Источник

* - обязательные к заполнению поля


https://ajax.googleapis.com/ajax/libs/jquery/3.4.1/jquery.min.js