UIElement.Clip Proprietà

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml

Ottiene o imposta l'oggetto RectangleGeometry utilizzato 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 del 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 oggetto RectangleGeometry inline che ne specifica le dimensioni tramite una sintassi di 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 Windows Runtime deve essere rectangleGeometry. Non è possibile specificare una geometria non rettangolare.

L'area ritagliata è l'esterno della geometria. In altre parole, il contenuto visualizzato (non ritagliato) è l'area del rettangolo disegnato con Riempimento se la geometria è stata utilizzata come dati per un oggetto Path anziché per il ritaglio. L'area ritagliata è qualsiasi area che si trova all'esterno del rettangolo. L'area ritagliata non è hit testable.