Thickness Структура

Определение

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

Windows.UI.Xaml

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

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 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

Требования к 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	Верхняя реберная мера толщины.

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

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