UIElement.Clip Propriedade

Definição

Obtém ou define o RectangleGeometry usado para definir a estrutura de tópicos do conteúdo de um UIElement.

C#
public RectangleGeometry Clip { get; set; }
XAML
<uiElement>
  <uiElement.Clip>
    rectangleGeometry
  </uiElement.Clip>
</uiElement>

Valor da propriedade

A geometria do retângulo a ser usada para dimensionamento de área de recorte. O valor padrão é null (sem recorte).

Exemplos

Este exemplo é uma marcação XAML simples que especifica um Clip usando um RectangleGeometry embutido que especifica suas dimensões por meio de uma sintaxe de atributo.

XAML
<Canvas>
    <Image Source="Images/Water_lilies.jpg" Width="200" Height="150">
        <Image.Clip>
            <RectangleGeometry Rect="100 75 50 50"/>
        </Image.Clip>
    </Image>
</Canvas>

Comentários

A geometria de recorte para UIElement.Clip na API de Windows Runtime deve ser um RectangleGeometry. Você não pode especificar uma geometria não retangular.

A área recortada é o lado de fora da geometria. Em outras palavras, o conteúdo mostrado (não recortado) é a área do retângulo que é desenhado com Fill se a geometria foi usada como dados para um Caminho em vez de para recorte. A área recortada é qualquer área que cai fora do retângulo. A área recortada não é testável por clique.

Aplica-se a

Produto Versões
Windows App SDK 0.8, 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6