UIElement.Clip Свойство

Определение

Получает или задает геометрию, используемую для определения контура содержимого элемента.Gets or sets the geometry used to define the outline of the contents of an element. Это свойство зависимостей.This is a dependency property.

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

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

Геометрия, используемая для определения размеров области отсечения.The geometry to be used for clipping area sizing. Значение по умолчанию — Geometry, равное null.The default is a null Geometry.

Примеры

В этом примере показано, как определить область Clip элемента платформы.This example shows how to define a framework element's Clip region. Чтобы определить клип, используйте Geometry (например, EllipseGeometry, чтобы задать свойство Clip элемента.To define a clip, use a Geometry (for example, an EllipseGeometry to set the element's Clip property. Будут видны только области, находящиеся в пределах области геометрии.Only the area that is within the region of the geometry will be visible.

В следующем примере показан элемент Image без определенной области отсечения.The following example shows an Image element without a defined clip region. Так как область отсечения не определена, отображается изображение целиком.Because no clip region is defined, the entire image is displayed.

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

Объект перед применением области обрезкиAn object before applying a clip region
Изображение без области отсеченияImage with No Clip Region

В следующем примере создается идентичное изображение, за исключением того, что в нем определена область обрезки.In the next example, an identical Image is created, except that it has a defined clip region. Только часть изображения, находящихся в пределах области, будет отображаться EllipseGeometry.Only the part of the image that is within the area the EllipseGeometry will be displayed.

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

Обрезанный объектA clipped object
Изображение с эллиптической областью отсеченияImage with an Elliptical Clip Region

В следующем примере показано, как анимировать область Clip элемента платформы.The following example shows how animate a framework element's Clip region. В этом примере EllipseGeometry используется для определения области эллиптического отсечения для элемента Image.In this example, an EllipseGeometry is used to define an elliptical clip region for an Image element. PointAnimation анимируется свойство Center геометрии эллипса от (0, 0) до (200, 150).A PointAnimation animates the ellipse geometry's Center property from (0, 0) to (200, 150). Анимация начнет играть после загрузки изображения и повторять его в течение неограниченного времени.The animation starts playing after the image is loaded and repeats indefinitely.

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

Полный пример см. в разделе Пример области Clip.For the full sample, see the Clip Region Sample.

Комментарии

Элементы за пределами геометрии будут визуально обрезаны в макете, готовом для просмотра.Elements outside the geometry will be visually clipped in the rendered layout. Геометрия не обязательно должна быть прямоугольной.The geometry does not have to be rectangular.

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

Поле идентификатораIdentifier field ClipProperty
Для свойств метаданных задано значение trueMetadata properties set to true НетNone

Применяется к

Дополнительно