UIElement.ClipToBounds UIElement.ClipToBounds UIElement.ClipToBounds UIElement.ClipToBounds Property

Definizione

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.Gets or sets a value indicating whether to clip the content of this element (or content coming from the child elements of this element) to fit into the size of the containing element. Si tratta di una proprietà di dipendenza.This is a dependency property.

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.true if the content should be clipped; otherwise, false. Il valore predefinito è false.The default value is 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 da o MaxHeight Height / Width / MaxWidth.For child elements, ClipToBounds has different effects on layout behaviors depending on whether the height and width of the parent element are being determined by Height / Width or MaxHeight / MaxWidth. MaxHeight / MaxWidthl'elemento padre viene sempre rispettato indipendentemente dal valore di ClipToBounds e il ritaglio effettivo ridurrà sempre il contenuto in base a questi valori massimi.MaxHeight / MaxWidth of the parent element are always respected regardless of the value of ClipToBounds and the effective clipping will always clip the content based on these maximums. Le Width impostazioni dell' Height elemento padre / non ritagliano il ClipToBounds contenuto falsequando è, ma Ritaglia il ClipToBounds contenuto truese è.The parent's Height / Width settings will not clip the content when ClipToBounds is false, but will clip the content if ClipToBounds is true.

Si noti che per false impostazione predefinita è il comportamento generale implementato UIElement nella classe.Note that defaulting to false is the general behavior as implemented in the UIElement class. È possibile che un determinato elemento che deriva da UIElement esegua l'override dei metadati della proprietà di dipendenza per questa proprietà in tale istanza, per impostazione predefinita su. trueIt is possible for any given element that derives from UIElement to override the dependency property metadata for this property in that instance to default to true instead. Diverse classi derivate esistenti eseguono l'override di questi metadati e/o modificano il valore predefinito della proprietà di dipendenza.Several existing derived classes override this metadata and/or adjust the dependency property default value.

InkCanvas, InkPresenter truee Popup eseguono ogni override del valore predefinito.InkCanvas, InkPresenter, and Popup each override the default value to be true.

FrameworkElementesegue l'override dei metadati per questa proprietà di dipendenza.FrameworkElement overrides the metadata for this dependency property. In particolare FrameworkElement , designa questa proprietà per consentire l'ereditarietà del valoreInherits della true proprietà (è nei metadati).Specifically, FrameworkElement designates this property to allow property value inheritance (Inherits is true in metadata). L'ereditarietà del valore della proprietà in questo contesto significa che se sono presenti elementi figlio senza altro ClipToBounds valore assegnato tramite stili o valori locali, il valore dell'elemento padre più vicino a questo valore assegnato (di nuovo negli stili, per impostazione predefinita). valori o un valore localmente), il valore dell'elemento padre verrà assegnato a tutti gli elementi figlio non assegnati dal sistema di proprietà.Property value inheritance in this context means that if there are child elements with no other value for ClipToBounds assigned through local values or styles, the value of the nearest parent element with this value assigned (again, either in styles, by default values, or a locally value), then the value from the parent element will be assigned to all unassigned child elements by the property system. In pratica questo significa che è possibile specificare se consentire la ritaglio ai limiti nell'elemento radice e tale valore verrà propagato a tutti gli elementi figlio che non lo hanno assegnato in modo specifico falsecome.In practice this means that you can specify whether to allow clip to bounds at the root element, and that value will propagate to all child elements that have not specifically assigned it as false.

Informazioni proprietà di dipendenzaDependency Property Information

Campo identificatoreIdentifier field ClipToBoundsProperty
Proprietà dei metadati impostate sutrueMetadata properties set to true nessunoNone

Si applica a

Vedi anche