FrameworkElement.Margin プロパティ

リファレンス

定義

名前空間:: System.Windows

アセンブリ:: PresentationFramework.dll

重要

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

要素の外側の余白を取得または設定します。

public:
 property System::Windows::Thickness Margin { System::Windows::Thickness get(); void set(System::Windows::Thickness value); };

public System.Windows.Thickness Margin { get; set; }

member this.Margin : System.Windows.Thickness with get, set

Public Property Margin As Thickness

プロパティ値

Thickness

要素の余白の値を提供します。既定値は、すべてのプロパティが 0 (ゼロ) の Thickness です。

注釈

余白は、レイアウトでユーザーインターフェイス (UI) を作成するときに隣接するこの要素と他の要素の間のスペースです。共有要素はピア要素 (共通の親コントロールのコレクション内の他の要素など) であるか、この要素の親である場合もあります。

Margin は、余白を Thickness 非対称に設定できるように、数値ではなく構造体として設定されます。構造体自体は Thickness 文字列型変換をサポートしているため、XAML 属性構文でも非対称 Margin を指定できます。

0 以外の余白は、要素レイアウトの ActualWidth およびの外側にスペースを ActualHeight適用します。

余白は、レイアウト内の兄弟要素の加算です。たとえば、隣接するエッジに余白が 30 に設定されている 2 つの隣接する要素の間に 60 単位のスペースが設定されます。

余白が設定されている要素は、割り当てられた四角形スペースが余白と要素コンテンツ領域に十分な大きさでない場合、通常、指定された Margin のサイズを制限しません。レイアウトの計算時に、代わりに要素コンテンツ領域が制約されます。余白が制約される唯一のケースは、コンテンツが既にゼロに制限されている場合です。

XAML 属性の使用方法

<object Margin="left,top,right,bottom"/>

\- または -

<object Margin="left,top"/>

\- または -

<object Margin="thicknessReference"/>

XAML プロパティ要素の使用

<object>  
  <object.Margin>  
    <Thickness Left="left" Top="top" Right="right" Bottom="bottom"/>  
  </object.Margin>  
</object>

XAML 値

left、top、right、bottom
0 から構造体 PositiveInfinity の 4 つのディメンションプロパティ Thickness を指定する数値。

属性の使用法では、指定された順序で対称的かつ論理的に適用される省略された値も受け入れられます。たとえば、は、 Margin="20" すべてのプロパティが 20 に設定されたを意味 Thickness すると解釈されます。 Margin="20,50"はと 20 に設定され、Bottom Top 50 に設定されたを意味Thickness Left Rightすると解釈されます。

メジャーの既定の Thickness 単位は、デバイスに依存しない単位 (1/96 インチ) です。また、単位の型文字列 cm、 in、または pt を任意のメジャーに追加して、他の単位を指定することもできます。

XAML 属性として指定される数値は、小数点を指定する必要はありません (0 は許容され、0.0 として指定する必要はありません)。拡張アプリケーションマークアップ言語 (XAML) の使用方法の詳細については、「」を参照してください Thickness。

thicknessReference
既存 Thicknessのへのオブジェクト参照。これは、、、 }または } 参照である可能性があります。拡張アプリケーションマークアップ言語 (XAML) の使用方法の詳細については、「」を参照してください Thickness。

依存プロパティ情報


識別子フィールド	MarginProperty
に設定されたメタデータプロパティ `true`	AffectsMeasure

適用対象

こちらもご覧ください

Thickness

次の方法で共有