Thickness Struct
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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à
-
Thickness
- Attributi
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. |