UIElement.RenderSize Propriedade

Definição

Namespace:

System.Windows

Assembly:

PresentationCore.dll

Obtém (ou define) o tamanho de renderização final deste elemento.

C#

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

Valor da propriedade

Size

O tamanho renderizado para este elemento.

Exemplos

O exemplo a seguir mostra como um adorno personalizado usa o RenderSize valor para criar e dimensionar o gráfico do retângulo que define o adorno, como parte de sua OnRender implementação.

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);
}

Comentários

Importante

Não tente definir essa propriedade, seja em XAML ou em código, se estiver usando o sistema de layout no nível da estrutura do WPF. Quase todos os cenários típicos de aplicativos usarão esse sistema de layout. O sistema de layout não respeitará os tamanhos definidos na RenderSize propriedade diretamente. A RenderSize propriedade é declarada gravável apenas para habilitar determinados casos de ponte de nível de núcleo do WPF que deliberadamente contornam os protocolos de layout típicos, como suporte para a Adorner classe .

Essa propriedade pode ser usada para verificar o tamanho de renderização aplicável em substituições do sistema de layout, como OnRender ou GetLayoutClip.

Um cenário mais comum é lidar com o SizeChanged evento com a substituição do manipulador de classe ou o OnRenderSizeChanged evento .

Aplica-se a

Confira também

• UpdateLayout()