Thickness 结构

  • 参考

定义

命名空间:
Microsoft.UI.Xaml
编辑

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

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" ... />
继承
ValueType
Thickness
属性
ContractVersionAttribute

注解

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

在 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 语法指南。

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

投影和厚度的成员

如果使用 C#，则 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

的下边缘度量值 Thickness。
Left

的左侧度量值 Thickness。
Right

的右侧度量值 Thickness。
Top

的上边缘度量值 Thickness。

适用于

另请参阅