UIElement.Clip Propriedade

Definição

Namespace:

Windows.UI.Xaml

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

public:
 property RectangleGeometry ^ Clip { RectangleGeometry ^ get(); void set(RectangleGeometry ^ value); };

RectangleGeometry Clip();

void Clip(RectangleGeometry value);

public RectangleGeometry Clip { get; set; }

var rectangleGeometry = uIElement.clip;
uIElement.clip = rectangleGeometry;

Public Property Clip As RectangleGeometry

<uiElement>
  <uiElement.Clip>
    rectangleGeometry
  </uiElement.Clip>
</uiElement>

Valor da propriedade

RectangleGeometry

A geometria do retângulo a ser usada para o dimensionamento da área de recorte. O valor padrão é nulo (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.

<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 Windows Runtime deve ser um RectangleGeometry. Não é possível especificar uma geometria não retangular.

A área recortada é o "exterior" da geometria. Em outras palavras, o conteúdo mostrado (não recortado) é a área do retângulo que é desenhada 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.