UIElement.Clip Właściwość

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

Wartość właściwości

Geometria, która ma być używana do określania rozmiaru obszaru wycinków. Wartość domyślna to null Geometry.

Przykłady

W tym przykładzie pokazano, jak zdefiniować region elementu Clip struktury. Aby zdefiniować klip, użyj elementu Geometry (na przykład EllipseGeometry , aby ustawić właściwość elementu Clip . Widoczne będą tylko obszary znajdujące się w obrębie regionu geometrii.

W poniższym przykładzie pokazano Image element bez zdefiniowanego regionu klipu. Ponieważ nie zdefiniowano żadnego regionu klipu, zostanie wyświetlony cały obraz.

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

Obraz bez regionu klipu

W następnym przykładzie jest tworzony identyczny obraz, z tą różnicą, że ma zdefiniowany region klipu. Zostanie wyświetlona tylko część obrazu znajdującego się w obszarze EllipseGeometry .

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

Obraz z wielokropkiem

W poniższym przykładzie pokazano, jak animować region elementu Clip struktury. W tym przykładzie EllipseGeometry element jest używany do definiowania wielokropkowego regionu klipu Image dla elementu. Obiekt PointAnimation animuje właściwość geometrii wielokropka Center z (0, 0) do (200, 150). Animacja rozpoczyna odtwarzanie po załadowaniu obrazu i powtarza się w nieskończoność.

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

Pełny przykład można znaleźć w przykładzie Clip Region.

Uwagi

Elementy spoza geometrii zostaną wizualnie obcięte w renderowanym układzie. Geometria nie musi być prostokątna.

Informacje o właściwości zależności

Zobacz też

• ClipToBounds