FrameworkElement.Margin FrameworkElement.Margin FrameworkElement.Margin FrameworkElement.Margin Property


要素の外側の余白を取得または設定します。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)user interface (UI)レイアウトでが作成されるときに隣接する他の要素との間のスペースです。The margin is the space between this element and other elements that will be adjacent when layout creates the ユーザー インターフェイス (UI)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体自体は、属性構文の中でXAMLXAMLも非対称Marginを指定できるように、文字列型の変換をサポートしています。The Thickness structure itself supports string type conversion so that you can specify an asymmetric Margin in XAMLXAML 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"/>  


<object Margin="left,top"/>  


<object Margin="thicknessReference"/>  

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

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


left、top、right、bottomleft, top, right, bottom
構造Thickness体の4つPositiveInfinityの可能なディメンションプロパティを指定する 0 ~ の範囲の数値。Number 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"Thickness 、がBottomLeft 20にTop設定され、かつが50に設定されることを意味Rightします。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/96 インチ)device-independent unit (1/96th inch)です。The default unit for a Thickness measure is デバイスに依存しない単位 (1/96 インチ)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.

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

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

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

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