Rect Структура

Определение

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

Windows.Foundation

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

public value class Rect

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.FoundationContract, 65536)]
struct Rect

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.FoundationContract), 65536)]
public struct Rect

var rect = {
x : /* Your value */,
y : /* Your value */,
width : /* Your value */,
height : /* Your value */
}

Public Structure Rect

<object property="x,y,width,height"/>
-or-
<object property="x y width height"/>

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

ValueType

Rect

Атрибуты

ContractVersionAttribute

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.FoundationContract (появилось в v1.0)

Комментарии

При применении к свойствам, представляющим сведения о пользовательском интерфейсе, значения ширины и высоты значения Rect представляют не зависящие от устройства пиксели. Значения x и y имеют неопределенную систему отсчета (это зависит от того, как применяется это значение), но часто представляют точку в пространстве координат окна приложения main.

Javascript: В JavaScript Rect — это объект с четырьмя элементами данных: x, y, ширина, высота. Кроме элементов данных (полей), API, перечисленные в списках элементов Rect, не применяются к программированию на JavaScript.

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

Использование атрибута объекта технически разрешено правилами синтаксического анализа СРЕДА ВЫПОЛНЕНИЯ WINDOWS XAML. Однако это использование не отображается, так как оно не используется часто.

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

Необходимо указать все четыре значения. "0,0" не является неявным значением по умолчанию для "x,y", и не существует других соглашений, которые могут анализировать менее 4 компонентов в строке.

Элемент Rect нельзя объявить как ресурс в XAML ResourceDictionary , так как Rect не является общим типом (дополнительные сведения см. в статье Ссылки на ресурсы ResourceDictionary и XAML).

Ректирует значения и как они интерпретируются свойствами

Размер — это аналогичная структура, использующая одну и ту же метафору высоты и ширины. Однако rect указывает исходную точку, а размер — нет. Как правило, Rect используется для API библиотеки графики, а размер — для представления и макета в пользовательском интерфейсе приложения, особенно для адаптивного макета (где позиционирование часто выполняется автоматически).

Типичное поведение значения Rect при применении к свойствам соответствует следующим принципам:

• Ширина и высота не могут быть отрицательными.
• X и Y могут быть отрицательными, в результате чего определение Rect находится за пределами координатной системы отсчета, если нет дополнительного перевода.
• X и Y могут иметь значение 0. Значение 0 также допустимо для ширины или высоты. (Однако, если к объекту Rect со значением 0 для ширины или высоты применяется rectangleGeometry, результирующая объект RectangleGeometry не отображается.)
• X, Y, Width и Height могут быть не целыми значениями с точки зрения допустимых значений. Однако обычно используются целочисленные значения. Пользовательский интерфейс XAML работает лучше всего, если расположения точек и единицы измерения не используют значения вложенных пикселей.

Языковая проекция и элементы Rect

Если вы используете язык Microsoft .NET (C# или Microsoft Visual Basic) или расширения компонентов Visual C++ (C++/CX), то в Rect доступны элементы, не являющиеся данными, а его элементы данных предоставляются как свойства чтения и записи, а не поля. См . раздел Rect в браузере API .NET.

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

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

.NET (Rect)	C++ (RectHelper)
Rect(Point, Point)	FromPoints(Point, Point)
Rect(Point, Size)	FromLocationAndSize(Point, Size)
Rect(Double, Double, Double, Double)	FromCoordinatesAndDimensions(Single, Single, Single, Single)
Нижнее	GetBottom(Rect)
Пустой	Пустой
IsEmpty	GetIsEmpty(Rect)
Слева	GetLeft(Rect)
Right	GetRight(Rect)
Top	GetTop(Rect)
Contains(Point)	Contains(Rect, Point)
Равно	Equals(Rect, Rect)
Intersect(Rect)	Intersect(Rect, Rect)
Union(Point)	Union(Rect, Point)
Union(Rect)	Union(Rect, Rect)

Поля

Height	Высота прямоугольника в пикселях.
Width	Ширина прямоугольника в пикселях.
X	Координата по оси X верхнего левого угла прямоугольника.
Y	Координата по оси Y верхнего левого угла прямоугольника.

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

• Size
• RectHelper