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 (нулю).

Комментарии

Поле — это пространство между этим элементом и другими элементами, которые будут находиться рядом, когда макет создает пользовательский интерфейс. Общие элементы могут быть одноранговым элементом (например, другими элементами в коллекции общего родительского элемента управления) или родительскими элементами этого элемента.

Margin задается как структура, Thickness а не как число, чтобы поле можно было задать асимметрично. Сама Thickness структура поддерживает преобразование строковых типов, чтобы можно было также указать асимметричный Margin атрибут в синтаксисе атрибута XAML.

Ненулевое поле применяет пространство за пределами макета ActualWidth элемента и ActualHeight.

Поля являются аддитивными для элементов того же уровня в макете; Например, два смежных элемента с полем 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

left, top, right, bottom
Числовые значения в диапазоне от 0 до PositiveInfinity , указывающие четыре возможных свойства Thickness измерения структуры.

Использование атрибута также будет принимать сокращенные значения, которые применяются в указанном порядке, симметрично и логически. Например, Margin="20" будет интерпретироваться как со Thickness всеми свойствами, равными 20. Margin="20,50" будет интерпретировано как со значением ThicknessLeft и Right значением 20, а Top для Bottom — значение 50.

Единицей измерения по Thickness умолчанию является устройство не зависят от устройства (1/96 дюйма). Вы также можете указать другие единицы измерения, добавив строки cmтипа единиц , inили pt к любой мере.

Числовые значения, предоставляемые в качестве атрибутов XAML, не должны указывать десятичные знаки (0 допустимо, не обязательно указывать как 0,0). Дополнительные сведения об использовании XAML см. в разделе Thickness.

thicknessReference
Ссылка на объект существующего Thicknessобъекта . Это может быть }ссылка , или } . Дополнительные сведения об использовании XAML см. в разделе Thickness.

Сведения о свойстве зависимостей

Поле идентификатора MarginProperty
Для свойств метаданных задано значение true AffectsMeasure

Применяется к

См. также раздел