UIElement.Clip UIElement.Clip UIElement.Clip UIElement.Clip Property

Définition

Obtient ou définit la géométrie utilisée pour définir le contour du contenu d’un élémentGets or sets the geometry used to define the outline of the contents of an element. Il s’agit d’une propriété de dépendance.This is a dependency property.

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

Valeur de propriété

Géométrie à utiliser pour le découpage des dimensions de la zone.The geometry to be used for clipping area sizing. La valeur par défaut est un Geometry null.The default is a null Geometry.

Exemples

Cet exemple montre comment définir un élément d’infrastructure Clip région.This example shows how to define a framework element's Clip region. Pour définir un élément, utilisez un Geometry (par exemple, un EllipseGeometry pour définir l’élément Clip propriété.To define a clip, use a Geometry (for example, an EllipseGeometry to set the element's Clip property. Seule la zone qui se trouve dans la région de la géométrie sera visible.Only the area that is within the region of the geometry will be visible.

L’exemple suivant montre un Image élément sans une zone de découpage définie.The following example shows an Image element without a defined clip region. Parce qu’aucune zone de découpage n’est défini, l’image entière s’affiche.Because no clip region is defined, the entire image is displayed.

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

Un objet avant d’appliquer une zone de découpageAn object before applying a clip region
Image avec aucune zone de découpageImage with No Clip Region

Dans l’exemple suivant, une Image identique est créée, sauf qu’il a une zone de découpage définie.In the next example, an identical Image is created, except that it has a defined clip region. Seule la partie de l’image qui se trouve dans la zone de la EllipseGeometry s’affichera.Only the part of the image that is within the area the EllipseGeometry will be displayed.

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

Objet découpéA clipped object
Image avec une zone de découpage elliptiqueImage with an Elliptical Clip Region

L’exemple suivant montre comment animer un élément d’infrastructure Clip région.The following example shows how animate a framework element's Clip region. Dans cet exemple, un EllipseGeometry est utilisé pour définir une zone de découpage elliptique pour un Image élément.In this example, an EllipseGeometry is used to define an elliptical clip region for an Image element. Un PointAnimation anime la géométrie d’ellipse Center propriété à partir de (0, 0) à (200, 150).A PointAnimation animates the ellipse geometry's Center property from (0, 0) to (200, 150). Lancer l’animation une fois que l’image est chargée et se répète indéfiniment.The animation starts playing after the image is loaded and repeats indefinitely.

<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 la exemple de région de découpage.For the full sample, see the Clip Region Sample.

Remarques

Éléments en dehors de la géométrie apparaîtront détourés dans la disposition de l’affichage.Elements outside the geometry will be visually clipped in the rendered layout. La géométrie ne devra pas être rectangulaire.The geometry does not have to be rectangular.

Informations sur les propriétés de dépendanceDependency Property Information

Champ d’identificateurIdentifier field ClipProperty
La valeur des propriétés de métadonnées trueMetadata properties set to true Aucun.None

S’applique à

Voir aussi