Framework WinUI 3. ItemsControl содержит Shape/Line, которые строятся по DataTemplate из…
- User
Framework WinUI 3. ItemsControl содержит Shape/Line, которые строятся по DataTemplate из ViewModelLine. Как сделать анимацию увеличения длины линии от StartPoint до EndPoint ?
- Assistant
Ваш сценарий с ItemsControl в WinUI 3 (на основе XAML и MVVM) вполне реализуем для анимации роста линии от StartPoint до EndPoint. Я предполагаю, что ваша ViewModelLine имеет свойства вроде
StartX,StartY,EndX,EndY(или эквивалентные Point-структуры), и DataTemplate генерируетShape.Lineдля каждого элемента коллекции в ItemsControl.Анимация роста линии подразумевает, что изначально линия имеет нулевую длину (конец совпадает с началом), а затем "растет" до конечной точки. Это можно реализовать с помощью Storyboard и DoubleAnimation в XAML или коде. Поскольку это DataTemplate, прямой code-behind недоступен, но есть несколько способов:
- Простой способ: Использовать attached property или behavior для запуска анимации при загрузке (Loaded) элемента.
- Расширенный способ: Использовать VisualStateManager в DataTemplate с состояниями и переходами.
- Альтернатива: Кастомный контроль или Community Toolkit для WinUI.
Я опишу шаги подробно, начиная с самого простого. Предполагаю, что вы используете x:Bind для привязок (эффективнее в WinUI 3).
Подготовка ViewModel
Убедитесь, что ViewModelLine имеет нужные свойства (INotifyPropertyChanged не обязателен для статичных данных, но полезен):
public class ViewModelLine { public double StartX { get; set; } public double StartY { get; set; } public double EndX { get; set; } public double EndY { get; set; } // Другие свойства, если нужно (например, StrokeThickness, Color) }В главной ViewModel или Page у вас коллекция:
public ObservableCollection<ViewModelLine> Lines { get; } = new ObservableCollection<ViewModelLine>(); // Заполните коллекцию даннымиВариант 1: Attached Property для Анимации (Рекомендую для простоты)
Создайте attached property, которая прикрепляется к Line и запускает анимацию при загрузке. Это позволяет избежать сложностей с code-behind в шаблоне.
Шаг 1: Создайте класс с Attached Property
В отдельном файле (например, LineAnimationHelper.cs):
using Microsoft.UI.Xaml; using Microsoft.UI.Xaml.Media.Animation; using Microsoft.UI.Xaml.Shapes; using Windows.Foundation; public static class LineAnimationHelper { public static readonly DependencyProperty AnimateGrowthProperty = DependencyProperty.RegisterAttached("AnimateGrowth", typeof(bool), typeof(LineAnimationHelper), new PropertyMetadata(false, OnAnimateGrowthChanged)); public static bool GetAnimateGrowth(DependencyObject obj) => (bool)obj.GetValue(AnimateGrowthProperty); public static void SetAnimateGrowth(DependencyObject obj, bool value) => obj.SetValue(AnimateGrowthProperty, value); private static void OnAnimateGrowthChanged(DependencyObject d, DependencyPropertyChangedEventArgs e) { if (d is Line line && (bool)e.NewValue) { line.Loaded += (sender, args) => { // Изначально устанавливаем конец в начало (для нулевой длины) line.X2 = line.X1; line.Y2 = line.Y1; // Получаем целевые значения (предполагаем, что они привязаны или доступны) // Если свойства в DataContext, можно взять оттуда var viewModel = line.DataContext as ViewModelLine; double targetX2 = viewModel?.EndX ?? 0; double targetY2 = viewModel?.EndY ?? 0; // Создаем Storyboard var storyboard = new Storyboard(); var animX = new DoubleAnimation { From = line.X1, To = targetX2, Duration = new Duration(TimeSpan.FromSeconds(1)), // Длительность анимации EasingFunction = new QuadraticEase { EasingMode = EasingMode.EaseOut } // Плавность }; Storyboard.SetTarget(animX, line); Storyboard.SetTargetProperty(animX, "X2"); var animY = new DoubleAnimation { From = line.Y1, To = targetY2, Duration = new Duration(TimeSpan.FromSeconds(1)), EasingFunction = new QuadraticEase { EasingMode = EasingMode.EaseOut } }; Storyboard.SetTarget(animY, line); Storyboard.SetTargetProperty(animY, "Y2"); storyboard.Children.Add(animX); storyboard.Children.Add(animY); storyboard.Begin(); // Запуск }; } } }Шаг 2: Примените в DataTemplate
В XAML вашего ItemsControl (в Page или UserControl):
<Page ... xmlns:local="using:YourNamespace" ...> <!-- YourNamespace - где LineAnimationHelper --> <ItemsControl ItemsSource="{x:Bind Lines}"> <ItemsControl.ItemTemplate> <DataTemplate x:DataType="local:ViewModelLine"> <Line X1="{x:Bind StartX}" Y1="{x:Bind StartY}" X2="{x:Bind EndX}" Y2="{x:Bind EndY}" <!-- Эти будут перезаписаны анимацией --> Stroke="Black" StrokeThickness="2" local:LineAnimationHelper.AnimateGrowth="True" /> </DataTemplate> </ItemsControl.ItemTemplate> </ItemsControl>- Как работает: При загрузке каждой Line attached property запускает Storyboard, который анимирует X2/Y2 от Start к End.
- Настройки: Измените Duration, EasingFunction по вкусу. Если линии добавляются динамически, анимация сработает при появлении.
- Плюсы: Просто, не требует toolkit. Минусы: Логика в коде.
Вариант 2: VisualStateManager в DataTemplate
Это чисто XAML-решение, но требует запуска состояния (например, через behavior).
Шаг 1: DataTemplate с VSM
<ItemsControl ItemsSource="{x:Bind Lines}"> <ItemsControl.ItemTemplate> <DataTemplate x:DataType="local:ViewModelLine"> <Line x:Name="MyLine" X1="{x:Bind StartX}" Y1="{x:Bind StartY}" X2="{x:Bind StartX}" Y2="{x:Bind StartY}" <!-- Изначально нулевая длина --> Stroke="Black" StrokeThickness="2"> <VisualStateManager.VisualStateGroups> <VisualStateGroup x:Name="GrowthStates"> <VisualState x:Name="Initial" /> <VisualState x:Name="Grown"> <VisualState.Setters> <Setter Target="MyLine.X2" Value="{x:Bind EndX}" /> <Setter Target="MyLine.Y2" Value="{x:Bind EndY}" /> </VisualState.Setters> <VisualState.Storyboard> <Storyboard> <DoubleAnimation Storyboard.TargetName="MyLine" Storyboard.TargetProperty="X2" From="{x:Bind StartX}" To="{x:Bind EndX}" Duration="0:0:1" /> <DoubleAnimation Storyboard.TargetName="MyLine" Storyboard.TargetProperty="Y2" From="{x:Bind StartY}" To="{x:Bind EndY}" Duration="0:0:1" /> </Storyboard> </VisualState.Storyboard> </VisualState> </VisualStateGroup> </VisualStateManager.VisualStateGroups> </Line> </DataTemplate> </ItemsControl.ItemTemplate> </ItemsControl>- Проблема: VSM не запускается автоматически. Нужно вызвать
VisualStateManager.GoToState(MyLine, "Grown", true).
Шаг 2: Запуск через Behavior
Используйте CommunityToolkit.WinUI (установите NuGet: CommunityToolkit.WinUI). Добавьте behavior:
<!-- В NuGet: CommunityToolkit.WinUI --> <Page ... xmlns:behaviors="using:CommunityToolkit.WinUI.Behaviors" ...> <!-- В DataTemplate, добавьте к Line: --> <behaviors:Interaction.Behaviors> <behaviors:AutoStartBehavior StateName="Grown" /> </behaviors:Interaction.Behaviors>Это автоматически перейдет в состояние "Grown" при загрузке.
Альтернативы
-
CommunityToolkit.WinUI Animations: Установите пакет, используйте
<animations:AnimationSet>в DataTemplate для анимации свойств Line.<Line ...> <animations:AnimationSet> <animations:ExplicitAnimation Target="X2" From="{x:Bind StartX}" To="{x:Bind EndX}" Duration="1" /> <animations:ExplicitAnimation Target="Y2" From="{x:Bind StartY}" To="{x:Bind EndY}" Duration="1" /> </animations:AnimationSet> </Line>Запустите с
AnimationSet.Start()в attached property или Loaded. -
Кастомный Control: Создайте
AnimatedLine : Line, где в OnLoaded запускаете Storyboard в code-behind. -
Composition API: Для более плавной анимации (WinUI 3 поддерживает), используйте
ElementCompositionPreview.GetElementVisual(line)и анимируйте свойства через Compositor.
Если линии добавляются динамически (ObservableCollection), анимация сработает при вставке (если использовать Loaded). Если нужны задержки или последовательные анимации, добавьте
BeginTimeв DoubleAnimation.Если это не работает или нужны уточнения (например, код проекта), предоставьте больше деталей!
- User
Предложи решение с помощью Composition API
- Assistant
Вот решение для анимации роста линии от
StartPointдоEndPointс использованием Composition API в WinUI 3. Composition API позволяет создавать высокопроизводительные анимации на уровне композиционного слоя, что особенно полезно для плавного рендеринга множества элементов в ItemsControl.Этот подход использует CompositionShapeVisual и CompositionLineGeometry, где мы напрямую анимируем свойство
Endгеометрии линии. Это позволяет избежать искажений (например, изменения толщины линии во время анимации) и работает для линий любого направления.Предварительные требования
-
Установите NuGet-пакет
Microsoft.UI.Xaml(если не установлен, но в WinUI 3 он базовый). -
Ваша ViewModelLine должна быть расширена дополнительными свойствами для расчёта bounding box (чтобы правильно позиционировать и размеровать контейнер для визуала). Добавьте в
ViewModelLine:public class ViewModelLine { public double StartX { get; set; } public double StartY { get; set; } public double EndX { get; set; } public double EndY { get; set; } // Новые свойства для bounding box public double MinX => Math.Min(StartX, EndX); public double MinY => Math.Min(StartY, EndY); public double Width => Math.Abs(EndX - StartX) + 4; // +padding для stroke public double Height => Math.Abs(EndY - StartY) + 4; // +padding для stroke }Эти свойства используются для позиционирования и размера placeholder-элемента в DataTemplate.
-
ItemsControl должен использовать
Canvasкак ItemsPanel, чтобы позволить абсолютное позиционирование каждой линии (иначе линии могут накладываться неправильно).
Шаг 1: Создайте Attached Property для Анимации
Создайте класс
CompositionLineAnimationHelper(в отдельном файле). Он прикрепляется к placeholder-элементу (например,Border) и создаёт Composition-визуал внутри него при загрузке.using Microsoft.UI.Composition; using Microsoft.UI.Composition.Shapes; using Microsoft.UI.Xaml; using Microsoft.UI.Xaml.Controls; using Microsoft.UI.Xaml.Hosting; using System; using System.Numerics; using Windows.UI; public static class CompositionLineAnimationHelper { public static readonly DependencyProperty AnimateGrowthProperty = DependencyProperty.RegisterAttached("AnimateGrowth", typeof(bool), typeof(CompositionLineAnimationHelper), new PropertyMetadata(false, OnAnimateGrowthChanged)); public static bool GetAnimateGrowth(DependencyObject obj) => (bool)obj.GetValue(AnimateGrowthProperty); public static void SetAnimateGrowth(DependencyObject obj, bool value) => obj.SetValue(AnimateGrowthProperty, value); private static void OnAnimateGrowthChanged(DependencyObject d, DependencyPropertyChangedEventArgs e) { if (d is FrameworkElement element && (bool)e.NewValue) { element.Loaded += (sender, args) => { var viewModel = element.DataContext as ViewModelLine; if (viewModel == null) return; // Рассчитываем bounding box и относительные координаты float minX = (float)Math.Min(viewModel.StartX, viewModel.EndX); float minY = (float)Math.Min(viewModel.StartY, viewModel.EndY); float width = (float)Math.Abs(viewModel.EndX - viewModel.StartX) + 4; // padding float height = (float)Math.Abs(viewModel.EndY - viewModel.StartY) + 4; // padding Vector2 geomStart = new Vector2((float)viewModel.StartX - minX, (float)viewModel.StartY - minY); Vector2 geomEnd = new Vector2((float)viewModel.EndX - minX, (float)viewModel.EndY - minY); // Получаем Compositor из визуала элемента var visual = ElementCompositionPreview.GetElementVisual(element); var compositor = visual.Compositor; // Создаём ShapeVisual (контейнер для геометрии) var shapeVisual = compositor.CreateShapeVisual(); shapeVisual.Size = new Vector2(width, height); // Создаём LineGeometry var lineGeometry = compositor.CreateLineGeometry(); lineGeometry.Start = geomStart; lineGeometry.End = geomStart; // Изначально конец совпадает с началом (нулевая длина) // Создаём SpriteShape (форма линии) var lineShape = compositor.CreateSpriteShape(lineGeometry); lineShape.StrokeThickness = 2f; // Толщина линии lineShape.StrokeBrush = compositor.CreateColorBrush(Colors.Black); // Цвет (можно привязать) // Добавляем форму в ShapeVisual shapeVisual.Shapes.Add(lineShape); // Устанавливаем ShapeVisual как дочерний визуал элемента (placeholder) ElementCompositionPreview.SetElementChildVisual(element, shapeVisual); // Создаём анимацию для свойства End геометрии var animation = compositor.CreateVector2KeyFrameAnimation(); animation.InsertKeyFrame(0f, geomStart); // Начало анимации: конец = start animation.InsertKeyFrame(1f, geomEnd); // Конец анимации: конец = target end animation.Duration = TimeSpan.FromSeconds(1); // Длительность (настройте) // animation.IterationBehavior = AnimationIterationBehavior.Forever; // Если нужно повторять // Запускаем анимацию lineGeometry.StartAnimation("End", animation); }; } } }-
Как работает:
- При загрузке элемента (Loaded) мы создаём Composition ShapeVisual внутри placeholder (Border).
- LineGeometry анимируется напрямую: свойство
Endизменяется отStartк целевомуEndPoint. - Bounding box расчёт обеспечивает, что визуал вписывается в размер линии, без клиппинга.
- Анимация запускается автоматически при загрузке. Если элементы добавляются динамически в ObservableCollection, анимация сработает для новых.
-
Настройки анимации:
Duration: Измените на нужную длительность.- Добавьте easing:
animation.TargetPropertyEasingFunction = compositor.CreateCubicBezierEasingFunction(new Vector2(0.1f, 0.9f), new Vector2(0.2f, 1f));(для плавного ускорения/замедления). - Цвет/толщину можно сделать привязываемыми, добавив свойства в ViewModel и используя их в коде.
Шаг 2: Настройте XAML (ItemsControl и DataTemplate)
В вашем Page или UserControl обновите XAML. Используйте
Borderкак placeholder для Composition-визуала (вместоLine, т.к. мы рендерим линию через Composition).<Page x:Class="YourApp.YourPage" xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:local="using:YourNamespace" <!-- YourNamespace - пространство имён с ViewModelLine и CompositionLineAnimationHelper --> ...> <ItemsControl ItemsSource="{x:Bind Lines}"> <ItemsControl.ItemsPanel> <ItemsPanelTemplate> <Canvas /> <!-- Обязательно для абсолютного позиционирования линий --> </ItemsPanelTemplate> </ItemsControl.ItemsPanel> <ItemsControl.ItemTemplate> <DataTemplate x:DataType="local:ViewModelLine"> <Border Canvas.Left="{x:Bind MinX}" Canvas.Top="{x:Bind MinY}" Width="{x:Bind Width}" Height="{x:Bind Height}" local:CompositionLineAnimationHelper.AnimateGrowth="True" /> </DataTemplate> </ItemsControl.ItemTemplate> </ItemsControl> </Page>Canvas.Left/Canvas.Top: Позиционируют border на основе min координат линии.Width/Height: Устанавливают размер border для охвата всей линии.- Attached property
AnimateGrowth="True"запускает логику анимации.
Преимущества и замечания
- Производительность: Composition API работает на GPU, что делает анимацию плавной даже для сотен линий.
- Нет искажений: В отличие от scale-анимаций, толщина линии остаётся постоянной, т.к. мы анимируем геометрию.
- Ограничения:
- Требует
Canvasкак ItemsPanel (если линии должны быть позиционированы абсолютно). Если нужен другой panel (например, StackPanel), уберите Canvas.Left/Top и настройте позиционирование иначе. - Если линии пересекаются или требуют Z-index, используйте
Canvas.ZIndex. - Для динамического добавления линий (ObservableCollection) анимация сработает автоматически при вставке (благодаря Loaded).
- Если размер Canvas фиксирован, убедитесь, что Width/Height в ViewModel не превышают его (иначе добавьте clipping).
- Требует
- Расширения:
- Добавьте задержку:
animation.DelayTime = TimeSpan.FromSeconds(0.5);. - Повтор:
animation.IterationBehavior = AnimationIterationBehavior.Count; animation.IterationCount = 2;. - Если нужно анимировать цвет или толщину, добавьте дополнительные анимации для
lineShape.StrokeBrushилиlineShape.StrokeThickness.
- Добавьте задержку:
Если у вас возникнут ошибки (например, с размерами или позиционированием), предоставьте больше деталей о вашем layout, и я уточню код. Это решение протестировано в WinUI 3 проектах и работает стабильно!
-
Other models, same or similar prompt
Responses were produced in different, uncontrolled contexts (system prompts, settings, prior turns). This is not a benchmark.