Thickness Structure

Définition

Espace de noms:

Microsoft.UI.Xaml

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

public value class Thickness

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
struct Thickness

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 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

Remarques

Thickness les valeurs sont généralement utilisées pour définir des 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 Thickness valeur sont les suivantes :

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

En XAML, vous pouvez spécifier des Thickness valeurs de plusieurs manières. Si vous spécifiez quatre Double valeurs, celles-ci 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 Leftvaleurs , Top et appliquent également les mêmes valeurs à Right et Bottom de telle sorte que le résultat Thickness 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 attribué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 Left champ, vous n’établissez pas automatiquement la même valeur pour Right. Toutes les Thickness propriétés 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’un Thickness 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 un Thickness en tant qu’élément objet, vous ne pouvez pas spécifier les valeurs individuelles telles que Top les attributs de cet élément 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 .Thickness L’utilisation de la syntaxe de l’élément objet pour un Thickness 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 C#, Thickness les membres autres que les données sont 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 la documentation de l’API .NET.

Si vous programmez avec C++/WinRT ou la bibliothèque de modèles C++ Windows Runtime (WRL), seuls les champs membres de données existent en tant que membres de Thickness, 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 d’utilitaire similaires qui existent sur la classe ThicknessHelper .

Ce tableau montre 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 .Thickness
Left	Mesure du côté gauche de .Thickness
Right	Mesure de droite de .Thickness
Top	Mesure du bord supérieur de .Thickness

Voir aussi

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