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

属性值

为元素提供边距值。 默认值为 Thickness 所有属性等于 0(零)。

注解

边距是此元素和其他元素之间的空格,当布局创建用户界面(UI)时,这些元素将相邻。 共享元素可能是对等元素(例如公共父控件集合中的其他元素),也可能是此元素的父元素。

Margin 设置为结构 Thickness 而不是数字,以便可以非对称设置边距。 结构 Thickness 本身支持字符串类型转换,以便还可以在 XAML 属性语法中指定非对称 Margin

非零边距在元素布局和元素布局ActualWidthActualHeight之外应用空间。

边距是布局中同级元素的累加性;例如,在相邻边缘上设置了 30 个边距的两个相邻元素之间将有 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 值

左、上、右、下 介于 0 和 PositiveInfinity 指定结构的四个 Thickness 可能维度属性之间的数字值。

属性用法还将接受按提供的、对称和逻辑顺序应用的缩写值。 例如, Margin="20" 将被解释为表示所有属性设置为 20 的一个 ThicknessMargin="20,50"将被解释为平均值ThicknessLeft,并Right设置为 20,并TopBottom设置为 50。

度量的默认单位是独立于设备的单位 Thickness (1/96 英寸)。 还可以通过追加单元类型字符串cmin或任何pt度量值来指定其他单位。

作为 XAML 属性提供的数字值不需要指定小数点(0 是可接受的,不必作为 0.0 提供)。 有关可扩展应用程序标记语言(XAML)用法的详细信息,请参阅 Thickness

thicknessReference 对现有 Thickness对象的引用。 这可能是一个 }、一个或 } 引用。 有关可扩展应用程序标记语言(XAML)用法的详细信息,请参阅 Thickness

Dependency 属性信息

项目 价值
标识符字段 MarginProperty
元数据属性设置为 true AffectsMeasure

适用于

另请参阅