UIElement.RenderSize Propriété

Définition

Obtient (ou définit) la taille de rendu finale de cet élément.Gets (or sets) the final render size of this element.

public:
 property System::Windows::Size RenderSize { System::Windows::Size get(); void set(System::Windows::Size value); };
public System.Windows.Size RenderSize { get; set; }
member this.RenderSize : System.Windows.Size with get, set
Public Property RenderSize As Size

Valeur de propriété

Size

Taille de rendu de cet élément.The rendered size for this element.

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.The following example shows how a custom adorner uses the RenderSize value in order to create and size the rectangle graphic that defines the adorner, as part of its OnRender implementation.

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);
}
Protected Overrides Sub OnRender(ByVal drawingContext As 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.
  Dim adornedElementRect As New Rect(Me.AdornedElement.RenderSize)

  ' Some arbitrary drawing implements.
  Dim renderBrush As New SolidColorBrush(Colors.Green)
  renderBrush.Opacity = 0.2
  Dim renderPen As New Pen(New SolidColorBrush(Colors.Navy), 1.5)
  Dim renderRadius As Double = 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)
End Sub

Remarques

Important

N’essayez pas de définir cette propriété, en XAML ou dans le code, si vous utilisez le système de disposition au niveau de l’infrastructure WPF.Do not attempt to set this property, either in XAML or in code, if using the WPF framework-level layout system. Presque tous les scénarios d’application classiques utiliseront ce système de disposition.Nearly all typical application scenarios will use this layout system. Le système de disposition ne respecte pas directement les tailles définies dans la RenderSize propriété.The layout system will not respect sizes set in the RenderSize property directly. La RenderSize propriété est déclarée accessible en écriture uniquement pour permettre certains cas de pontage au niveau du noyau WPF qui contournent délibérément les protocoles de disposition typiques, tels que la prise en charge de la Adorner classe.The RenderSize property is declared writable only to enable certain WPF core-level bridging cases that deliberately circumvent the typical layout protocols, such as support for the Adorner class.

Cette propriété peut être utilisée pour vérifier la taille de rendu applicable dans les substitutions de système de disposition, telles que OnRender ou GetLayoutClip .This property can be used for checking the applicable render size within layout system overrides such as OnRender or GetLayoutClip.

Un scénario plus courant consiste à gérer l' SizeChanged événement avec le remplacement du gestionnaire de classe ou l' OnRenderSizeChanged événement.A more common scenario is handling the SizeChanged event with the class handler override or the OnRenderSizeChanged event.

S’applique à

Voir aussi