FrameworkElement.UseLayoutRounding Propriedade

public:
 property bool UseLayoutRounding { bool get(); void set(bool value); };

public bool UseLayoutRounding { get; set; }

member this.UseLayoutRounding : bool with get, set

Public Property UseLayoutRounding As Boolean

Valor de Propriedade

true se for aplicado arredondamento de layout; caso contrário, false. A predefinição é false.

Exemplos

O exemplo seguinte demonstra o efeito que a UseLayoutRounding propriedade tem numa única linha de largura de píxel. A linha da esquerda não usa arredondamento de layout e a linha da direita usa arredondamento de layout. Se fores redimensionando lentamente a janela, podes ver a diferença que o arredondamento do layout faz.

<Page x:Class="LayoutRounding.Lines"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    Title="Lines" Name="linesPage"
    >
  <StackPanel Width="150"  Margin="7" Orientation="Horizontal">
    <!-- Single pixel line with layout rounding turned OFF.-->
    <Rectangle UseLayoutRounding="False"
       Width="45.5" Margin="10" Height="1" Fill="Red"/>
    <!-- Single pixel line with layout rounding turned ON.-->
    <Rectangle UseLayoutRounding="True"
      Width="45.5" Margin="10" Height="1" Fill="Red"/>
  </StackPanel>
  <!-- Background Grid -->
  <Page.Background>
    <DrawingBrush  Viewport="0,0,10,10" ViewportUnits="Absolute" TileMode="Tile">
      <DrawingBrush.Drawing>
        <DrawingGroup>
          <GeometryDrawing Brush="White">
            <GeometryDrawing.Geometry>
              <RectangleGeometry Rect="0,0,1,1" />
            </GeometryDrawing.Geometry>
          </GeometryDrawing>
          <GeometryDrawing Geometry="M0,0 L1,0 1,0.1, 0,0.1Z " Brush="#CCCCFF" />
          <GeometryDrawing Geometry="M0,0 L0,1 0.1,1, 0.1,0Z" Brush="#CCCCFF" />
        </DrawingGroup>
      </DrawingBrush.Drawing>
    </DrawingBrush>
  </Page.Background>
</Page>

Observações

Quando a UseLayoutRounding propriedade de um elemento é true, todos os valores de píxeis não inteiros que são calculados durante as passagens Measure e Arrange são arredondados para valores inteiros de píxeis.

Esta propriedade é herdada pelos elementos filhos.

Desenhar objetos nas fronteiras dos píxeis elimina as arestas semi-transparentes produzidas pelo anti-aliasing, quando uma aresta cai no meio do pixel do dispositivo. A ilustração seguinte mostra a saída de uma única linha de largura de píxel que cai no meio de um pixel do dispositivo. A linha à esquerda não utiliza arredondamento de layout e é anti-aliasing. A linha à direita utiliza arredondamento de layout.

Quando utiliza arredondamento e Star dimensionamento de layout, o sistema de layout cria pequenas variações nas medições das colunas ou linhas para evitar a renderização de subpíxeis. Por exemplo, se uma grelha tem uma largura total de 100 com 3 colunas cada de tamanho Star, em vez de criar três colunas com largura igual a 33,3, o sistema de layout cria 2 colunas com largura 33 e outra com largura 34.