Thickness 結構
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
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 ThicknessPublic 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" ... />
- 繼承
-
Thickness
- 屬性
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 |
粗細的上邊緣量值。 |