UIElement.Clip Proprietà

Definizione

Spazio dei nomi:

Windows.UI.Xaml

Ottiene o imposta la proprietà RectangleGeometry utilizzata per definire la struttura del contenuto di un oggetto UIElement.

public:
 property RectangleGeometry ^ Clip { RectangleGeometry ^ get(); void set(RectangleGeometry ^ value); };

RectangleGeometry Clip();

void Clip(RectangleGeometry value);

public RectangleGeometry Clip { get; set; }

var rectangleGeometry = uIElement.clip;
uIElement.clip = rectangleGeometry;

Public Property Clip As RectangleGeometry

<uiElement>
  <uiElement.Clip>
    rectangleGeometry
  </uiElement.Clip>
</uiElement>

Valore della proprietà

RectangleGeometry

Geometria rettangolo da utilizzare per il ridimensionamento dell'area di ritaglio. Il valore predefinito è Null (nessun ritaglio).

Esempio

Questo esempio è un markup XAML semplice che specifica un Clip usando un rettangolometria inline che specifica le relative dimensioni tramite una sintassi dell'attributo.

<Canvas>
    <Image Source="Images/Water_lilies.jpg" Width="200" Height="150">
        <Image.Clip>
            <RectangleGeometry Rect="100 75 50 50"/>
        </Image.Clip>
    </Image>
</Canvas>

Commenti

La geometria di ritaglio per UIElement.Clip nell'API di Windows Runtime deve essere una proprietà RectangleGeometry. Non è possibile specificare una geometria non rettangolare.

L'area ritagliata è l'area "esterna" della geometria. In altre parole, il contenuto visualizzato (non ritagliato) è l'area del rettangolo disegnato con Fill se la geometria è stata usata come dati per un percorso anziché per il ritaglio. L'area ritagliata è qualsiasi area che cade all'esterno del rettangolo. L'area ritagliata non è hit testable.