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

Definizione

Ottiene o imposta la geometria usata per definire la struttura dei contenuti di un elemento.Gets or sets the geometry used to define the outline of the contents of an element. Si tratta di una proprietà di dipendenza.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

Valore della proprietà

Geometria da usare per il ridimensionamento dell'area di ritaglio.The geometry to be used for clipping area sizing. Il valore predefinito è un oggetto Geometry null.The default is a null Geometry.

Esempi

Questo esempio illustra come definire l'area di un elemento Clip del Framework.This example shows how to define a framework element's Clip region. Per definire una clip, usare un Geometry (ad esempio EllipseGeometry , per impostare la Clip proprietà dell'elemento.To define a clip, use a Geometry (for example, an EllipseGeometry to set the element's Clip property. Sarà visibile solo l'area che si trova all'interno dell'area geometrica.Only the area that is within the region of the geometry will be visible.

Nell'esempio seguente viene illustrato Image un elemento senza un'area di ritaglio definita.The following example shows an Image element without a defined clip region. Poiché non è definita alcuna area di ritaglio, viene visualizzata l'intera immagine.Because no clip region is defined, the entire image is displayed.

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

Oggetto prima di applicare un'area di ritaglioAn object before applying a clip region
Immagine senza area di ritaglioImage with No Clip Region

Nell'esempio seguente viene creata un'immagine identica, con la differenza che è presente un'area di ritaglio definita.In the next example, an identical Image is created, except that it has a defined clip region. EllipseGeometry Verrà visualizzata solo la parte dell'immagine che si trova all'interno dell'area.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>

Oggetto troncatoA clipped object
Immagine con un'area di ritaglio ellitticaImage with an Elliptical Clip Region

Nell'esempio seguente viene illustrato come animare l'area di Clip un elemento del Framework.The following example shows how animate a framework element's Clip region. In questo esempio viene usato EllipseGeometry un oggetto per definire un'area di ritaglio ellittica Image per un elemento.In this example, an EllipseGeometry is used to define an elliptical clip region for an Image element. Un PointAnimation oggetto aggiunge un'animazione alla Center proprietà della geometria dell'ellisse da (0, 0) a (200, 150).A PointAnimation animates the ellipse geometry's Center property from (0, 0) to (200, 150). L'animazione inizia la riproduzione dopo il caricamento dell'immagine e si ripete per un periodo illimitato.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> 

Per l'esempio completo, vedere l' esempiorelativo all'area di ritaglio.For the full sample, see the Clip Region Sample.

Commenti

Gli elementi al di fuori della geometria verranno ritagliati visivamente nel layout di cui è stato eseguito il rendering.Elements outside the geometry will be visually clipped in the rendered layout. Non è necessario che la geometria sia rettangolare.The geometry does not have to be rectangular.

Informazioni proprietà di dipendenzaDependency Property Information

Campo identificatoreIdentifier field ClipProperty
Proprietà dei metadati impostate sutrueMetadata properties set to true nessunoNone

Si applica a

Vedi anche