Thickness Struktur

Definition

Namespace:

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

Vererbung

ValueType

Thickness

Attribute

ContractVersionAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Dickenwerte werden im Allgemeinen verwendet, um Eigenschaften festzulegen, die sich auf das Layout des Objekts auswirken, in dem die Eigenschaft festgelegt ist. Eigenschaften, die einen Thickness-Wert verwenden, umfassen:

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

In XAML können Sie Dickenwerte auf verschiedene Arten angeben. 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 Werte Left, Top dar und wenden die gleichen Werte auch auf Right und Bottom an, sodass die resultierende Dicke horizontal und vertikal isometrisch 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 Left-Eigenschaft oder ein Left-Feld festlegen, richten Sie nicht automatisch den gleichen Wert für Right ein. Alle Thickness-Eigenschaften müssen im Code diskret festgelegt werden. Sie können die Konstruktoren Thickness(Double) oder Thickness(Double,Double,Double,Double,Double) verwenden, anstatt Eigenschaften Werte zuzuweisen.

Obwohl der Typ der Datenwerte einer Dicke Double ist, geben Sie 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 eine Thickness als Objektelement angeben können, können Sie die einzelnen Werte wie Top nicht als Attribute dieses Objektelements angeben. Der XAML-Parser unterstützt das Festlegen von XAML-Attributwerten für diese Struktur nicht. Stattdessen müssen Sie die Werte als Initialisierungstext innerhalb der Dicke angeben. Die Verwendung der Objektelementsyntax für eine Thickness ist nützlich, wenn Sie eine ressource mit Schlüsseln deklarieren möchten, die von mehreren Control-Instanzen für deren Auffüllung verwendet werden kann. Weitere Informationen zu XAML-Initialisierungstext finden Sie unter XAML-Syntaxleitfaden.

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

Projektion und Elemente der Dicke

Wenn Sie eine Microsoft .NET-Sprache (C# oder Microsoft Visual Basic) oder Visual C++-Komponentenerweiterungen (C++/CX) verwenden, stehen für Thickness nicht-Datenmember 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 im .NET-API-Browser.

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

In dieser Tabelle sind die entsprechenden Methoden aufgeführt, die in .NET und C++ verfügbar sind.

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

Felder

Bottom	Das untere Randmaß der Stärke.
Left	Das linke Maß der Stärke.
Right	Das rechte Maß der Stärke.
Top	Das obere Randmaß der Stärke.

Weitere Informationen

• Border
• Control
• Definieren von Layouts mit XAML