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

Définition

Obtient ou définit une valeur qui indique s'il faut ou non détourer le contenu de cet élément (ou le contenu provenant des éléments enfants de cet élément) pour l'ajuster à la taille de l'élément qui les contient.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. Il s’agit d’une propriété de dépendance.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

Valeur de propriété

true si le contenu doit être détouré ; sinon, false.true if the content should be clipped; otherwise, false. La valeur par défaut est false.The default value is false.

Remarques

Pour les éléments enfants, ClipToBounds peut avoir différents effets sur les comportements de disposition selon que la hauteur et largeur de l’élément parent sont déterminées par Height / Width ou MaxHeight / 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 / MaxWidth de l’élément parent sont toujours respectés, quel que soit la valeur de ClipToBounds et le découpage s’effectue toujours le contenu en fonction de ces valeurs maximales.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 parent Height / Width paramètres ne seront pas détourer le contenu lorsque ClipToBounds est false, mais découpe le contenu si ClipToBounds est true.The parent's Height / Width settings will not clip the content when ClipToBounds is false, but will clip the content if ClipToBounds is true.

Notez cette valeur par défaut : false est le comportement général tel qu’implémenté dans le UIElement classe.Note that defaulting to false is the general behavior as implemented in the UIElement class. Il est possible pour tout élément qui dérive de UIElement à substituer les métadonnées de propriété de dépendance pour cette propriété dans cette instance par défaut à true à la place.It 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. Plusieurs classes dérivées existantes substituent ces métadonnées et/ou ajustent la valeur par défaut de la propriété de dépendance.Several existing derived classes override this metadata and/or adjust the dependency property default value.

InkCanvas, InkPresenter, et Popup chaque substitution de la valeur par défaut pour être true.InkCanvas, InkPresenter, and Popup each override the default value to be true.

FrameworkElement substitue les métadonnées pour cette propriété de dépendance.FrameworkElement overrides the metadata for this dependency property. Plus précisément, FrameworkElement désigne cette propriété pour autoriser l’héritage de valeur de propriété (Inherits est true dans les métadonnées).Specifically, FrameworkElement designates this property to allow property value inheritance (Inherits is true in metadata). L’héritage de valeur de propriété dans ce contexte signifie que s’il existe des éléments enfants avec aucune autre valeur pour ClipToBounds affecté par l’intermédiaire de valeurs locales ou de styles, la valeur de l’élément parent le plus proche avec cette valeur attribuée (là encore, soit dans les styles, par défaut valeurs, ou une valeur localement), la valeur de l’élément parent est affectée à tous les éléments enfants non attribués par le système de propriétés.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. Dans la pratique, cela signifie que vous pouvez spécifier s’il faut autoriser le clip limites à l’élément racine, et cette valeur se propage à tous les éléments enfants qui n’ont pas spécifiquement affectés en tant que false.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.

Informations sur les propriétés de dépendanceDependency Property Information

Champ d’identificateurIdentifier field ClipToBoundsProperty
La valeur des propriétés de métadonnées trueMetadata properties set to true Aucun.None

S’applique à

Voir aussi