UIElement.RenderSize 属性

定义

命名空间:

System.Windows

程序集:

PresentationCore.dll

获取（或设置）此元素的最终呈现大小。

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

属性值

Size

此元素的呈现大小。

示例

以下示例演示自定义装饰器 RenderSize 如何使用 值来创建定义装饰器并调整其实现的 OnRender 矩形图形的大小。

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

注解

重要

如果使用 WPF 框架级布局系统，请不要尝试在 XAML 或代码中设置此属性。 几乎所有典型的应用程序方案都将使用此布局系统。 布局系统不会直接遵循 属性中 RenderSize 设置的大小。 声明 RenderSize 属性是可写的，只是为了启用某些 WPF 核心级桥接案例，这些情况故意绕过典型的布局协议，例如对 类的支持 Adorner 。

此属性可用于检查布局系统替代（如 或 GetLayoutClip）OnRender内的适用呈现大小。

更常见的方案是使用类处理程序重写或 OnRenderSizeChanged 事件处理 SizeChanged 事件。

另请参阅

• UpdateLayout()