UIElement.RenderSize UIElement.RenderSize UIElement.RenderSize UIElement.RenderSize Property

Definición

Obtiene (o establece) el tamaño final de presentación de este elemento.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

Valor de propiedad

Tamaño presentado para este elemento.The rendered size for this element.

Ejemplos

En el ejemplo siguiente se muestra cómo un adorno personalizado usa RenderSize el valor para crear y ajustar el tamaño del gráfico del rectángulo que define el adorno, como parte de OnRender su implementación.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

Comentarios

Importante

No intente establecer esta propiedad, ya sea en XAMLXAML o en el código, si usa el sistema de diseño de nivel de marco de WPF.Do not attempt to set this property, either in XAMLXAML or in code, if using the WPF framework-level layout system. Casi todos los escenarios de aplicación típicos usarán este sistema de diseño.Nearly all typical application scenarios will use this layout system. El sistema de diseño no respetará los tamaños establecidos RenderSize en la propiedad directamente.The layout system will not respect sizes set in the RenderSize property directly. La RenderSize propiedad se declara como grabable solo para habilitar ciertos casos de puente de nivel de núcleo de WPF que eluden deliberadamente los protocolos de diseño típicos Adorner , como la compatibilidad con la clase.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.

Esta propiedad se puede utilizar para comprobar el tamaño de representación aplicable dentro de las invalidaciones del OnRender sistema GetLayoutClipde diseño como o.This property can be used for checking the applicable render size within layout system overrides such as OnRender or GetLayoutClip.

Un escenario más común es controlar el SizeChanged evento con la invalidación del controlador de OnRenderSizeChanged clase o el evento.A more common scenario is handling the SizeChanged event with the class handler override or the OnRenderSizeChanged event.

Se aplica a

Consulte también: