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構造体自体には文字列型の変換がサポートされているため、非対称を指定できますMarginXAMLXAML属性構文もします。The Thickness structure itself supports string type conversion so that you can specify an asymmetric Margin in XAMLXAML attribute syntax also.

0 以外の余白は要素のレイアウトのActualWidthActualHeightします。A non-zero margin applies space outside the element layout's ActualWidth and ActualHeight.

余白は、レイアウトの兄弟要素の追加たとえば、2 つの隣接する要素が隣接する端に余白 30 をどちらも設定では、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. コンテンツが既に 0 に制約されていますもは余白が制限される場合だけです。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, bottom
番号を 0 までの値とPositiveInfinityの 4 つの考えられるディメンション プロパティを指定する、Thickness構造体。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" として解釈する、ThicknessLeftRightを 20 に設定し、TopBottom50 に設定します。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). 単位の種類の文字列を追加して、他の単位を指定することもcmin、またはpt測定値にします。You can also specify other units by appending the unit type strings cm, in, or pt to any measure.

数値として指定されたXAMLXAML属性は、10 進数のポイントを指定しない必要があります (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. これは、可能性があります、 }、a、または}参照。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