Rect Estrutura

Definição

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

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++.

Campos

Aplica-se a

Confira também

• Size
• RectHelper