Image.Stretch Propriedade

Definição

Namespace:

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

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.