Thickness 構造体

定義

名前空間:

Windows.UI.Xaml

四角形の枠の太さについて記述します。 4 つの Double 値は、それぞれ四角形の Left、 Top、 Right、 Bottom の各辺を表します。

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
• コントロールではないクラスの他の Margin プロパティと Padding プロパティ (RichTextBlock.Padding など)
• Image.NineGrid
• Shape.StrokeThickness
• ProgressBarTemplateSettings.EllipseOffset

XAML では、複数の方法で Thickness 値を指定できます。 4 つの 倍精度浮動小数点型 (Double) の値を指定した場合、これらはそれぞれ外接する四角形の Left、 Top、 Right、 Bottom の各辺を表します。 2 つの値を指定した場合、これらは Left、 Top の値を表し、同じ値を Right と Bottom に適用して、結果の [太さ] が水平方向および等角法で垂直方向に等角になるようにします。 1 つの値を指定することもできます。これにより、境界四角形の 4 辺すべてに均一な値が適用されます。

コードから割り当てられた値には、値を外挿できる動作はありません。 Left プロパティまたはフィールドの値を設定した場合、Right に同じ値が自動的に設定されるわけではありません。 すべての Thickness プロパティは、コード内で個別に設定する必要があります。 Thickness(Double) または Thickness(Double,Double,Double,Double) コンストラクターは、プロパティに値を割り当てるのではなく使用できます。

Thickness のデータ値の型は Double ですが、通常は整数値を指定します。

XAML 構文に関する注意事項

3 つの値を指定する文字列はパーサー エラーを引き起こしませんが、最初の 2 つの値のみが解釈され、3 番目の値は無視されます。

オブジェクト要素として Thickness を指定することはできますが、 Top などの個々の値をそのオブジェクト要素の属性として指定することはできません。 XAML パーサーでは、この構造体の XAML 属性値の設定はサポートされていません。 代わりに、太さ内の初期化テキストとして値を指定する必要があります。 Thickness にオブジェクト要素構文を使用すると、複数の Control インスタンスで Padding に使用できるキー付きリソースを宣言する場合に便利です。 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)
Thickness(Double)	FromUniformLength(Double)
Thickness(Double, Double, Double, Double)	FromLengths(Double, Double, Double, Double)

フィールド

Bottom	[厚さ] の下端の測定値。
Left	[厚さ] の左側のメジャー。
Right	[厚さ] の右側のメジャー。
Top	太さの上端のメジャー。

こちらもご覧ください

• Border
• Control
• XAML を使ったレイアウトの定義