Thickness Structure

Définition

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 où 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 et Padding propriétés 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 façons. Si vous spécifiez quatre Double valeurs, celles-ci représentent respectivement les côtés gauche, Supérieur, Droit et Bas 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 les résultats Thickness sont isométriques horizontalement et isométriquement 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 est Double, vous spécifiez généralement des valeurs entières.

Remarques sur la syntaxe XAML

Une chaîne qui spécifie trois valeurs n’entraîne pas d’erreur d’analyseur, mais seulement 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 élément d’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 des valeurs d’attribut XAML pour cette structure. Au lieu de cela, vous devez spécifier les valeurs comme texte d’initialisation dans le 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 le 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 non-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 l’épaisseur dans la documentation de l’API .NET.

Si vous programmez avec C++/WinRT ou la bibliothèque de modèles C++ (WRL) Windows Runtime, seuls les champs membres de Thicknessdonnées existent en tant que membres 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++.

Voir aussi

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