Thickness 構造体

定義

名前空間:

Windows.UI.Xaml

四角形の枠の太さについて記述します。 4 つの 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 で導入)

注釈

太さの値は、通常、 プロパティが設定されているオブジェクトのレイアウトに影響を与えるプロパティを設定するために使用されます。 Thickness 値を使用するプロパティは次のとおりです。

• FrameworkElement.Margin
• Control.Padding
• Border.BorderThickness と Control.BorderThickness
• Control 以外のクラスの Margin プロパティと Padding プロパティ (RichTextBlock.Padding など)
• Image.NineGrid
• Shape.StrokeThickness
• ProgressBarTemplateSettings.EllipseOffset

XAML では、複数の方法で Thickness 値を指定できます。 4 つの Double 値を指定した場合、これらは外接する四角形の 左辺、 上辺、 右辺、 および下 辺をそれぞれ表します。 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 を使ったレイアウトの定義