UIElement.Clip Egenskap

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

Egenskapsvärde

Geometrin som ska användas för storleksändring av urklippsområde. Standardvärdet är null Geometry.

Exempel

Det här exemplet visar hur du definierar ett ramverkselements Clip region. Om du vill definiera ett klipp använder du en Geometry (till exempel en EllipseGeometry för att ange elementets Clip egenskap. Endast det område som ligger inom geometrins region kommer att vara synligt.

I följande exempel visas ett Image element utan ett definierat klippområde. Eftersom ingen klippregion har definierats visas hela bilden.

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

Bild utan klippområde

I nästa exempel skapas en identisk bild, förutom att den har en definierad klippregion. Endast den del av bilden som finns inom det område som EllipseGeometry ska visas.

<Image 
  Source="sampleImages\Waterlilies.jpg" 
  Width="200" Height="150" HorizontalAlignment="Left">
  <Image.Clip>
    <EllipseGeometry
      RadiusX="100"
      RadiusY="75"
      Center="100,75"/>
  </Image.Clip>
</Image>

Bild med ett elliptiskt klippområde

I följande exempel visas hur du animerar ett ramverkselements Clip region. I det här exemplet används en EllipseGeometry för att definiera en elliptisk klippregion för ett Image element. A PointAnimation animerar ellipsgeometrins Center egenskap från (0, 0) till (200, 150). Animeringen börjar spelas upp när bilden har lästs in och upprepas på obestämd tid.

<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>

Det fullständiga exemplet finns i Exempel på klippområde.

Kommentarer

Element utanför geometrin klipps visuellt i den renderade layouten. Geometrin behöver inte vara rektangulär.

Information om beroendeegenskap

Se även

• ClipToBounds