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 引進)

備註

粗細值通常用來設定會影響設定屬性之物件的版面配置的屬性。 使用粗細值的屬性包括：

• FrameworkElement.Margin
• Control.Padding
• Border.BorderThickness 和 Control.BorderThickness
• 非 Control 類別的其他 Margin 和 Padding 屬性，例如 RichTextBlock.Padding
• Image.NineGrid
• Shape.StrokeThickness
• ProgressBarTemplateSettings.EllipseOffset

在 XAML 中，您可以透過數種方式指定 [粗細] 值。 如果您指定四個 Double 值，這些值分別代表周框的 左、 上、 右和 下 側。 如果您指定兩個值，則這些值代表 Left、 Top 值，也會將相同的值套用至 Right 和 Bottom ，讓產生的 [粗細] 水平和垂直軸垂直。 您也可以提供單一值，將統一值套用至周框的四邊。

從程式代碼指派的值沒有任何可推斷值的行為。 如果您設定 Left 屬性或字段的值，則不會自動為 Right 建立相同的值。 所有 Thickness 屬性都必須以離散方式在程式代碼中設定。 您可以使用 Double (Double) 或 Thickness (Double、Double、Double、Double) 建構函式，而不是將值指派給屬性。

雖然 Thickness 的數據值類型為 Double，但您通常會指定整數值。

XAML 語法注意事項

指定三個值的字串不會造成剖析器錯誤，但只會解譯前兩個值，而且會忽略任何第三個值。

雖然您可以將 Thickness 指定為物件專案，但您無法指定個別值，例如 Top 做為該物件元素的屬性。 XAML 剖析器不支援為此結構設定 XAML 屬性值。 相反地，您必須在 [粗細] 中將值指定為初始化文字。 如果您想要宣告多個 Control 實例用於 其 Padding 的索引鍵資源，使用 Thickness 的物件元素語法很有用。 如需 XAML 初始化文字的詳細資訊，請參閱 XAML 語法指南。

您可以使用空格，而不是逗號做為值之間的分隔符。

粗細的投影和成員

如果您使用 Microsoft .NET 語言 (C# 或 Microsoft Visual Basic) ，或 Visual C++ 元件延伸模組 (C++/CX) ，則 Thickness 具有非數據成員可用，而且其數據成員會公開為讀寫屬性，而非字段。 請參閱 .NET API 瀏覽器中的 粗細 。

如果您是使用 C++/WinRT 或Windows 執行階段 C++ 範本庫進行程式設計， (WRL) ，則只有數據成員欄位會以粗細的成員的形式存在，而且您無法使用 .NET 投影的公用程式方法或屬性。 C++ 程式代碼可以存取 在 ThicknessHelper 類別上存在的類似公用程式方法。

下表顯示 .NET 和 C++ 中可用的對等方法。

.NET (粗細)	C++ (ThicknessHelper)
雙) (粗細	FromUniformLength (Double)
粗細 (雙精度浮點數、雙精度浮點數、雙)	FromLengths (Double、Double、Double、Double)

欄位

Bottom	粗細的下邊緣量值。
Left	粗細的左側量值。
Right	粗細的右側量值。
Top	粗細的上邊緣量值。

另請參閱

• Border
• Control
• 使用 XAML 定義版面配置