Rect Estructura

Definición

Espacio de nombres:

Windows.Foundation

Contiene valores numéricos que representan la ubicación y el tamaño de un rectángulo.

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

Herencia

ValueType

Rect

Atributos

ContractVersionAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.FoundationContract (se introdujo en la versión v1.0)

Comentarios

Cuando se aplica a las propiedades que representan información de la interfaz de usuario, los valores de ancho y alto de un valor rect representan píxeles independientes del dispositivo. Los valores x e y tienen un marco de referencia indeterminado (depende de cómo se aplica este valor), pero a menudo representan un punto en el espacio de coordenadas de la ventana principal de la aplicación.

Javascript: En JavaScript, rect es un objeto con cuatro miembros de datos: x, y, width, height. Aparte de los miembros de datos (campos), la API enumerada en las listas de miembros de Rect no se aplica a la programación de JavaScript.

Notas sobre la sintaxis XAML

Técnicamente, el uso de atributos de objeto lo permiten las reglas de análisis de XAML de Windows Runtime. Sin embargo, ese uso no se muestra porque no se usa normalmente.

Puede usar un espacio en lugar de una coma como delimitador entre valores. También se permiten usos de delimitadores mixtos.

Debe especificar los cuatro valores. "0,0" no es un valor predeterminado implícito para "x,y", y no existen otras convenciones que puedan analizar menos de 4 componentes en la cadena.

Un elemento Rect no se puede declarar como un recurso en un ResourceDictionary XAML porque Rect no es un tipo que se puede compartir (para obtener más información, consulta Referencias a recursos ResourceDictionary y XAML).

Valores de rect y cómo se interpretan mediante propiedades

El tamaño es una estructura similar que usa la misma metáfora de alto y ancho. Sin embargo, un rect especifica un punto de origen, mientras que un tamaño no. Normalmente, Rect se usa para la API de biblioteca de gráficos y size se usa para la presentación y el diseño en la interfaz de usuario de la aplicación, especialmente para el diseño adaptable (donde el posicionamiento suele ser automático).

El comportamiento típico de un valor rect cuando se aplica a las propiedades sigue estos principios:

• El ancho y el alto no pueden ser negativos.
• X e Y pueden ser negativos, con el resultado de que la definición rect está fuera del marco de coordenada de referencia a menos que haya una traducción adicional.
• X e Y pueden ser 0. Un valor de 0 también es válido para Width o Height. (Sin embargo, si se aplica un rectángulo con un valor de 0 para Width o Height a rectangleGeometry, el rectangleGeometry resultante no se representa).
• X, Y, Width y Height pueden ser valores no enteros en términos de valores permitidos. Sin embargo, normalmente se usan valores enteros. La interfaz de usuario XAML se comporta mejor cuando las ubicaciones de puntos y las medidas unitarias no usan valores de sub píxeles.

Proyección de lenguaje y miembros de Rect

Si usa un lenguaje .NET de Microsoft (C# o Microsoft Visual Basic) o extensiones de componentes de Visual C++ (C++/CX), Rect tiene miembros que no son de datos disponibles y sus miembros de datos se exponen como propiedades de lectura y escritura, no campos. Consulte Rect en el explorador de API de .NET.

Si está programando con C++/WinRT o con la biblioteca de plantillas de C++ (WRL) de Windows Runtime, solo existen los campos de miembro de datos como miembros de Rect y no puede usar los métodos o propiedades de la utilidad de la proyección de .NET. El código de C++ puede tener acceso a métodos de utilidad similares que están disponibles en la clase estática RectHelper .

En esta tabla se muestran los métodos equivalentes disponibles en .NET y 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)
Bottom	GetBottom(Rect)
Vacía	Vacía
IsEmpty	GetIsEmpty(Rect)
Left	GetLeft(Rect)
Right	GetRight(Rect)
Top (Principales)	GetTop(Rect)
Contains(Point)	Contains(Rect, Point)
Es igual a	Equals(Rect, Rect)
Intersect(Rect)	Intersect(Rect, Rect)
Union(Point)	Union(Rect, Point)
Union(Rect)	Union(Rect, Rect)

Campos

Height	Alto del rectángulo, en píxeles.
Width	Ancho del rectángulo, en píxeles.
X	Coordenada X de la esquina superior izquierda del rectángulo.
Y	Coordenada Y de la esquina superior izquierda del rectángulo.

Consulte también

• Size
• RectHelper