Rect Estrutura

Definição

Namespace:

Windows.Foundation

Contém valores numéricos que representam o local e o tamanho de um retâ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"/>

Herança

ValueType

Rect

Atributos

ContractVersionAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.FoundationContract (introduzida na v1.0)

Comentários

Quando aplicado a propriedades que representam informações da interface do usuário, os valores de largura e altura de um valor rect representam pixels independentes do dispositivo. Os valores x e y têm um quadro de referência indeterminado (depende de como esse valor é aplicado), mas geralmente representam um ponto no espaço de coordenadas da janela do aplicativo main.

Javascript: No JavaScript, um Rect é um objeto com quatro membros de dados: x, y, largura, altura. Além dos membros de dados (campos), a API listada nas listas de membros da Rect não se aplica à programação JavaScript.

Anotações sobre a sintaxe XAML

O uso do atributo de objeto é tecnicamente permitido pelas regras de análise XAML Windows Runtime. No entanto, esse uso não é mostrado porque não é comumente usado.

Você pode usar um espaço em vez de uma vírgula como o delimitador entre valores. Usos de delimitadores mistos também são permitidos.

Você deve especificar todos os quatro valores. "0,0" não é um padrão implícito para "x,y" e não existem outras convenções que possam analisar menos de 4 componentes na cadeia de caracteres.

Um elemento Rect não pode ser declarado como um recurso em um ResourceDictionary XAML porque Rect não é um tipo compartilhável (para obter mais informações, consulte Referências de recursos ResourceDictionary e XAML).

Rect values and how they are interpreted by properties

Size é uma estrutura semelhante que usa a mesma metáfora de altura e largura. No entanto, uma Rect especifica um ponto de origem, enquanto um Tamanho não. Normalmente, Rect é usado para a API da biblioteca de gráficos, e Size é usado para apresentação e layout na interface do usuário do aplicativo, especialmente para layout adaptável (em que o posicionamento geralmente é automático).

O comportamento típico de um valor rect quando aplicado às propriedades segue estes princípios:

• Largura e Altura não podem ser negativos.
• X e Y podem ser negativos, com o resultado de que a definição de Rect está fora do quadro de coordenadas de referência, a menos que haja tradução adicional.
• X e Y podem ser 0. Um valor igual a 0 também é válido para Width ou Height. (No entanto, se um Rect com um valor de 0 para Width ou Height for aplicado a um RectangleGeometry, o RectangleGeometry resultante não será renderizado.)
• X, Y, Width e Height podem ser valores não inteiros em termos de valores permitidos. No entanto, normalmente você usa valores inteiros. A interface do usuário XAML se comporta melhor quando os locais de ponto e as medidas de unidade não usam valores de sub pixel.

Projeção de linguagem e membros do Rect

Se você estiver usando uma linguagem Microsoft .NET (C# ou Microsoft Visual Basic) ou extensões de componente do Visual C++ (C++/CX), a Rect terá membros não-dados disponíveis e seus membros de dados serão expostos como propriedades de leitura/gravação, não campos. Consulte Rect no Navegador de API do .NET.

Se você estiver programando com C++/WinRT ou a WRL (Biblioteca de Modelos Windows Runtime C++), somente os campos de membro de dados existirão como membros do Rect e você não poderá usar os métodos ou propriedades do utilitário da projeção do .NET. O código C++ pode acessar métodos de utilitário semelhantes que estão disponíveis na classe estática RectHelper .

Esta tabela mostra os métodos equivalentes disponíveis no .NET e no 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)
Menor	GetBottom(Rect)
Empty (vazio)	Empty (vazio)
IsEmpty	GetIsEmpty(Rect)
Left	GetLeft(Rect)
Right	GetRight(Rect)
Top	GetTop(Rect)
Contains(Point)	Contains(Rect, Point)
Igual a	Equals(Rect, Rect)
Intersect(Rect)	Intersect(Rect, Rect)
Union(Point)	Union(Rect, Point)
Union(Rect)	Union(Rect, Rect)

Campos

Height	A altura do retângulo, em pixels.
Width	A largura do retângulo, em pixels.
X	A coordenada X do canto superior esquerdo do retângulo.
Y	A coordenada y do canto superior esquerdo do retângulo.

Confira também

• Size
• RectHelper