UIElement.Clip Eigenschaft

Definition

Namespace:

Microsoft.UI.Xaml

Ruft die RectangleGeometry ab, die verwendet wird, um die Gliederung des Inhalts eines UIElements zu definieren, oder legt sie fest.

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>

Eigenschaftswert

RectangleGeometry

Die Rechteckgeometrie, die für die Beschneidung des Bereichs verwendet werden soll. Der Standardwert ist null (kein Ausschneiden).

Beispiele

In diesem Beispiel handelt es sich um ein einfaches XAML-Markup, das einen Clip mit einer Inline-RectangleGeometry angibt, die seine Dimensionen über eine Attributsyntax angibt.

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

Hinweise

Die Clippinggeometrie für UIElement.Clip in der Windows-Runtime-API muss eine RectangleGeometry sein. Sie können keine nicht rechteckige Geometrie angeben.

Der beschnittene Bereich ist die Außenseite der Geometrie. Anders ausgedrückt: Der angezeigte (nicht abgeschnittene) Inhalt ist der Bereich des Rechtecks, der mit Füllung gezeichnet wird, wenn die Geometrie als Daten für einen Pfad und nicht für das Ausschneiden verwendet wurde. Der abgeschnittene Bereich ist ein beliebiger Bereich, der außerhalb des Rechtecks liegt. Der abgeschnittene Bereich ist nicht treffertestbar.