UIElement.Clip Propriété

Définition

Espace de noms:

Windows.UI.Xaml

Obtient ou définit le RectangleGeometry utilisé pour définir le plan du contenu d’un élément 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>

Valeur de propriété

RectangleGeometry

Géométrie rectangle à utiliser pour le dimensionnement de la zone de découpage. La valeur par défaut est null (pas de découpage).

Exemples

Cet exemple est un balisage XAML simple qui spécifie un clip à l’aide d’un RectangleGeometry inline qui spécifie ses dimensions par le biais d’une syntaxe d’attribut.

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

Remarques

La géométrie de découpage pour UIElement.Clip dans l’API Windows Runtime doit être un RectangleGeometry. Vous ne pouvez pas spécifier une géométrie non rectangulaire.

La zone découpée est l'« extérieur » de la géométrie. En d’autres termes, le contenu affiché (non coupé) est la zone du rectangle qui est dessinée avec remplissage si la géométrie a été utilisée comme données pour un chemin d’accès plutôt que comme découpage. La zone coupée est toute zone qui se trouve en dehors du rectangle. La zone coupée n’est pas testable.