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

![Объект перед применением области обрезки] (~/add/media/mil-task-clip-region-noclip.png "Объект перед применением области обрезки")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>

![Обрезанный объект] (~/add/media/mil-task-clip-region-ellispe.PNG "Обрезанный объект")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 свойство Geometry в виде эллипса от (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

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

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