Thickness Estructura
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
-
Thickness
- Atributos
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. |