Thickness Struct

Definizione

Spazio dei nomi:

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

Ereditarietà

ValueType

Thickness

Attributi

ContractVersionAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

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

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

In XAML è possibile specificare valori di spessore in diversi modi. Se si specificano quattro valori Double , questi rappresentano rispettivamente i lati Left, Top, Right e Bottom del rettangolo di selezione. Se si specificano due valori, questi rappresentano i valori Left, Top e si applicano anche gli stessi valori a Destra e Inferiore in modo che lo spessore risultante sia isometrico orizzontalmente e isometrico verticalmente. È anche possibile specificare un singolo valore, che applica un valore uniforme a tutti e quattro i lati del rettangolo di delimitamento.

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

Anche se il tipo dei valori di dati di uno spessore è Double, in genere si specificano valori interi.

Note sulla sintassi XAML

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

Anche se è possibile specificare uno Spessore come elemento oggetto, non è possibile specificare i singoli valori, ad esempio Gli attributi Top come 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 dello spessore. L'uso della sintassi dell'elemento oggetto per uno Spessore è utile se si vuole dichiarare una risorsa chiave che può essere usata da più istanze di Controllo per il riempimento. Per altre informazioni sul testo di inizializzazione XAML, vedere Guida alla sintassi XAML.

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

Proiezione e membri di Spessore

Se si usa un linguaggio Microsoft .NET (C# o Microsoft Visual Basic) o estensioni del componente Visual C++ (C++/CX), Spessore ha membri non dati disponibili e i relativi membri dati vengono esposti come proprietà di lettura-scrittura, non campi. Vedere Spessore nel browser API .NET.

Se si esegue la programmazione con C++/WinRT o la libreria modelli C++ (WRL) di Windows Runtime, esistono solo i campi membro dati come membri di Spessore e 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++ (SpessoreHelper)
Spessore(doppio)	FromUniformLength(Double)
Spessore(Double, Double, Double, Double, Double)	FromLengths(Double, Double, Double, Double)

Campi

Bottom	Misura del bordo inferiore dello spessore.
Left	Misura laterale sinistra dello spessore.
Right	Misura laterale destra dello spessore.
Top	Misura superiore del bordo dello spessore.

Vedi anche

• Border
• Control
• Definire layout con XAML