Lire en anglais

Partager via


UIElement.RenderSize Propriété

Définition

Obtient (ou définit) la taille de rendu finale de cet élément.

C#
public System.Windows.Size RenderSize { get; set; }

Valeur de propriété

Taille de rendu de cet élément.

Exemples

L’exemple suivant montre comment un ornement personnalisé utilise la RenderSize valeur pour créer et dimensionner le graphique rectangle qui définit l’ornement, dans le cadre de son OnRender implémentation.

C#
protected override void OnRender(DrawingContext drawingContext)
{
  // Get a rectangle that represents the desired size of the rendered element
  // after the rendering pass.  This will be used to draw at the corners of the 
  // adorned element.
  Rect adornedElementRect = new Rect(this.AdornedElement.RenderSize);

  // Some arbitrary drawing implements.
  SolidColorBrush renderBrush = new SolidColorBrush(Colors.Green);
  renderBrush.Opacity = 0.2;
  Pen renderPen = new Pen(new SolidColorBrush(Colors.Navy), 1.5);
  double renderRadius = 5.0;

  // Just draw a circle at each corner.
  drawingContext.DrawEllipse(renderBrush, renderPen, adornedElementRect.TopLeft, renderRadius, renderRadius);
  drawingContext.DrawEllipse(renderBrush, renderPen, adornedElementRect.TopRight, renderRadius, renderRadius);
  drawingContext.DrawEllipse(renderBrush, renderPen, adornedElementRect.BottomLeft, renderRadius, renderRadius);
  drawingContext.DrawEllipse(renderBrush, renderPen, adornedElementRect.BottomRight, renderRadius, renderRadius);
}

Remarques

Important

N’essayez pas de définir cette propriété, en XAML ou en code, si vous utilisez le système de disposition au niveau de l’infrastructure WPF. Presque tous les scénarios d’application classiques utilisent ce système de disposition. Le système de disposition ne respecte pas directement les tailles définies dans la RenderSize propriété. La RenderSize propriété est déclarée accessible en écriture uniquement pour activer certains cas de pontage au niveau du cœur WPF qui contournent délibérément les protocoles de disposition classiques, tels que la prise en charge de la Adorner classe.

Cette propriété peut être utilisée pour vérifier la taille de rendu applicable dans les remplacements de système de disposition tels que OnRender ou GetLayoutClip.

Un scénario plus courant consiste à gérer l’événement SizeChanged avec le remplacement du gestionnaire de classes ou l’événement OnRenderSizeChanged .

S’applique à

Produit Versions
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10

Voir aussi