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

정의

이 요소의 최종 렌더링 크기를 가져옵니다(또는 설정합니다).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

속성 값

이 요소의 렌더링된 크기입니다.The rendered size for this element.

예제

다음 예제에서는 사용자 지정 표시기를 사용 하는 방법을 보여 줍니다.는 RenderSize 만들고, 표시기의 일부로 정의 하는 사각형 그래픽의 크기를 조정 하기 위해 값 해당 OnRender 구현 합니다.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

설명

중요

이 속성을 설정 하지 마십시오 XAMLXAML 또는 코드에서 WPF 프레임 워크 수준 레이아웃 시스템을 사용 하는 경우.Do not attempt to set this property, either in XAMLXAML or in code, if using the WPF framework-level layout system. 거의 모든 일반적인 애플리케이션 시나리오는이 레이아웃 시스템을 사용 합니다.Nearly all typical application scenarios will use this layout system. 레이아웃 시스템에서 설정 된 크기를 지키지 됩니다는 RenderSize 속성을 직접.The layout system will not respect sizes set in the RenderSize property directly. RenderSize 속성은 특정 WPF 핵심 수준 의도적으로 일반적인 레이아웃 프로토콜에 대 한 지원 등을 우회 하는 경우 브리지 사용에 쓰기 가능 하 게 선언 된 Adorner 클래스입니다.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.

레이아웃 시스템 내에서 해당 렌더링 크기와 같은 재정의 확인 하는 것에 대 한이 속성을 사용할 수 있습니다 OnRender 또는 GetLayoutClip합니다.This property can be used for checking the applicable render size within layout system overrides such as OnRender or GetLayoutClip.

처리 하는 보다 일반적인 시나리오는 SizeChanged 이벤트 클래스 처리기를 사용 하 여 재정의 또는 OnRenderSizeChanged 이벤트.A more common scenario is handling the SizeChanged event with the class handler override or the OnRenderSizeChanged event.

적용 대상

추가 정보