UIElement.Clip Eigenschaft

Definition

Namespace:

Windows.UI.Xaml

Ruft die RectangleGeometry ab, die zum Definieren der Gliederung des Inhalts eines UIElement verwendet wird, oder legt diese 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 Größenanpassung des Beschneidungsbereichs verwendet werden soll. Der Standardwert ist NULL (kein Clipping).

Beispiele

Dieses Beispiel ist ein einfaches XAML-Markup, das einen Clip mithilfe 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 das "Außen" der Geometrie. Anders ausgedrückt: Der angezeigte (nicht beschnittene) Inhalt ist der Bereich des Rechtecks, der mit Fill gezeichnet wird, wenn die Geometrie als Daten für einen Pfad und nicht zum Beschneiden verwendet wurde. Der beschnittene Bereich ist ein beliebiger Bereich, der außerhalb des Rechtecks liegt. Der beschnittene Bereich ist nicht treffertestbar.