UIElement.ClipToBounds Propriété

Définition

Obtient ou définit une valeur indiquant s’il faut découper le contenu de cet élément (ou du contenu provenant des éléments enfants de cet élément) pour s’adapter à la taille de l’élément conteneur. 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é

true si le contenu doit être clippé ; 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 parHeight / Widthou MaxHeight / MaxWidthpar . MaxHeight / MaxWidth de l’élément parent sont toujours respectés, quelle que soit la valeur et ClipToBounds la capture effective clippera toujours le contenu en fonction de ces maximums. Les paramètres du Height / Width parent ne découpent pas le contenu lorsque ClipToBounds c’est falsele cas, mais le contenu est clipé le cas échéant.ClipToBoundstrue

Notez que la valeur par défaut false est le comportement général tel qu’implémenté dans la UIElement classe. Il est possible que tout élément donné qui dérive de remplacer les métadonnées de UIElement propriété de dépendance pour cette propriété dans cette instance soit défini par défaut true à la place. 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 chaque remplacement de la valeur par défaut doit ê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 valeur de propriété (Inherits se trouve true dans les métadonnées). L’héritage de valeur de propriété dans ce contexte signifie que s’il existe des éléments enfants sans autre valeur ClipToBounds attribuée par le biais de valeurs locales ou de styles, la valeur de l’élément parent le plus proche avec cette valeur affectée (à nouveau, dans les styles, par défaut, par valeurs ou 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 à l’élément racine, et que cette valeur se propage à tous les éléments enfants qui ne l’ont pas spécifiquement affecté en tant que false.

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

Élément Valeur
Champ d’identificateur ClipToBoundsProperty
Propriétés de métadonnées définies sur true None

S’applique à

Voir aussi