Thickness Struktur

Definition

Namespace:

Microsoft.UI.Xaml

Beschreibt die Stärke eines Rahmens um ein Rechteck. Vier Double-Werte beschreiben die linke, obere, rechte und untere Seite des Rechtecks.

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" ... />

Vererbung

ValueType

Thickness

Attribute

ContractVersionAttribute

Hinweise

Thickness -Werte werden im Allgemeinen verwendet, um Eigenschaften festzulegen, die sich auf das Layout des Objekts auswirken, in dem die Eigenschaft festgelegt ist. Zu den Eigenschaften, die einen Thickness Wert verwenden, gehören:

• FrameworkElement.Margin
• Control.Padding
• Border.BorderThickness und Control.BorderThickness
• Andere Margin Eigenschaften und Padding Eigenschaften für Klassen, die kein Steuerelement sind, z . B. RichTextBlock.Padding
• Image.NineGrid
• Shape.StrokeThickness

In XAML können Sie Werte auf verschiedene Arten angeben Thickness . Wenn Sie vier Double Werte angeben, stellen diese die linke, obere, rechte und untere Seite des umgebenden Rechtecks dar. Wenn Sie zwei Werte angeben, stellen diese die LeftWerte darTop, und wenden die gleichen Werte auch auf und Bottom anRight, sodass die resultierenden Thickness horizontal isometrisch und isometrisch vertikal ist. Sie können auch einen einzelnen Wert angeben, der einen einheitlichen Wert auf alle vier Seiten des umgebenden Rechtecks anwendet.

Aus Code zugewiesene Werte weisen kein Verhalten auf, das Werte extrapolieren kann. Wenn Sie den Wert für eine Eigenschaft oder ein Left Feld festlegen, richten Sie nicht automatisch denselben Wert für Rightein. Alle Thickness Eigenschaften müssen diskret im Code festgelegt werden. Sie können die Dicken(Double)- oder Dicken(Double,Double,Double,Double,Double)- Konstruktoren verwenden, anstatt Eigenschaften Werte zuzuweisen.

Obwohl der Typ der Datenwerte eines Thickness ist, geben DoubleSie in der Regel ganzzahlige Werte an.

Hinweise zur XAML-Syntax

Eine Zeichenfolge, die drei Werte angibt, verursacht keinen Parserfehler, sondern nur die ersten beiden Werte werden interpretiert, und jeder dritte Wert wird ignoriert.

Obwohl Sie ein Thickness als Objektelement angeben können, können Sie die einzelnen Werte nicht angeben, z Top . B. als Attribute dieses Objektelements. Der XAML-Parser unterstützt das Festlegen von XAML-Attributwerten für diese Struktur nicht. Stattdessen müssen Sie die Werte als Initialisierungstext innerhalb von Thicknessangeben. Die Verwendung der Objektelementsyntax für ein Thickness ist nützlich, wenn Sie eine schlüsselierte Ressource deklarieren möchten, die von mehreren Control-Instanzen für ihre Auffüllung verwendet werden kann. Weitere Informationen zum XAML-Initialisierungstext finden Sie unter XAML-Syntaxhandbuch.

Sie können ein Leerzeichen anstelle eines Kommas als Trennzeichen zwischen Werten verwenden.

Projektion und Elemente der Stärke

Wenn Sie C# verwenden, stehen Thickness Nichtdatenmember zur Verfügung, und die zugehörigen Datenmember werden als Eigenschaften mit Lese-/Schreibzugriff und nicht als Felder verfügbar gemacht. Weitere Informationen finden Sie unter Dicke in der Dokumentation zur .NET-API.

Wenn Sie mit C++/WinRT oder der Windows-Runtime C++-Vorlagenbibliothek (WRL) programmieren, sind nur die Datenmemberfelder als Member von Thicknessvorhanden, und Sie können die Hilfsprogrammmethoden oder -eigenschaften der .NET-Projektion nicht verwenden. C++-Code kann auf ähnliche Hilfsprogrammmethoden zugreifen, die für die ThicknessHelper-Klasse vorhanden sind.

Diese Tabelle zeigt die entsprechenden Methoden, die in .NET und C++ verfügbar sind.

.NET (Stärke)	C++ (ThicknessHelper)
Stärke(Double)	FromUniformLength(Double)
Dicke(Double, Double, Double, Double, Double)	FromLengths(Double, Double, Double, Double)

Felder

Bottom	Das untere Randmaß von Thickness.
Left	Das linke Seitenmaß von Thickness.
Right	Das rechte Seitenmaß von Thickness.
Top	Das obere Randmaß von Thickness.

Weitere Informationen

• Border
• Control
• Definieren von Layouts mit XAML