FrameworkElement.Margin プロパティ

定義

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

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

プロパティ値

要素の余白の値を提供します。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以外の余白は、要素のレイアウトの ActualWidthActualHeightの外側にスペースを適用します。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

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

XAML 値XAML Values

left、top、right、bottomleft, top, right, bottom
Thickness 構造体の4つの可能なディメンションプロパティを指定する0から PositiveInfinity までの数値。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" は、すべてのプロパティが20に設定された Thickness を意味します。For instance, Margin="20" will be interpreted to mean a Thickness with all properties set to 20. Margin="20,50"Right LeftThickness を20に設定し、TopBottom を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/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 属性として指定する数値には小数点を指定する必要があります (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.

thicknessReferencethicknessReference
既存の 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
メタデータプロパティが true に設定されるMetadata properties set to true AffectsMeasure

適用対象

こちらもご覧ください