UIElement.ClipToBounds Proprietà

public:
 property bool ClipToBounds { bool get(); void set(bool value); };

public bool ClipToBounds { get; set; }

member this.ClipToBounds : bool with get, set

Public Property ClipToBounds As Boolean

Valore della proprietà

true se il contenuto deve essere ritagliato; in caso contrario, false. Il valore predefinito è false.

Commenti

Per gli elementi figlio, ClipToBounds ha effetti diversi sui comportamenti di layout a seconda che l'altezza e la larghezza dell'elemento padre siano determinate daHeight / Width o .MaxHeight / MaxWidth MaxHeight / MaxWidth dell'elemento padre vengono sempre rispettati indipendentemente dal valore di ClipToBounds e il ritaglio effettivo ritaglierà sempre il contenuto in base a questi valori massimi. Le impostazioni dell'elemento Height / Width padre non ritaglieranno il contenuto quando ClipToBounds è false, ma ritaglierà il contenuto se ClipToBounds è true.

Si noti che l'impostazione predefinita è false il comportamento generale implementato nella UIElement classe . È possibile che un determinato elemento derivi da UIElement per eseguire l'override dei metadati della proprietà di dipendenza per questa proprietà in tale istanza per impostazione predefinita true . Diverse classi derivate esistenti eseguono l'override di questi metadati e/o modificano il valore predefinito della proprietà di dipendenza.

InkCanvas, InkPresentere Popup ogni override del valore predefinito come true.

FrameworkElement esegue l'override dei metadati per questa proprietà di dipendenza. In particolare, FrameworkElement designa questa proprietà per consentire l'ereditarietà del valore della proprietà (Inherits è true nei metadati). L'ereditarietà del valore della proprietà in questo contesto significa che se sono presenti elementi figlio senza alcun altro valore per ClipToBounds assegnato tramite valori o stili locali, il valore dell'elemento padre più vicino con questo valore assegnato (anche in questo caso, negli stili, per valori predefiniti o in locale), il valore dell'elemento padre verrà assegnato a tutti gli elementi figlio non assegnati dal sistema di proprietà. In pratica questo significa che è possibile specificare se consentire il ritaglio ai limiti dell'elemento radice e tale valore verrà propagato a tutti gli elementi figlio che non lo hanno assegnato in modo specifico come false.

Informazioni sulle proprietà di dipendenza

Vedi anche

• Clip