Thickness 構造体

リファレンス

定義

名前空間:: Windows.UI.Xaml

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

四角形の枠の太さについて記述します。 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	太さの上端のメジャー。

適用対象