Thickness Estrutura

Definição

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 e Padding propriedades 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 representarão os lados Esquerdo, Superior, Direito e Inferior , respectivamente, do retângulo delimitador. Se você especificar dois valores, eles representarão os Leftvalores , Top e também aplicarão os mesmos valores Right e Bottom de modo que o resultado Thickness seja isométrico horizontal 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 de forma discreta 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 elemento como 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 é ú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 o guia de sintaxe XAML.

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

Projeção e membros da espessura

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

Se você estiver programando com C++/WinRT ou a BIBLIOTECA de Modelos do Windows Runtime C++ (WRL), somente os campos de membro de Thicknessdados existirão como membros e você não poderá usar os métodos ou propriedades do utilitário da projeção de .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 em .NET e C++.

Confira também

• Border
• Control
• Definir layouts com XAML