MediaElement.Stretch Propriedade

Definição

Namespace:

Windows.UI.Xaml.Controls

Obtém ou define um valor que descreve como um MediaElement deve ser estendido 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 = mediaElement.stretch;
mediaElement.stretch = stretch;

Public Property Stretch As Stretch

<MediaElement Stretch="stretchMemberName" />

Valor da propriedade

Stretch

Um valor da enumeração Stretch que especifica como a mídia visual de origem é renderizada. O valor padrão é Uniform.

Exemplos

Aqui está um código que mostra como criar um efeito de zoom, semelhante ao msZoom no aplicativo do Windows usando JavaScript. O conteúdo do MediaElement preencherá todo o espaço de layout, preservando a taxa de proporção do conteúdo. Isso poderá resultar em corte se a taxa de proporção do conteúdo não for igual ao espaço de layout.

private void ToggleZoom(MediaElement media)
{
    if (media.Stretch != Stretch.UniformToFill)
    {
        // zoom
        media.Stretch = Stretch.UniformToFill;
    }
    else
    {
        // unzoom
        media.Stretch = Stretch.Uniform;
    }
}

Comentários

Veja o que os valores stretch representam para o conteúdo do MediaElement :

• Nenhum: o tamanho original do conteúdo é preservado.
• Preenchimento: o conteúdo é redimensionado para preencher as dimensões de destino. A taxa de proporção do vídeo não é preservada.
• UniformToFill: estende uniformemente o MediaElement para preencher o espaço de layout disponível, preservando a taxa de proporção do conteúdo. Se a taxa de proporção do retângulo de destino for diferente da origem, o conteúdo de origem será recortado para se ajustar às dimensões de destino.
• Uniforme: estende uniformemente o MediaElement para preencher o espaço de layout, preservando a taxa de proporção da imagem. Isso garantirá que toda a imagem seja exibida, sem diferenciação e não cortada. Isso pode resultar em caixa de correio ou pillarboxing na parte superior ou lateral da imagem, dependendo da taxa de proporção do conteúdo.

Confira também

• Stretch
• NaturalVideoHeight
• NaturalVideoWidth