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を指定できます。

ゼロ以外の余白は、要素レイアウトの ActualWidthActualHeightの外側にスペースを適用します。

余白は、レイアウト内の兄弟要素の加法です。たとえば、隣接するエッジに 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、bottomPositiveInfinity構造体の 4 つの可能なディメンション プロパティを指定する 0 ~ Thicknessの数値。

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

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

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

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

依存関係プロパティ情報

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

適用対象

こちらもご覧ください