Thickness Struct

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml

Descrive lo spessore di un frame intorno a un rettangolo. Quattro valori Double descrivono rispettivamente i lati Left, Top, Right e Bottom del rettangolo.

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

Ereditarietà

ValueType

Thickness

Attributi

ContractVersionAttribute

Commenti

Thickness I valori vengono in genere usati per impostare le proprietà che influiscono sul layout dell'oggetto in cui è impostata la proprietà. Le proprietà che usano un Thickness valore includono:

• FrameworkElement.Margin
• Control.Padding
• Border.BorderThickness e Control.BorderThickness
• Altre Margin proprietà e Padding sulle classi che non sono un controllo, ad esempio RichTextBlock.Padding
• Image.NineGrid
• Shape.StrokeThickness

In XAML puoi specificare Thickness i valori in diversi modi. Se si specificano quattro Double valori, questi rappresentano rispettivamente i lati Left, Top, Right e Bottom del rettangolo di delimitazione. Se si specificano due valori, questi rappresentano i Leftvalori , Top e applicano anche gli stessi valori a Right e Bottom in modo che il risultato Thickness sia isometrico orizzontalmente e isometricamente verticalmente. È anche possibile specificare un singolo valore, che applica un valore uniforme a tutti e quattro i lati del rettangolo di delimitazione.

I valori assegnati dal codice non hanno alcun comportamento in grado di estrapolare i valori. Se si imposta il valore per una proprietà o un Left campo, non si stabilisce automaticamente lo stesso valore per Right. Tutte le Thickness proprietà devono essere impostate in modo discreto nel codice. È possibile usare i costruttori Thickness(Double) o Thickness(Double,Double,Double,Double,Double) anziché assegnare valori alle proprietà.

Anche se il tipo dei valori di dati di è ThicknessDouble, in genere si specificano valori integer.

Note sulla sintassi XAML

Una stringa che specifica tre valori non causa un errore del parser, ma solo i primi due valori vengono interpretati e qualsiasi terzo valore viene ignorato.

Sebbene sia possibile specificare un Thickness oggetto come elemento oggetto, non è possibile specificare i singoli valori, ad Top esempio gli attributi di tale elemento oggetto. Il parser XAML non supporta l'impostazione dei valori degli attributi XAML per questa struttura. È invece necessario specificare i valori come testo di inizializzazione all'interno di Thickness. L'uso della sintassi dell'elemento oggetto per un Thickness è utile se si desidera dichiarare una risorsa con chiave che può essere usata da più istanze di Control per il riempimento. Per altre info sul testo di inizializzazione XAML, vedi guida alla sintassi XAML.

È possibile usare uno spazio anziché una virgola come delimitatore tra i valori.

Proiezione e membri dello spessore

Se si usa C#, dispone Thickness di membri non dati disponibili e i relativi membri dati vengono esposti come proprietà di lettura/scrittura, non campi. Vedere Spessore nella documentazione dell'API .NET.

Se si esegue la programmazione con C++/WinRT o Windows Runtime Libreria modelli C++ (WRL), esistono solo i campi membro dati come membri di Thicknesse non è possibile usare i metodi di utilità o le proprietà della proiezione .NET. Il codice C++ può accedere a metodi di utilità simili esistenti nella classe ThicknessHelper .

Questa tabella mostra i metodi equivalenti disponibili in .NET e C++.

.NET (spessore)	C++ (ThicknessHelper)
Spessore(Double)	FromUniformLength(Double)
Thickness(Double, Double, Double, Double)	FromLengths(Double, Double, Double, Double)

Campi

Bottom	Misura del bordo inferiore dell'oggetto Thickness.
Left	Misura laterale sinistra dell'oggetto Thickness.
Right	Misura laterale destra dell'oggetto Thickness.
Top	Misura del bordo superiore dell'oggetto Thickness.

Vedi anche

• Border
• Control
• Definire layout con XAML