UIElement.ClipToBounds Proprietà

Definizione

Spazio dei nomi:

System.Windows

Assembly:

PresentationCore.dll

Recupera o imposta un valore che indica se ritagliare il contenuto dell'elemento (o il contenuto proveniente dagli elementi figlio dell'elemento) per adattarlo alle dimensioni dell'elemento contenitore. Si tratta di una proprietà di dipendenza.

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à

Boolean

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 daWidth / Height o .MaxHeight / MaxWidth MaxHeight / MaxWidth dell'elemento padre viene sempre rispettato 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 il comportamento predefinito false è il comportamento generale implementato nella UIElement classe. È possibile che qualsiasi elemento specificato che deriva da UIElement per eseguire l'override dei metadati delle proprietà di dipendenza per questa proprietà in tale istanza per true impostazione predefinita. 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 da .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 in metadati). L'ereditarietà del valore della proprietà in questo contesto significa che se non sono presenti altri elementi figlio per ClipToBounds l'assegnazione tramite valori o stili locali, il valore dell'elemento padre più vicino con questo valore assegnato (di nuovo, in stili, per valori predefiniti o un valore 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 agli clip di associare all'elemento radice e tale valore verrà propagato a tutti gli elementi figlio che non lo hanno assegnato in modo specifico come false.

Informazioni proprietà di dipendenza

Campo Identificatore	ClipToBoundsProperty
Proprietà dei metadati impostate su true	Nessuno

Vedi anche

• Clip