FrameworkElement.Margin プロパティ


要素の外側の余白を取得または設定します。Gets or sets the outer margin of an element.

 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



要素の余白の値を提供します。Provides margin values for the element. 既定値は、すべてのプロパティが 0 (ゼロ) の Thickness です。The default value is a Thickness with all properties equal to 0 (zero).


余白は、レイアウトによってユーザーインターフェイス (UI) が作成されるときに、この要素と隣接する他の要素の間のスペースです。The margin is the space between this element and other elements that will be adjacent when layout creates the user interface (UI). 共有要素は、ピア要素 (共通の親コントロールのコレクション内の他の要素など) である場合もあれば、この要素の親である場合もあります。Shared elements might be peer elements (such as other elements in the collection of a common parent control), or might also be this element's parent.

Margin は、余白を Thickness 非対称に設定できるように、数値ではなく構造体として設定されます。Margin is set as a Thickness structure rather than as a number so that the margin can be set asymmetrically. Thickness構造体自体は、XAML 属性構文でも非対称を指定できるように、文字列型の変換をサポートして Margin います。The Thickness structure itself supports string type conversion so that you can specify an asymmetric Margin in XAML attribute syntax also.

0以外の余白は、要素のレイアウトとの外側にスペースを適用し ActualWidth ActualHeight ます。A non-zero margin applies space outside the element layout's ActualWidth and ActualHeight.

余白は、レイアウト内の兄弟要素に追加されます。たとえば、隣接する2つの要素が隣接するエッジに30を設定している場合、隣接する2つの要素の間に60単位の領域があります。Margins are additive for sibling elements in a layout; for example, two adjacent elements both with a margin of 30 set on the adjoining edge would have 60 units of space between them.

余白が設定されている要素は、割り当てられた Margin 四角形の領域が余白と要素のコンテンツ領域に十分な大きさでない場合は、通常、指定されたのサイズを制限しません。Elements that have margins set will not typically constrain the size of the specified Margin if the allotted rectangle space is not large enough for the margin plus the element content area. 要素のコンテンツ領域は、レイアウトが計算されるときに制約されます。The element content area will be constrained instead when layout is calculated. 余白が制限されるのは、コンテンツが既にゼロに制限されている場合のみです。The only case where margins would be constrained also is if the content is already constrained all the way to zero.

XAML 属性の使用方法XAML Attribute Usage

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

- または --or-

<object Margin="left,top"/>  

- または --or-

<object Margin="thicknessReference"/>  

XAML プロパティ要素の使用XAML Property Element Usage

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


left、top、right、bottomleft, top, right, bottom
PositiveInfinity構造体の4つの可能なディメンションプロパティを指定する 0 ~ の範囲の数値 ThicknessNumber values between 0 and PositiveInfinity that specify the four possible dimension properties of a Thickness structure.

属性の使用法では、指定された順序で適用される省略された値も、対称的かつ論理的に使用することもできます。The attribute usage will also accept abbreviated values that apply in the order provided, symmetrically and logically. たとえば、 Margin="20" は、 Thickness すべてのプロパティが20に設定されたを意味するように解釈されます。For instance, Margin="20" will be interpreted to mean a Thickness with all properties set to 20. Margin="20,50" は、が ThicknessLeft 20 に設定され、 Right かつが Top Bottom 50 に設定されることを意味します。Margin="20,50" will be interpreted to mean a Thickness with Left and Right set to 20, and Top and Bottom set to 50.

メジャーの既定の単位 Thickness は、デバイスに依存しない単位 (1/1/96 インチ) です。The default unit for a Thickness measure is device-independent unit (1/96th inch). また、単位の種類の文字列、 cm in 、またはを任意のメジャーに追加して、他の単位を指定することもでき pt ます。You can also specify other units by appending the unit type strings cm, in, or pt to any measure.

XAML 属性として指定された数値値は、小数点を指定する必要はありません (0 は許容されますが、0.0 として指定する必要はありません)。Number values provided as XAML attributes need not specify decimal points (0 is acceptable, does not have to be provided as 0.0). Extensible Application Markup Language (XAML) の使用方法の詳細については、「」を参照してください ThicknessFor more information on Extensible Application Markup Language (XAML) usage, see Thickness.

既存のへのオブジェクト参照 ThicknessAn object reference to an existing Thickness. これは、、、 } または } 参照です。This might be a }, a , or } reference. Extensible Application Markup Language (XAML) の使用方法の詳細については、「」を参照してください ThicknessFor more information on Extensible Application Markup Language (XAML) usage, see Thickness.

依存プロパティ情報Dependency Property Information

識別子フィールドIdentifier field MarginProperty
メタデータプロパティがに設定される trueMetadata properties set to true AffectsMeasure