Thickness Структура
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
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" ... />
- Наследование
-
Thickness
- Атрибуты
Комментарии
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 |
Нижняя реберная |
Left |
Левая боковая |
Right |
Правая боковая |
Top |
Мера |