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

プロパティ値

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 値

左、上、右、下
0 PositiveInfinity から構造体の 4 つの可能なディメンション プロパティ Thickness を指定する数値。

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

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

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

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

依存プロパティ情報

識別子フィールド MarginProperty
メタデータのプロパティが次に設定されている true AffectsMeasure

適用対象

こちらもご覧ください