UIElement.Clip Propriedade

Definição

Espaço de Nomes:
System.Windows
Assemblagem:
PresentationCore.dll

Obtém ou define a geometria usada para definir o contorno do conteúdo de um elemento. Isto é uma propriedade de dependência.

public:
 property System::Windows::Media::Geometry ^ Clip { System::Windows::Media::Geometry ^ get(); void set(System::Windows::Media::Geometry ^ value); };
public System.Windows.Media.Geometry Clip { get; set; }
member this.Clip : System.Windows.Media.Geometry with get, set
Public Property Clip As Geometry

Valor de Propriedade

Geometry

A geometria a ser usada para recortar o tamanho da área. O padrão é um nulo Geometry.

Exemplos

Este exemplo mostra como definir a região de Clip um elemento de estrutura. Para definir um clip, use um Geometry (por exemplo, um EllipseGeometry para definir a propriedade do Clip elemento. Apenas a área que está dentro da região da geometria será visível.

O exemplo seguinte mostra um Image elemento sem uma região de clipe definida. Como nenhuma região de clipe está definida, a imagem inteira é apresentada.

<Image Source="sampleImages\Waterlilies.jpg" 
  Width="200" Height="150" HorizontalAlignment="Left" />

Um objeto antes de aplicar uma região de clip Imagem sem Região de Clipe

No exemplo seguinte, é criada uma Imagem idêntica, exceto que tem uma região de clipe definida. Apenas a parte da imagem que estiver dentro da área EllipseGeometry será exibida.

<Image 
  Source="sampleImages\Waterlilies.jpg" 
  Width="200" Height="150" HorizontalAlignment="Left">
  <Image.Clip>
    <EllipseGeometry
      RadiusX="100"
      RadiusY="75"
      Center="100,75"/>
  </Image.Clip>
</Image>

Um objeto recortado Imagem com uma região de clipe elíptico

O exemplo seguinte mostra como se anima a região de Clip um elemento de estrutura. Neste exemplo, um EllipseGeometry é usado para definir uma região de clipe elíptico para um Image elemento. A PointAnimation anima a propriedade da Center geometria da elipse de (0, 0) para (200, 150). A animação começa a reproduzir depois de a imagem ser carregada e repete-se indefinidamente.

<Image
  Source="sampleImages\Waterlilies.jpg" 
  Width="200" Height="150" HorizontalAlignment="Left">
  <Image.Clip>
    <EllipseGeometry x:Name="MyEllipseGeometry1"
      RadiusX="100"
      RadiusY="75"
      Center="100,75"/>
  </Image.Clip>
  <Image.Triggers>
    <EventTrigger RoutedEvent="Image.Loaded">
      <BeginStoryboard>
        <Storyboard>
          <PointAnimation 
            Storyboard.TargetName="MyEllipseGeometry1" 
            Storyboard.TargetProperty="(EllipseGeometry.Center)"
            From="0,0" To="200,150" Duration="0:0:3" RepeatBehavior="Forever" 
            AutoReverse="True" />
          </Storyboard>
      </BeginStoryboard>
    </EventTrigger>
  </Image.Triggers>
</Image>

Para a amostra completa, veja a Amostra da Região do Clip.

Observações

Elementos fora da geometria serão visualmente recortados no layout renderizado. A geometria não tem de ser retangular.

Informação de Propriedade de Dependência

Iteme Value
Campo identificador ClipProperty
Propriedades dos metadados definidas como true None

Aplica-se a

Ver também