UIElement.Clip Eigenschap

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

Waarde van eigenschap

De geometrie die moet worden gebruikt voor de grootte van het knipgebied. De standaardwaarde is een null Geometry.

Voorbeelden

In dit voorbeeld ziet u hoe u de regio van Clip een frameworkelement definieert. Als u een clip wilt definiëren, gebruikt u een (bijvoorbeeld een GeometryEllipseGeometry om de eigenschap van Clip het element in te stellen. Alleen het gebied dat zich binnen het gebied van de geometrie bevindt, is zichtbaar.

In het volgende voorbeeld ziet u een Image element zonder een gedefinieerd clipgebied. Omdat er geen clipgebied is gedefinieerd, wordt de hele afbeelding weergegeven.

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

Afbeelding zonder clipgebied

In het volgende voorbeeld wordt een identieke afbeelding gemaakt, behalve dat deze een gedefinieerd clipgebied heeft. Alleen het deel van de afbeelding dat zich in het gebied bevindt, EllipseGeometry wordt weergegeven.

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

Afbeelding met een elliptisch clipgebied

In het volgende voorbeeld ziet u hoe u de regio van Clip een framework-element kunt animeren. In dit voorbeeld wordt een EllipseGeometry gebruikt om een elliptisch clipgebied voor een Image element te definiëren. Een PointAnimation animatie van de eigenschap van de ellipsgeometrie Center van (0, 0) tot (200, 150). De animatie wordt afgespeeld nadat de afbeelding is geladen en wordt voor onbepaalde tijd herhaald.

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

Zie het voorbeeld van het clipgebied voor het volledige voorbeeld.

Opmerkingen

Elementen buiten de geometrie worden visueel geknipt in de weergegeven indeling. De geometrie hoeft niet rechthoekig te zijn.

Informatie over afhankelijkheidseigenschappen

Zie ook

• ClipToBounds