FrameworkElement.Margin プロパティ

定義

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

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

プロパティ値

要素の余白の値を提供します。 既定値は、すべてのプロパティが 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 に設定され、BottomTop 50 に設定された を意味ThicknessLeftRightすると解釈されます。

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

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

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

依存プロパティ情報

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

適用対象

こちらもご覧ください