Thickness Estrutura
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 ThicknessPublic 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
-
Thickness
- Atributos
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
Marginpropriedades ePaddingem 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 |
| Left |
A medida do lado esquerdo do |
| Right |
A medida do lado direito do |
| Top |
A medida de borda superior do |