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

Geometry

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 Region eines Frameworkelements definiert wird Clip .This example shows how to define a framework element's Clip region. Um einen Clip zu definieren, verwenden Sie einen Geometry (z. b. ein, EllipseGeometry um die-Eigenschaft des Elements festzulegen Clip .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 BeschneidungsbereichsAn 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 von befindet EllipseGeometry .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 beschnittenes ObjektA clipped object
Bild mit einem Ellipsen Clip BereichImage with an Elliptical Clip Region

Im folgenden Beispiel wird gezeigt, wie die Region eines Frameworkelements animiert wird Clip .The following example shows how animate a framework element's Clip region. In diesem Beispiel wird ein EllipseGeometry elliptischer Clip Bereich für ein Image Element definiert.In this example, an EllipseGeometry is used to define an elliptical clip region for an Image element. Eine PointAnimation animiert die-Eigenschaft der Ellipse-Geometrie Center 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:

Weitere Informationen