Partilhar via


Rect Estrutura

Definição

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

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.

Aplica-se a

Confira também