Image.Stretch Propriedade

Definição

Namespace:

Windows.UI.Xaml.Controls

Obtém ou define um valor que descreve como uma Imagem deve ser estendida para preencher o retângulo de destino.

public:
 property Stretch Stretch { Stretch get(); void set(Stretch value); };

Stretch Stretch();

void Stretch(Stretch value);

public Stretch Stretch { get; set; }

var stretch = image.stretch;
image.stretch = stretch;

Public Property Stretch As Stretch

<Image Stretch="stretchValue"/>

Valor da propriedade

Stretch

Um valor da enumeração Stretch que especifica como a imagem de origem é renderizada, se a Altura e/ou Largura da Imagem não forem especificadas explicitamente. O valor padrão é Uniform.

Comentários

O valor da propriedade Stretch só será relevante se a instância image ainda não estiver usando valores definidos explicitamente para a propriedade Height e/ou Width e se a instância image estiver dentro de um contêiner que pode esticar a imagem para preencher algum espaço disponível no layout. Se você definir o valor da propriedade Stretch como None, a imagem sempre manterá seu tamanho natural, mesmo que haja um contêiner de layout que possa esticá-la de outra forma. Para obter mais informações sobre o dimensionamento de imagens, consulte Comentários em Imagem.

Origens de imagens e dimensionamento

Você deve criar suas fontes de imagem em vários tamanhos recomendados, para garantir que seu aplicativo fique ótimo quando o Windows dimensioná-lo devido ao dimensionamento e resolução do dispositivo. Geralmente, essa é uma maneira melhor de lidar com o redimensionamento de imagem em vez de aplicar um valor stretch não padrão. Ao especificar Source para um Image, você pode usar uma convenção de nomenclatura que referencie automaticamente o recurso correto da escala atual. Para obter detalhes da convenção de nomenclatura e mais informações, consulte Carregar imagens e ativos personalizados para escala.

Para obter mais informações sobre como projetar para dimensionamento, consulte Introdução ao design de aplicativos do Windows.

Observação

Um valor Stretch de None não funciona para recursos de imagem destinados a dar suporte ao dimensionamento. O dimensionamento será detectado e o recurso dimensionado apropriado será carregado antes que as decisões de layout implícitas pelo valor None sejam aplicadas.