Thickness 结构

定义

命名空间:

Windows.UI.Xaml

描述矩形边框的粗细。 四个 Double 值分别描述矩形的 左、 上、 右和 下 边。

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

继承

ValueType

Thickness

属性

ContractVersionAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

粗细值通常用于设置影响设置属性的对象布局的属性。 使用 Thickness 值的属性包括：

• FrameworkElement.Margin
• Control.Padding
• Border.BorderThickness 和 Control.BorderThickness
• 非控件类上的其他边距和填充属性，例如 RichTextBlock.Padding
• Image.NineGrid
• Shape.StrokeThickness
• ProgressBarTemplateSettings.EllipseOffset

在 XAML 中，可以通过多种方式指定 Thickness 值。 如果指定四个 Double 值，则分别表示边框的 左、 上、 右和 下 边。 如果指定两个值，则这些值表示 Left、 Top 值，并将相同的值应用于 Right 和 Bottom ，以便生成的 Thickness 在水平上是等角和垂直等角。 还可以提供单个值，该值将统一值应用于边界矩形的所有四边。

从代码中分配的值没有任何可以推断值的行为。 如果为 Left 属性或字段设置值，则不会自动为 Right 建立相同的值。 必须在代码中单独设置所有 Thickness 属性。 可以使用 Thickness (Double) 或 Thickness (Double、Double、Double、Double) 构造函数，而不是将值赋给属性。

尽管 Thickness 的数据值的类型为 Double，但通常指定整数值。

XAML 语法说明

指定三个值的字符串不会导致分析程序错误，但只解释前两个值，并且忽略任何第三个值。

尽管可以将 Thickness 指定为对象元素，但不能将单个值（如 Top ）指定为该对象元素的属性。 XAML 分析程序不支持为此结构设置 XAML 属性值。 相反，必须将值指定为 Thickness 中的初始化文本。 如果要声明可由多个 Control 实例用于其 填充的键控资源，则对 Thickness 使用对象元素语法非常有用。 有关 XAML 初始化文本的详细信息，请参阅 XAML 语法指南。

可以使用空格而不是逗号作为值之间的分隔符。

投影和厚度的成员

如果使用 Microsoft .NET 语言 (C# 或 Microsoft Visual Basic) ，或 Visual C++ 组件扩展 (C++/CX) ，则 Thickness 具有可用的非数据成员，并且其数据成员公开为读写属性，而不是字段。 请参阅 .NET API 浏览器中的 粗细 。

如果使用 C++/WinRT 或 Windows 运行时 C++ 模板库 (WRL) 进行编程，则只有数据成员字段作为 Thickness 的成员存在，并且不能使用 .NET 投影的实用工具方法或属性。 C++ 代码可以访问 ThicknessHelper 类中存在的类似实用工具方法。

此表显示了 .NET 和 C++ 中可用的等效方法。

.NET (厚度)	C++ (ThicknessHelper)
厚度 (双)	FromUniformLength (Double)
厚度 (双、双、双、双)	FromLengths (Double， Double， Double， Double)

字段

Bottom	厚度的下边缘度量值。
Left	厚度的左侧度量值。
Right	厚度的右侧度量值。
Top	厚度的上边缘度量值。

另请参阅

• Border
• Control
• 使用 XAML 定义布局