Condividi tramite

UIElement.Clip Proprietà

Definizione

Spazio dei nomi:
System.Windows
Assembly:
PresentationCore.dll

Ottiene o imposta la geometria utilizzata per definire la struttura del contenuto di un elemento. Si tratta di una proprietà di dipendenza.

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à

Geometry

Geometria da utilizzare per il ridimensionamento dell'area di ritaglio. Il valore predefinito è null Geometry.

Esempio

Questo esempio illustra come definire l'area di un elemento framework Clip . Per definire una clip, utilizzare , ad esempio, un GeometryEllipseGeometry oggetto per impostare la proprietà dell'elemento Clip . Solo l'area all'interno dell'area della geometria sarà visibile.

L'esempio seguente mostra un Image elemento senza un'area clip definita. Poiché non è definita alcuna area di ritaglio, viene visualizzata l'intera immagine.

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

Oggetto prima di applicare un'area di ritaglio Un Immagine senza area clip

Nell'esempio seguente viene creata un'immagine identica, ad eccezione del fatto che ha un'area di ritaglio definita. Verrà visualizzata solo la parte dell'immagine all'interno dell'area 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>

Oggetto ritagliato Oggetto ritagliato Immagine con un'area clip ellittica

L'esempio seguente illustra come animare l'area di un elemento framework Clip . In questo esempio viene usato un oggetto EllipseGeometry per definire un'area di ritaglio ellittica per un Image elemento . Un PointAnimation oggetto anima la proprietà della geometria dell'ellisse Center da (0, 0) a (200, 150). L'animazione inizia a essere riprodotta dopo il caricamento dell'immagine e si ripete per un periodo illimitato.

<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'esempio clip region.For the full sample, see the Clip Region Sample.

Commenti

Gli elementi esterni alla geometria verranno ritagliati visivamente nel layout sottoposto a rendering. La geometria non deve essere rettangolare.

Informazioni sulle proprietà di dipendenza

Elemento Valore
Campo Identificatore ClipProperty
Proprietà dei metadati impostate su true Nessuno

Si applica a

Vedi anche