Aller au contenu

Dessin personnalisé

Surchargez Render et dessinez avec le DrawingContext.

Le repère de dessin

(0,0) X Y Rect(80,40,80,40) Bounds.Width Bounds.Height

(0,0) est le coin haut-gauche du contrôle (pas de la fenêtre). Y augmente vers le bas.

Un contrôle dessiné

Aperçu · la Jauge suit le Slider
using Avalonia;
using Avalonia.Controls;
using Avalonia.Media;

public class Jauge : Control
{
    public static readonly StyledProperty<double> ValeurProperty =
        AvaloniaProperty.Register<Jauge, double>(nameof(Valeur));

    public static readonly StyledProperty<IBrush?> RemplissageProperty =
        AvaloniaProperty.Register<Jauge, IBrush?>(nameof(Remplissage), Brushes.MediumPurple);

    public double Valeur { get => GetValue(ValeurProperty); set => SetValue(ValeurProperty, value); }
    public IBrush? Remplissage { get => GetValue(RemplissageProperty); set => SetValue(RemplissageProperty, value); }

    static Jauge() => AffectsRender<Jauge>(ValeurProperty, RemplissageProperty);

    public override void Render(DrawingContext context)
    {
        var zone = new Rect(Bounds.Size);
        var rempli = zone.WithWidth(zone.Width * Math.Clamp(Valeur, 0, 1));

        context.DrawRectangle(Brushes.LightGray, null, zone, 6, 6);
        context.DrawRectangle(Remplissage, null, rempli, 6, 6);
    }
}
<local:Jauge Valeur="0.65" Height="12" Remplissage="#10B981" />
<local:Jauge Valeur="{Binding #Curseur.Value}" Height="12" />
<Slider x:Name="Curseur" Minimum="0" Maximum="1" />

Les primitives

Aperçu · le code ci-dessous
public override void Render(DrawingContext ctx)
{
    var stylo = new Pen(Brushes.Black, 2);
    var pointille = new Pen(Brushes.Gray, 1, dashStyle: DashStyle.Dash);

    ctx.DrawLine(stylo, new Point(0, 0), new Point(100, 50));
    ctx.DrawRectangle(Brushes.Orange, stylo, new Rect(10, 10, 80, 40));
    ctx.DrawRectangle(Brushes.Teal, null, new Rect(10, 60, 80, 40), radiusX: 8, radiusY: 8);
    ctx.DrawEllipse(Brushes.Purple, pointille, new Point(150, 50), 30, 30);

    var geometrie = Geometry.Parse("M 200,80 L 230,20 L 260,80 Z");
    ctx.DrawGeometry(Brushes.Gold, stylo, geometrie);
}

Texte

var texte = new FormattedText(
    "42 %",
    CultureInfo.CurrentCulture,
    FlowDirection.LeftToRight,
    new Typeface("Inter", FontStyle.Normal, FontWeight.Bold),
    18,
    Brushes.Black);

var centre = new Point((Bounds.Width - texte.Width) / 2, (Bounds.Height - texte.Height) / 2);
ctx.DrawText(texte, centre);

Transformations et opacité

using (ctx.PushTransform(Matrix.CreateRotation(Math.PI / 8)))
using (ctx.PushOpacity(0.5))
{
    ctx.DrawRectangle(Brushes.Red, null, new Rect(40, 0, 60, 60));
}

using (ctx.PushClip(new Rect(Bounds.Size)))
{
    // rien ne dépasse du contrôle
}

Graphique en courbe

Aperçu · Points = [3, 7, 4, 9, 6, 11, 8]
public class Courbe : Control
{
    public static readonly StyledProperty<IReadOnlyList<double>?> PointsProperty =
        AvaloniaProperty.Register<Courbe, IReadOnlyList<double>?>(nameof(Points));

    public IReadOnlyList<double>? Points { get => GetValue(PointsProperty); set => SetValue(PointsProperty, value); }

    static Courbe() => AffectsRender<Courbe>(PointsProperty);

    public override void Render(DrawingContext ctx)
    {
        if (Points is not { Count: > 1 } pts) return;

        var max = pts.Max();
        var pasX = Bounds.Width / (pts.Count - 1);

        var geo = new StreamGeometry();
        using (var g = geo.Open())
        {
            g.BeginFigure(new Point(0, Bounds.Height - pts[0] / max * Bounds.Height), false);
            for (var i = 1; i < pts.Count; i++)
                g.LineTo(new Point(i * pasX, Bounds.Height - pts[i] / max * Bounds.Height));
            g.EndFigure(false);
        }

        ctx.DrawGeometry(null, new Pen(Brushes.MediumPurple, 2, lineCap: PenLineCap.Round), geo);
    }
}
<local:Courbe Points="{Binding Ventes}" Height="120" />

Taille souhaitée

Sans Width/Height, un Control vide mesure 0. Indiquez une taille naturelle :

protected override Size MeasureOverride(Size disponible)
    => new(Math.Min(disponible.Width, 200), 24);

Réagir à la souris

protected override void OnPointerPressed(PointerPressedEventArgs e)
{
    base.OnPointerPressed(e);
    var x = e.GetPosition(this).X;
    Valeur = Math.Clamp(x / Bounds.Width, 0, 1);
}

Un Control ne reçoit les clics que là où il dessine. Pour capter les clics sur toute sa surface, dessinez un fond transparent au début de Render :

ctx.FillRectangle(Brushes.Transparent, new Rect(Bounds.Size));

Animation image par image

flowchart LR
  R["RequestAnimationFrame(t)"] --> C["calculer l'état<br/>selon le temps t"]
  C --> I["InvalidateVisual()"]
  I --> D["Render() dessine"]
  D --> R
Aperçu · position = sin(temps)
public class Particules : Control
{
    private TimeSpan? _debut;

    protected override void OnAttachedToVisualTree(VisualTreeAttachmentEventArgs e)
    {
        base.OnAttachedToVisualTree(e);
        DemanderImage();
    }

    private void DemanderImage()
        => TopLevel.GetTopLevel(this)?.RequestAnimationFrame(t =>
        {
            _debut ??= t;
            _temps = (t - _debut.Value).TotalSeconds;
            InvalidateVisual();
            if (this.IsAttachedToVisualTree()) DemanderImage();
        });

    private double _temps;

    public override void Render(DrawingContext ctx)
    {
        var x = (Math.Sin(_temps * 2) + 1) / 2 * Bounds.Width;
        ctx.DrawEllipse(Brushes.MediumPurple, null, new Point(x, Bounds.Height / 2), 10, 10);
    }
}

Tip

Pour des milliers d'éléments ou des effets GPU, regardez la Composition API (ElementComposition.GetElementVisual) ou un CompositionCustomVisual.