Thickness Структура

Определение

Пространство имен:

Microsoft.UI.Xaml

Определяет толщину рамки вокруг прямоугольника. Четыре значения Double описывают левую, верхнюю, правую и нижнюю стороны прямоугольника соответственно.

public value class Thickness

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
struct Thickness

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
public struct Thickness

Public Structure Thickness

<Thickness ...>uniform</Thickness>
- or -
<Thickness ...>left&right,top&bottom</Thickness>
- or -
<Thickness ...>left,top,right,bottom</Thickness>
- or -
<object property="uniform"/>
- or -
<object property="left&right,top&bottom"/>
- or -
<object property="left,top,right,bottom" ... />

Наследование

ValueType

Thickness

Атрибуты

ContractVersionAttribute

Комментарии

Thickness Значения обычно используются для задания свойств, влияющих на макет объекта, в котором задано свойство. Свойства, использующие значение, Thickness включают:

• FrameworkElement.Margin
• Control.Padding
• Border.BorderThickness и Control.BorderThickness
• Другие Margin свойства и Padding для классов, которые не являются элементом управления, например RichTextBlock.Padding
• Image.NineGrid
• Shape.StrokeThickness

В XAML можно указать Thickness значения несколькими способами. Если указать четыре Double значения, они представляют собой левую, верхнюю, правую и нижнюю стороны ограничивающего прямоугольника соответственно. Если указать два значения, они представляют Leftзначения , Top а также применяют одинаковые значения к Right и Bottom таким образом, чтобы результат Thickness был изометрическим по горизонтали и изометрией по вертикали. Можно также указать одно значение, которое применяет однородное значение ко всем четырем сторонам ограничивающего прямоугольника.

Значения, назначенные из кода, не имеют поведения, которое может экстраполировать значения. Если задано значение для Left свойства или поля, вы не будете автоматически устанавливать то же значение для Right. Все Thickness свойства должны быть заданы дискретно в коде. Вместо назначения значений свойствам можно использовать конструкторы Thickness(Double) или Thickness(Double,Double,Double).

Хотя типом значений Thickness данных является Double, обычно указываются целочисленные значения.

Примечания по синтаксису XAML

Строка, указывающая три значения, не вызывает ошибку средства синтаксического анализа, но интерпретируются только первые два значения, а любое третье значение игнорируется.

Хотя можно указать Thickness как объектный элемент, нельзя указать отдельные значения, например Top атрибуты этого элемента объекта. Средство синтаксического анализа XAML не поддерживает установку значений атрибутов XAML для этой структуры. Вместо этого необходимо указать значения в виде текста инициализации Thicknessв . Использование синтаксиса объектного элемента для для полезно, Thickness если вы хотите объявить ресурс с ключом, который может использоваться несколькими экземплярами control для их заполнения. Дополнительные сведения о тексте инициализации XAML см. в руководстве по синтаксису XAML.

В качестве разделителя между значениями можно использовать пробел, а не запятую.

Проекция и элементы толщины

Если вы используете C#, доступны Thickness элементы, не относящиеся к данным, и их члены данных предоставляются как свойства чтения и записи, а не поля. См. статью Толщина в документации по API .NET.

При программировании с помощью C++/WinRT или среда выполнения Windows библиотеки шаблонов C++ (WRL) в качестве членов Thicknessсуществуют только поля элемента данных и нельзя использовать служебные методы или свойства проекции .NET. Код C++ может обращаться к аналогичным служебным методам, которые существуют в классе ThicknessHelper .

В этой таблице показаны эквивалентные методы, доступные в .NET и C++.

.NET (толщина)	C++ (ThicknessHelper)
Толщина(двойной)	FromUniformLength(Double)
Толщина(Двойной, Двойной, Двойной, Двойной)	FromLengths(Double, Double, Double, Double)

Поля

Bottom	Нижняя реберная Thicknessмера .
Left	Левая боковая Thicknessмера .
Right	Правая боковая Thicknessмера объекта .
Top	Мера Thicknessверхнего края объекта .

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

• Border
• Control
• Определение макетов с помощью XAML