UIElement.Clip Propriété

Définition

Espace de noms:

Microsoft.UI.Xaml

Obtient ou définit le RectangleGeometry utilisé pour définir le contour du contenu d’un 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 via 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 une RectangleGeometry. Vous ne pouvez pas spécifier une géométrie non rectangulaire.

La zone clippée est l’extérieur de la géométrie. En d’autres termes, le contenu affiché (non clippé) 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 pour le découpage. La zone clippée est toute zone qui se trouve en dehors du rectangle. La zone clippée n’est pas testable.