Thickness Structure

Définition

Espace de noms:

Windows.UI.Xaml

Décrit l'épaisseur d'un cadre autour d'un rectangle. Quatre valeurs Double décrivent les côtés gauche, supérieur, droit et inférieur du rectangle, respectivement.

public value class Thickness

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
struct Thickness

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public struct Thickness

Public Structure Thickness

<Thickness ...>uniform</Thickness>
- or -
<Thickness ...>left&right,top&bottom</Thickness>
- or -
<Thickness ...>left,top,right,bottom</Thickness>
- or -
<object property="uniform"/>
- or -
<object property="left&right,top&bottom"/>
- or -
<object property="left,top,right,bottom" ... />

Héritage

ValueType

Thickness

Attributs

ContractVersionAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

Les valeurs d’épaisseur sont généralement utilisées pour définir les propriétés qui affectent la disposition de l’objet dans lequel la propriété est définie. Les propriétés qui utilisent une valeur d’épaisseur sont les suivantes :

• FrameworkElement.Margin
• Control.Padding
• Border.BorderThickness et Control.BorderThickness
• Autres propriétés Margin et Padding sur les classes qui ne sont pas un contrôle, par exemple RichTextBlock.Padding
• Image.NineGrid
• Shape.StrokeThickness
• ProgressBarTemplateSettings.EllipseOffset

En XAML, vous pouvez spécifier des valeurs d’épaisseur de plusieurs façons. Si vous spécifiez quatre valeurs Double , elles représentent respectivement les côtés gauche, supérieur, droit et inférieur du rectangle englobant. Si vous spécifiez deux valeurs, celles-ci représentent les valeurs Gauche et Haut , et appliquent également les mêmes valeurs à Droite et Bas de sorte que l’épaisseur obtenue soit isométrique horizontalement et isométrique verticalement. Vous pouvez également fournir une valeur unique, qui applique une valeur uniforme aux quatre côtés du rectangle englobant.

Les valeurs affectées à partir du code n’ont aucun comportement pouvant extrapoler des valeurs. Si vous définissez la valeur d’une propriété ou d’un champ Left , vous n’établissez pas automatiquement la même valeur pour Right. Toutes les propriétés d’épaisseur doivent être définies discrètement dans le code. Vous pouvez utiliser les constructeurs Thickness(Double) ou Thickness(Double,Double,Double,Double) plutôt que d’affecter des valeurs aux propriétés.

Bien que le type des valeurs de données d’une épaisseur soit Double, vous spécifiez généralement des valeurs entières.

Remarques sur la syntaxe XAML

Une chaîne qui spécifie trois valeurs ne provoque pas d’erreur d’analyseur, mais seules les deux premières valeurs sont interprétées et toute troisième valeur est ignorée.

Bien que vous puissiez spécifier une épaisseur en tant qu’élément objet, vous ne pouvez pas spécifier les valeurs individuelles telles que Top en tant qu’attributs de cet élément d’objet. L’analyseur XAML ne prend pas en charge la définition de valeurs d’attribut XAML pour cette structure. Au lieu de cela, vous devez spécifier les valeurs en tant que texte d’initialisation dans l’épaisseur. L’utilisation de la syntaxe d’élément objet pour une épaisseur est utile si vous souhaitez déclarer une ressource à clé qui peut être utilisée par plusieurs instances De contrôle pour leur remplissage. Pour plus d’informations sur le texte d’initialisation XAML, consultez guide de syntaxe XAML.

Vous pouvez utiliser un espace plutôt qu’une virgule comme délimiteur entre les valeurs.

Projection et membres de l’épaisseur

Si vous utilisez un langage Microsoft .NET (C# ou Microsoft Visual Basic) ou des extensions de composant Visual C++ (C++/CX), l’épaisseur dispose de membres non-données disponibles et ses membres de données sont exposés en tant que propriétés en lecture-écriture, et non en tant que champs. Consultez Épaisseur dans le navigateur d’API .NET.

Si vous programmez avec C++/WinRT ou la Windows Runtime bibliothèque de modèles C++ (WRL), seuls les champs membres de données existent en tant que membres de l’épaisseur et vous ne pouvez pas utiliser les méthodes ou propriétés utilitaires de la projection .NET. Le code C++ peut accéder à des méthodes utilitaires similaires qui existent sur la classe ThicknessHelper .

Ce tableau présente les méthodes équivalentes disponibles dans .NET et C++.

.NET (Épaisseur)	C++ (ThicknessHelper)
Épaisseur(Double)	FromUniformLength(Double)
Épaisseur(Double, Double, Double, Double)	FromLengths(Double, Double, Double, Double)

Champs

Bottom	Mesure du bord inférieur de l’épaisseur.
Left	Mesure du côté gauche de l’épaisseur.
Right	Mesure de droite de l’épaisseur.
Top	Mesure du bord supérieur de l’épaisseur.

Voir aussi

• Border
• Control
• Définir des dispositions avec XAML