UIElement.Clip, propriété

Les éléments à l'extérieur de la géométrie sont tronquées visuellement dans la mise en page rendue. La géométrie ne doit pas obligatoirement être rectangulaire.

cet exemple montre comment définir la région d' Clip d'un élément d'infrastructure. Pour définir un clip, utilisez Geometry (par exemple, EllipseGeometry pour définir la propriété d' Clip de l'élément. Seule la zone qui se trouve dans la zone de la géométrie est visible.

L'exemple suivant illustre un élément d' Image sans région de découpage définie. Étant donné qu'aucune zone de découpage n'est définie, l'intégralité de l'image s'affiche.

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

Dans l'exemple suivant, une image identique est créée, excepté qu'elle a une zone de découpage définie. Seule la partie de l'image qui se trouve dans la zone EllipseGeometry s'affiche.

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

L'exemple de code suivant comment animer une région d' Clip d'un élément d'infrastructure. dans cet exemple, EllipseGeometry est utilisé pour définir une zone de découpage elliptique pour un élément d' Image . Un PointAnimation anime la propriété Center de la géométrie d'ellipse de (0, 0) à (200, 150). La lecture de l'animation commence une fois l'image chargée et se répète indéfiniment.

<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> 

Pour l'exemple complet, consultez Clip Region Sample.

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Référence

Autres ressources