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. Значение по умолчанию — Thickness. Все свойства равны 0 (нулю).The default value is a Thickness with all properties equal to 0 (zero).

Комментарии

Поле — это пространство между этим элементом и другими элементами, которые будут смежными, когда макет создает пользовательский интерфейсuser interface (UI).The margin is the space between this element and other elements that will be adjacent when layout creates the пользовательский интерфейс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 сама по себе поддерживает преобразование строкового типа, чтобы можно было указать асимметричную Margin в синтаксисе XAMLXAML атрибутов.The Thickness structure itself supports string type conversion so that you can specify an asymmetric Margin in XAMLXAML attribute syntax also.

Ненулевое поле применяет пространство за пределами ActualWidth и ActualHeightмакета элемента.A non-zero margin applies space outside the element layout's ActualWidth and ActualHeight.

Поля являются аддитивными для одноуровневых элементов в макете. Например, два соседних элемента с полем, равным 30, задаются на соседнем крае, будут иметь 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.

Использование атрибута XAMLXAML Attribute Usage

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

- или --or-

<object Margin="left,top"/>  

- или --or-

<object Margin="thicknessReference"/>  

Использование элемента свойства XAMLXAML Property Element Usage

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

Значения XAMLXAML Values

слева, сверху, справа, снизуleft, top, right, bottom
Числовые значения в диапазоне от 0 до PositiveInfinity, указывающие четыре возможных свойства измерения структуры Thickness.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" будет интерпретироваться как Thickness со всеми свойствами, для которых задано значение 20.For instance, Margin="20" will be interpreted to mean a Thickness with all properties set to 20. Margin="20,50" будет интерпретироваться как Thickness с Left, а Right равным 20, а Top и Bottom — 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). Кроме того, можно указать другие единицы, добавив строки типа единиц измерения cm, inили 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). Дополнительные сведения об использовании Язык XAMLExtensible Application Markup Language (XAML) см. в разделе Thickness.For more information on Язык XAMLExtensible Application Markup Language (XAML) usage, see Thickness.

сиккнессреференцеthicknessReference
Ссылка на существующий Thickness.An object reference to an existing Thickness. Это может быть }, или } ссылку.This might be a }, a , or } reference. Дополнительные сведения об использовании Язык XAMLExtensible Application Markup Language (XAML) см. в разделе Thickness.For more information on Язык XAMLExtensible Application Markup Language (XAML) usage, see Thickness.

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

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

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

Дополнительно