UIElement.Clip UIElement.Clip UIElement.Clip UIElement.Clip Property

Определение

Получает или задает геометрию, используемую для определения контура содержимого элемента.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> 

Полный пример см. в разделе отсеченной области пример.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 NoneNone

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

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