Thickness Estructura

Definición

Espacio de nombres:

Windows.UI.Xaml

Describe el grosor de un marco alrededor de un rectángulo. Cuatro valores Double describen los lados Izquierdo, Superior, Derecho e Inferior del rectángulo, respectivamente.

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

Herencia

ValueType

Thickness

Atributos

ContractVersionAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

Los valores de grosor se suelen usar para establecer propiedades que afectan al diseño del objeto donde se establece la propiedad. Entre las propiedades que usan un valor de Grosor se incluyen las siguientes:

• FrameworkElement.Margin
• Control.Padding
• Border.BorderThickness y Control.BorderThickness
• Otras propiedades Margin y Padding en clases que no son un Control, por ejemplo RichTextBlock.Padding
• Image.NineGrid
• Shape.StrokeThickness
• ProgressBarTemplateSettings.EllipseOffset

En XAML, puedes especificar valores de Grosor de varias maneras. Si especifica cuatro valores Double , estos representan los lados Izquierdo, Superior, Derecho e Inferior , respectivamente, del rectángulo delimitador. Si especifica dos valores, estos representan los valores Left, Top y también aplican los mismos valores a Right e Bottom , de modo que el grosor resultante sea isométrico horizontal e isométrico verticalmente. También puede proporcionar un valor único, que aplica un valor uniforme a los cuatro lados del rectángulo delimitador.

Los valores asignados desde el código no tienen ningún comportamiento que pueda extrapolar valores. Si establece el valor de una propiedad o campo Left , no establece automáticamente el mismo valor para Right. Todas las propiedades De grosor deben establecerse discretamente en el código. Puede usar los constructores Thickness(Double) o Thickness(Double,Double,Double,Double) en lugar de asignar valores a las propiedades.

Aunque el tipo de los valores de datos de un objeto Thickness es Double, normalmente se especifican valores enteros.

Notas sobre la sintaxis XAML

Una cadena que especifica tres valores no provoca un error del analizador, pero solo se interpretan los dos primeros valores y se omite cualquier tercer valor.

Aunque puede especificar un elemento Thickness como un elemento de objeto, no puede especificar los valores individuales como Top como atributos de ese elemento de objeto. El analizador XAML no admite el establecimiento de valores de atributo XAML para esta estructura. En su lugar, debe especificar los valores como texto de inicialización dentro del Grosor. El uso de la sintaxis del elemento de objeto para un objeto Thickness es útil si desea declarar un recurso con clave que pueden usar varias instancias de Control para su relleno. Para obtener más información sobre el texto de inicialización XAML, consulta La guía de sintaxis XAML.

Puede usar un espacio en lugar de una coma como delimitador entre valores.

Proyección y miembros de Thickness

Si usa un lenguaje Microsoft .NET (C# o Microsoft Visual Basic) o extensiones de componentes de Visual C++ (C++/CX), Thickness tiene miembros que no son de datos disponibles y sus miembros de datos se exponen como propiedades de lectura y escritura, no como campos. Consulte Grosor en el explorador de API de .NET.

Si está programando con C++/WinRT o con la biblioteca de plantillas de C++ (WRL) de Windows Runtime, solo existen los campos de miembro de datos como miembros de Thickness y no puede usar los métodos o propiedades de la utilidad de la proyección de .NET. El código de C++ puede tener acceso a métodos de utilidad similares que existen en la clase ThicknessHelper .

En esta tabla se muestran los métodos equivalentes disponibles en .NET y C++.

.NET (grosor)	C++ (ThicknessHelper)
Thickness(Double)	FromUniformLength(Double)
Thickness(Double, Double, Double, Double)	FromLengths(Double, Double, Double, Double)

Campos

Bottom	Medida de borde inferior del grosor.
Left	Medida del lado izquierdo del grosor.
Right	Medida del lado derecho del grosor.
Top	Medida de borde superior del grosor.

Consulte también

• Border
• Control
• Definir diseños con XAML