Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

UIElement.Clip-Eigenschaft

 

Veröffentlicht: Oktober 2016

Ruft die Geometrie ab, die zum Definieren der Gliederung des Inhalts eines Elements verwendet wird, oder legt sie fest. Hierbei handelt es sich um eine Abhängigkeitseigenschaft.

Namespace:   System.Windows
Assembly:  PresentationCore (in PresentationCore.dll)

public Geometry Clip { get; set; }

Eigenschaftswert

Type: System.Windows.Media.Geometry

Die Geometrie, die zur Größenanpassung des Clippingbereichs verwendet werden soll. Der Standardwert ist eine Geometry von 0 (null).

Elements outside the geometry will be visually clipped in the rendered layout. The geometry does not have to be rectangular.

Identifier field

ClipProperty

Metadata properties set to true

None

This example shows how to define a framework element'sP:System.Windows.UIElement.Clipregion. To define a clip, use a T:System.Windows.Media.Geometry (for example, an T:System.Windows.Media.EllipseGeometryto set the element's P:System.Windows.UIElement.Clipproperty. Only the area that is within the region of the geometry will be visible.

The following example shows an T:System.Windows.Controls.Imageelement without a defined clip region. 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 Clippingbereichs

Image with No Clip Region

In the next example, an identical Image is created, except that it has a defined clip region. Only the part of the image that is within the area the T:System.Windows.Media.EllipseGeometrywill 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 Objekt

Image with an Elliptical Clip Region

The following example shows how animate a framework element's P:System.Windows.UIElement.Clip region. In this example, an T:System.Windows.Media.EllipseGeometry is used to define an elliptical clip region for an T:System.Windows.Controls.Image element. A T:System.Windows.Media.Animation.PointAnimation animates the ellipse geometry's P:System.Windows.Media.EllipseGeometry.Center property from (0, 0) to (200, 150). 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> 

For the full sample, see the Clip Region Sample.

.NET Framework
Verfügbar seit 3.0
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0
Zurück zum Anfang
Anzeigen: