UIElement.Clip Свойство

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

Значение свойства

Геометрия, используемая для обрезки области размера. По умолчанию используется значение NULL Geometry.

Примеры

В этом примере показано, как определить регион элемента Clip платформы. Чтобы определить клип, используйте ( Geometry например, EllipseGeometry для задания свойства элемента Clip . Будет видна только область, расположенная в пределах области геометрии.

В следующем примере показан Image элемент без определенной области клипа. Так как область клипа не определена, отображается все изображение.

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

Изображение без области клипа

В следующем примере создается идентичный образ, за исключением того, что он имеет определенную область клипа. Отображается только часть изображения, расположенного в пределах области 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>

Изображение с эллиптической областью клипа

В следующем примере показано, как анимировать регион элемента Clip платформы. В этом примере используется для EllipseGeometry определения эллиптической области клипа для Image элемента. Анимирует PointAnimation свойство многоточия геометрии Center от (0, 0) до (200, 150). Анимация начинает воспроизводиться после загрузки изображения и повторяется на неопределенный срок.

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

Полный пример см. в примере области клипа.

Комментарии

Элементы за пределами геометрии будут визуально обрезаться в отрисованном макете. Геометрия не должна быть прямоугольной.

Сведения о свойстве зависимостей

См. также раздел

• ClipToBounds