Thickness Структура
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
public value class Thickness/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
struct Thickness[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public struct ThicknessPublic 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
- Атрибуты
Требования к Windows
| Семейство устройств |
Windows 10 (появилось в 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (появилось в v1.0)
|
Комментарии
Значения толщины обычно используются для задания свойств, влияющих на макет объекта, в котором задано свойство. Свойства, использующие значение Толщины, включают:
- FrameworkElement.Margin
- Control.Padding
- Border.BorderThickness и Control.BorderThickness
- Другие свойства Margin и Padding для классов, которые не являются элементом управления, например RichTextBlock.Padding
- Image.NineGrid
- Shape.StrokeThickness
- ProgressBarTemplateSettings.EllipseOffset
В XAML значения Толщины можно указать несколькими способами. Если указать четыре значения Double , они представляют левую, верхнюю, правую и нижнюю стороны ограничивающего прямоугольника соответственно. Если указать два значения, они представляют значения Left и Top , а также применяют одинаковые значения к правому и нижнему значениям, чтобы итоговая толщина была изометрической горизонтальной и изометричной по вертикали. Можно также указать одно значение, которое применяет однородное значение ко всем четырем сторонам ограничивающего прямоугольника.
Значения, назначенные из кода, не имеют поведения, которое может экстраполировать значения. Если задать значение для свойства Или поля Left , вы не будете автоматически устанавливать то же значение для параметра Right. Все свойства Толщины должны быть заданы дискретно в коде. Вместо назначения значений свойствам можно использовать конструкторы Thickness(Double) или Thickness(Double,Double,Double).
Хотя тип значений данных в Элементе Толщины — Double, обычно указываются целочисленные значения.
Примечания по синтаксису XAML
Строка, указывающая три значения, не вызывает ошибку средства синтаксического анализа, но интерпретируются только первые два значения, а любое третье значение игнорируется.
Хотя вы можете указать Толщину как объектный элемент, нельзя указать отдельные значения, такие как Top , в качестве атрибутов этого элемента объекта. Средство синтаксического анализа XAML не поддерживает установку значений атрибутов XAML для этой структуры. Вместо этого необходимо указать значения в виде текста инициализации в элементе Толщина. Использование синтаксиса объектного элемента для элемента Thickness полезно, если вы хотите объявить ресурс с ключом, который может использоваться несколькими экземплярами элемента управления для их заполнения. Дополнительные сведения о тексте инициализации XAML см. в руководстве по синтаксису XAML.
В качестве разделителя между значениями можно использовать пробел, а не запятую.
Проекция и элементы толщины
Если вы используете язык Microsoft .NET (C# или Microsoft Visual Basic) или расширения компонентов Visual C++ (C++/CX), то у Толщины доступны элементы, не относящиеся к данным, и члены данных предоставляются как свойства чтения и записи, а не поля. См. статью Толщина в браузере 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 |
Верхняя реберная мера толщины. |