Поделиться через


Rect Структура

Определение

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

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

Наследование
Rect
Атрибуты

Требования к 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 верхнего левого угла прямоугольника.

Применяется к

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