FrameworkElement.Margin 屬性

定義

取得或設定項目的外邊界。

C#
public System.Windows.Thickness Margin { get; set; }

屬性值

提供項目的邊界值。 預設值為其所有屬性皆等於 0 (零) 的 Thickness

備註

邊界是這個元素與其他元素之間的空間,當版面配置建立使用者介面 (UI) 時,將會相鄰。 共用元素可能是對等專案 (,例如常見父控制項集合中的其他元素) ,也可能是這個專案的父系。

Margin 會設定為 結構, Thickness 而不是數位,以便以非對稱方式設定邊界。 結構 Thickness 本身支援字串類型轉換,因此您也可以在 XAML 屬性語法中指定非對稱 Margin

非零邊界會套用元素版面配置 和 ActualWidthActualHeight 以外的空間。

邊界是配置中同層級元素的加法;例如,在相鄰邊緣上設定 30 個邊界的兩個相鄰元素之間會有 60 個單位的空間。

如果分配的矩形空間不足以容納邊界加上元素內容區域,則已設定邊界的專案通常不會限制指定的 Margin 大小。 計算版面配置時,元素內容區域將會受到限制。 唯一限制邊界的情況也是內容已經限制為零。

XAML Attribute Usage

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

-或-

XAML
<object Margin="left,top"/>  

-或-

XAML
<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" 將會解譯為表示 Thickness 所有屬性都設定為 20 的 。 Margin="20,50" 將解譯為表示 ThicknessLeft 並將 Right 設定為 20, Top 並將 Bottom 設定為 50。

量值的預設單位 Thickness 是裝置獨立單位, (1/96 英吋) 。 您也可以將單位類型字串 cminpt 附加至任何量值,以指定其他單位。

提供為 XAML 屬性的數位值不需要指定小數點, (0 是可接受的,不需要提供為 0.0) 。 如需可延伸應用程式標記語言 (XAML) 使用方式的詳細資訊,請參閱 Thickness

thicknessReference
現有 Thickness 的物件參考。 這可能是 } 、、 或 } 參考。 如需可延伸應用程式標記語言 (XAML) 使用方式的詳細資訊,請參閱 Thickness

相依性屬性資訊

識別碼欄位 MarginProperty
設定為 的中繼資料屬性 true AffectsMeasure

適用於

產品 版本
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

另請參閱