UIElement.Clip Eigenschaft

Definition

Ruft die Geometrie ab, die zum Definieren der Gliederung des Inhalts eines Elements verwendet wird, oder legt sie fest.Gets or sets the geometry used to define the outline of the contents of an element. Hierbei handelt es sich um eine Abhängigkeitseigenschaft.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

Eigenschaftswert

Die Geometrie, die zur Größenanpassung des Clippingbereichs verwendet werden soll.The geometry to be used for clipping area sizing. Der Standardwert ist eine Geometry von 0 (null).The default is a null Geometry.

Beispiele

In diesem Beispiel wird gezeigt, wie die Clip Region eines Frameworkelements definiert wird.This example shows how to define a framework element's Clip region. Verwenden Sie zum Definieren eines Clips eine Geometry (z. b. eine EllipseGeometry, um die Clip-Eigenschaft des Elements festzulegen.To define a clip, use a Geometry (for example, an EllipseGeometry to set the element's Clip property. Nur der Bereich, der sich innerhalb des Bereichs der Geometrie befindet, wird angezeigt.Only the area that is within the region of the geometry will be visible.

Das folgende Beispiel zeigt ein Image-Element ohne einen definierten Clip-Bereich.The following example shows an Image element without a defined clip region. Da kein Clip Bereich definiert ist, wird das gesamte Bild angezeigt.Because no clip region is defined, the entire image is displayed.

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

Ein-Objekt vor dem Anwenden eines Clip-Bereichs.An object before applying a clip region
Bild ohne Clip-BereichImage with No Clip Region

Im nächsten Beispiel wird ein identisches Bild erstellt, mit dem Unterschied, dass es über einen definierten Clip Bereich verfügt.In the next example, an identical Image is created, except that it has a defined clip region. Es wird nur der Teil des Bilds angezeigt, der sich innerhalb des Bereichs des EllipseGeometry befindet.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>

Ein abgeschnitten-ObjektA clipped object
Bild mit einem Ellipsen Clip BereichImage with an Elliptical Clip Region

Im folgenden Beispiel wird gezeigt, wie die Clip Region eines Frameworkelements animiert wird.The following example shows how animate a framework element's Clip region. In diesem Beispiel wird ein EllipseGeometry verwendet, um einen elliptischen Clip Bereich für ein Image Element zu definieren.In this example, an EllipseGeometry is used to define an elliptical clip region for an Image element. Ein-PointAnimation animiert die Center-Eigenschaft der Ellipse-Geometrie von (0,0) bis (200, 150).A PointAnimation animates the ellipse geometry's Center property from (0, 0) to (200, 150). Die Animation beginnt, nachdem das Bild geladen und unbegrenzt wiederholt wurde.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> 

Das vollständige Beispiel finden Sie im Beispiel Clip Region.For the full sample, see the Clip Region Sample.

Hinweise

Elemente außerhalb der Geometrie werden im gerenderten Layout visuell abgeschnitten.Elements outside the geometry will be visually clipped in the rendered layout. Die Geometrie muss nicht rechteckig sein.The geometry does not have to be rectangular.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

BezeichnerfeldIdentifier field ClipProperty
Metadateneigenschaften auf true festgelegtMetadata properties set to true KeineNone

Gilt für:

Siehe auch