Dessin personnalisé¶
Surchargez Render et dessinez avec le DrawingContext.
Le repère de dessin¶
(0,0) est le coin haut-gauche du contrôle (pas de la fenêtre). Y augmente vers le bas.
Un contrôle dessiné¶
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¶
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¶
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);
}
}
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 :
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
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.