匯出 (0) 列印
全部展開

FrameworkElement.Margin 屬性

更新:2007 年 11 月

取得或設定項目的外部邊界。這是相依性屬性。

命名空間:  System.Windows
組件:  PresentationFramework (在 PresentationFramework.dll 中)
針對 XAML 的 XMLNS: http://schemas.microsoft.com/winfx/xaml/presentation

public Thickness Margin { get; set; }
/** @property */
public Thickness get_Margin()
/** @property */
public  void set_Margin(Thickness value)

public function get Margin () : Thickness
public function set Margin (value : Thickness)
<object>
  <object.Margin>
    <Thickness Left="left" Top="top" Right="right" Bottom="bottom"/>
  </object.Margin>
</object>
<object Margin="left,top,right,bottom"/>
- or -
<object Margin="left,top"/>
- or -
<object Margin="thicknessReference"/>
left, right, top, bottom
                    數字值,介於 0 和 PositiveInfinity 之間,用於指定 Thickness 結構四種可能的維度 (Dimension) 屬性。
                
                    屬性使用方式也會接受縮寫值,並以所提供的順序,以對稱方式和邏輯方式套用。例如,Margin="20" 會解譯為 Thickness 的所有屬性都會設定為 20。Margin="20,50" 將會解譯為 Thickness 具有設定為 20 的 Left 和 Right,以及設定為 50 的 Top 和 Bottom。
                 Thickness 的預設的測量單位是與裝置無關的單位 (1/96 英吋)。您也可以藉由附加裝置單位類型字串 cm、in 或 pt 至任何測量單位,以指定其他單位。
                
                    數字值,提供做為 XAML 屬性,不需要指定小數點 (可接受 0,但不一定要 0.0 型式提供)。如需可延伸標記語言 (XAML) 使用方式的詳細資訊,請參閱 Thickness。
                thicknessReference
                    對現有 Thickness 的物件參考。這可以是 {Binding}}、{StaticResource} 或 {DynamicResource}} 參考。如需可延伸標記語言 (XAML) 使用方式的詳細資訊,請參閱 Thickness。
                

屬性值

型別:System.Windows.Thickness

提供項目的邊界值。預設值是一個 Thickness,其中具有所有等於 0 (零) 的屬性。

識別項欄位

MarginProperty

中繼資料屬性設為 true

AffectsMeasure

邊界是這個項目和其他項目之間的空間,當配置建立使用者介面 (UI) 時會使其相鄰。共用的項目可能是對等項目 (例如一般父控制項內集合中的其他項目),或者可能也是這個項目的父系。

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

非零的邊界會套用到項目配置的 ActualWidthActualHeight 以外的空間。

邊界可以在配置中附加至同層級 (Sibling) 項目,例如,兩個相鄰的項目都在其鄰接邊緣設定了 30 的邊界,則兩者之間可能會有 60 個單位的空間。

如果指定的矩形空間不足以容納邊界再加上項目內容區域,設定邊界的項目通常不會限制指定之 Margin 的大小。當計算配置時,將會改以限制項目內容區域。唯一也會限制邊界的情況是,已使用任何方式將內容限制為零時。

本範例說明如何變更程式碼後置 (Code-Behind) 中任何現有的邊界屬性值,以便設定 Margin 屬性。Margin 屬性是 FrameworkElement 基底項目的屬性,因此各種控制項和其他項目都會繼承這個屬性。如需完整範例,請參閱設定邊界範例

這個範例是以可延伸標記語言 (XAML) 撰寫,其中包含 XAML 所參考的程式碼後置檔案。該程式碼後置同時顯示成 C# 和 Microsoft Visual Basic .NET 版本。

<Button Click="OnClick" Margin="10" Name="btn1">
Click To See Change!!</Button>


void OnClick(object sender, RoutedEventArgs e)
{
    // Get the current value of the property.
    Thickness marginThickness = btn1.Margin;
    // If the current leftlength value of margin is set to 10 then change it to a new value.
    // Otherwise change it back to 10.
    if(marginThickness.Left == 10)
    {
         btn1.Margin = new Thickness(60);
    } else {
         btn1.Margin = new Thickness(10);
    }
}


如需完整範例,請參閱設定邊界範例

Windows Vista

.NET Framework 和 .NET Compact Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊,請參閱.NET Framework 系統需求

.NET Framework

支援版本:3.5、3.0

社群新增項目

新增
顯示:
© 2014 Microsoft