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實例用於其 Padding的索引鍵資源，則使用 的物件 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 上邊緣量值。

適用於

另請參閱