UIElement.ClipToBounds Propriété

Définition

Espace de noms:

System.Windows

Assembly:

PresentationCore.dll

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. Il s’agit d’une propriété de dépendance.

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é

Boolean

true si le contenu doit être détouré ; sinon, false. La valeur par défaut est false.

Remarques

Pour les éléments enfants, ClipToBounds a des effets différents sur les comportements de disposition selon que la hauteur et la largeur de l’élément parent sont déterminées parWidth / Height ou .MaxHeight / MaxWidth MaxHeight / MaxWidth de l’élément parent sont toujours respectés quelle que soit la valeur de ClipToBounds et le découpage effectif est toujours clipper le contenu en fonction de ces maximales. Les paramètres du Height / Width parent ne coupent pas le contenu quand ClipToBounds est false, mais cliptent le contenu si ClipToBounds est .true

Notez que la false valeur par défaut est le comportement général implémenté dans la UIElement classe . Il est possible qu’un élément donné qui dérive de remplace les métadonnées de la propriété de UIElement dépendance de cette propriété dans cette instance à la place par défaut true . Plusieurs classes dérivées existantes remplacent ces métadonnées et/ou ajustent la valeur par défaut de la propriété de dépendance.

InkCanvas, InkPresenteret Popup remplacent chacun la valeur par défaut pour être true.

FrameworkElement remplace les métadonnées de cette propriété de dépendance. Plus précisément, FrameworkElement désigne cette propriété pour autoriser l’héritage de la valeur de propriété (Inherits est true dans les métadonnées). L’héritage de la valeur de propriété dans ce contexte signifie que s’il existe des éléments enfants sans autre valeur attribuée ClipToBounds par le biais de valeurs ou de styles locaux, la valeur de l’élément parent le plus proche avec cette valeur affectée (soit dans les styles, par défaut, soit 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. Dans la pratique, cela signifie que vous pouvez spécifier s’il faut autoriser le clip à des limites au niveau de l’élément racine, et que cette valeur se propage à tous les éléments enfants qui ne l’ont pas spécifiquement affectée en tant que false.

Informations sur les propriétés de dépendance

Champ Identificateur	ClipToBoundsProperty
Propriétés de métadonnées définies sur true	Aucun

Voir aussi

• Clip