UIElement.Clip Свойство

Определение

Пространство имен:

System.Windows

Сборка:

PresentationCore.dll

Получает или задает геометрию, используемую для определения контура содержимого элемента. Это свойство зависимостей.

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

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

Geometry

Геометрия, используемая для определения размеров области отсечения. Значение по умолчанию — Geometry, равное null.

Примеры

В этом примере показано, как определить регион элемента платформы 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>

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

Комментарии

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

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

Поле идентификатора	ClipProperty
Metadata properties set to true	Нет

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

• ClipToBounds