UIElement.Clip UIElement.Clip UIElement.Clip UIElement.Clip Property

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 ein FrameworkElement definiert Clip Region.This example shows how to define a framework element's Clip region. Um einen Clip zu definieren, verwenden eine Geometry (z. B. eine EllipseGeometry des Elements festlegen Clip Eigenschaft.To define a clip, use a Geometry (for example, an EllipseGeometry to set the element's Clip property. Nur der Bereich, der innerhalb der Region der Geometry-Instanz ist, werden angezeigt.Only the area that is within the region of the geometry will be visible.

Das folgende Beispiel zeigt eine Image -Element ohne einem definierten Clip-Bereich.The following example shows an Image element without a defined clip region. Da keine 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 ClippingbereichsAn object before applying a clip region
Bild mit keine Clip-BereichImage with No Clip Region

Im nächsten Beispiel wird eine identische Abbild erstellt, außer dass er einen definierten Clip-Bereich befindet.In the next example, an identical Image is created, except that it has a defined clip region. Nur den Teil des Bilds, das innerhalb des Bereichs, wird die EllipseGeometry wird angezeigt.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 abgeschnittenes ObjektA clipped object
Bild mit einem elliptischen Clip-BereichImage with an Elliptical Clip Region

Das folgende Beispiel zeigt, wie Animieren eines Frameworkelements Clip Region.The following example shows how animate a framework element's Clip region. In diesem Beispiel ein EllipseGeometry dient zum Definieren eines elliptischen Clip-Bereichs für eine Image Element.In this example, an EllipseGeometry is used to define an elliptical clip region for an Image element. Ein PointAnimation des EllipseGeometry-Objekts animiert Center Eigenschaft von (0, 0), (200, 150).A PointAnimation animates the ellipse geometry's Center property from (0, 0) to (200, 150). Start der Animation wiedergeben, nachdem das Abbild geladen wird und auf unbestimmte Zeit wiederholt.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 unter den Clip-Bereich-Beispiel.For the full sample, see the Clip Region Sample.

Hinweise

Elementen 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

Feld "ID"Identifier field ClipProperty
Legen Sie auf der Metadaten-Eigenschaften trueMetadata properties set to true KeinerNone

Gilt für:

Siehe auch