Thickness Estrutura

Definição

Namespace:

Microsoft.UI.Xaml

Descreve a espessura de um quadro em torno de um retângulo. Quatro valores Duplos descrevem os lados Esquerdo, Superior, Direito e Inferior do retângulo, respectivamente.

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

Herança

ValueType

Thickness

Atributos

ContractVersionAttribute

Comentários

Thickness Os valores geralmente são usados para definir propriedades que afetam o layout do objeto em que a propriedade está definida. As propriedades que usam um Thickness valor incluem:

• FrameworkElement.Margin
• Control.Padding
• Border.BorderThickness e Control.BorderThickness
• Outras Margin propriedades e Padding em classes que não são um Controle, por exemplo , RichTextBlock.Padding
• Image.NineGrid
• Shape.StrokeThickness

No XAML, você pode especificar Thickness valores de várias maneiras. Se você especificar quatro Double valores, eles representam os lados Esquerdo, Superior, Direito e Inferior , respectivamente, do retângulo delimitador. Se você especificar dois valores, eles representam os Leftvalores , Top e também aplicarão os mesmos valores a Right e Bottom de modo que o resultante Thickness seja isométrico horizontalmente e isométrico verticalmente. Você também pode fornecer um único valor, que aplica um valor uniforme a todos os quatro lados do retângulo delimitador.

Os valores atribuídos do código não têm nenhum comportamento que possa extrapolar valores. Se você definir o valor de uma Left propriedade ou campo, não estabelecerá automaticamente o mesmo valor para Right. Todas as Thickness propriedades devem ser definidas discretamente no código. Você pode usar os construtores Thickness(Double) ou Thickness(Double,Double,Double,Double) em vez de atribuir valores a propriedades.

Embora o tipo dos valores de dados de um Thickness seja Double, você normalmente especifica valores inteiros.

Anotações sobre a sintaxe XAML

Uma cadeia de caracteres que especifica três valores não causa um erro de analisador, mas apenas os dois primeiros valores são interpretados e qualquer terceiro valor é ignorado.

Embora você possa especificar um Thickness como um elemento de objeto, não é possível especificar os valores individuais, como Top atributos desse elemento de objeto. O analisador XAML não dá suporte à definição de valores de atributo XAML para essa estrutura. Em vez disso, você deve especificar os valores como texto de inicialização dentro do Thickness. Usar a sintaxe do elemento de objeto para um Thickness será útil se você quiser declarar um recurso com chave que pode ser usado por várias instâncias de Controle para seu Preenchimento. Para obter mais informações sobre o texto de inicialização XAML, consulte Guia de sintaxe XAML.

Você pode usar um espaço em vez de uma vírgula como o delimitador entre valores.

Projeção e membros da espessura

Se você estiver usando C#, terá Thickness membros que não são de dados disponíveis e seus membros de dados serão expostos como propriedades de leitura/gravação, não campos. Confira Espessura na documentação da API do .NET.

Se você estiver programando com C++/WinRT ou a WRL (Biblioteca de Modelos do C++ Windows Runtime), somente os campos de membro de dados existirão como membros do Thicknesse você não poderá usar os métodos ou propriedades do utilitário da projeção do .NET. O código C++ pode acessar métodos utilitários semelhantes que existem na classe ThicknessHelper .

Esta tabela mostra os métodos equivalentes disponíveis no .NET e no C++.

.NET (espessura)	C++ (ThicknessHelper)
Espessura(Double)	FromUniformLength(Double)
Espessura(Double, Double, Double, Double)	FromLengths(Double, Double, Double, Double)

Campos

Bottom	A medida de borda inferior do Thickness.
Left	A medida do lado esquerdo do Thickness.
Right	A medida do lado direito do Thickness.
Top	A medida de borda superior do Thickness.

Confira também

• Border
• Control
• Definir layouts com XAML