Freigeben über

UIElement.Clip Eigenschaft

Definition

Namespace:
System.Windows
Assembly:
PresentationCore.dll

Dient zum Abrufen oder Festlegen der Geometrie, die zum Definieren der Gliederung des Inhalts eines Elements verwendet wird. Hierbei handelt es sich um eine Abhängigkeitseigenschaft.

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 für die Beschnittbereichsgröße verwendet werden soll. Der Standardwert ist null Geometry.

Beispiele

In diesem Beispiel wird gezeigt, wie Sie die Region eines Frameworkelements Clip definieren. Um einen Clip zu definieren, verwenden Sie eine Geometry (z. B. eine EllipseGeometry , um die Eigenschaft des Clip Elements festzulegen. Nur der Bereich, der sich innerhalb des Bereichs der Geometrie befindet, wird angezeigt.

Das folgende Beispiel zeigt ein Image Element ohne einen definierten Clipbereich. Da kein Clipbereich definiert ist, wird das gesamte Bild angezeigt.

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

Ein Objekt vor dem Anwenden eines Clipbereichs Bild ohne Clipbereich

Im nächsten Beispiel wird ein identisches Bild erstellt, mit der Ausnahme, dass es über einen definierten Clipbereich verfügt. Nur der Teil des Bilds, der sich innerhalb des Bereichs befindet, EllipseGeometry wird angezeigt.

<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 Ein Bild mit einem Elliptical Clip Region

Das folgende Beispiel zeigt, wie sie den Bereich eines Frameworkelements Clip animieren. In diesem Beispiel wird ein EllipseGeometry elliptischer Clipbereich für ein Image Element definiert. A PointAnimation animates the ellipse geometry's Center property from (0, 0) to (200, 150). Die Animation beginnt nach dem Laden des Bilds und wiederholt sich auf unbestimmte Zeit.

<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 Clip Region-Beispiel.

Hinweise

Elemente außerhalb der Geometrie werden im gerenderten Layout visuell abgeschnitten. Die Geometrie muss nicht rechteckig sein.

Informationen zur Abhängigkeitseigenschaft

Element Wert
Bezeichnerfeld ClipProperty
Auf Metadateneigenschaften festgelegt true Nichts

Gilt für:

Weitere Informationen