MediaElement.Stretch Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece un valor que describe cómo se debe estirar un objeto MediaElement para rellenar el rectá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 de propiedad
Valor de la enumeración Stretch que especifica cómo se representa el medio visual de origen. El valor predeterminado es Uniform.
Ejemplos
Este es un código que muestra cómo crear un efecto de zoom, similar a msZoom en la aplicación de Windows mediante JavaScript. El contenido de MediaElement rellenará todo el espacio de diseño a la vez que conserva la relación de aspecto del contenido. Esto podría dar lugar a recortes si la relación de aspecto del contenido no es la misma que el espacio de diseño.
private void ToggleZoom(MediaElement media)
{
if (media.Stretch != Stretch.UniformToFill)
{
// zoom
media.Stretch = Stretch.UniformToFill;
}
else
{
// unzoom
media.Stretch = Stretch.Uniform;
}
}
Comentarios
Estos son los valores de Stretch que representan para el contenido de MediaElement :
- Ninguno: se conserva el tamaño original del contenido.
- Relleno: el contenido se cambia de tamaño para rellenar las dimensiones de destino. La relación de aspecto del vídeo no se conserva.
- UniformToFill: amplía uniformemente el objeto MediaElement para rellenar el espacio de diseño disponible, a la vez que conserva la relación de aspecto del contenido. Si la relación de aspecto del rectángulo de destino difiere del origen, el contenido de origen se recorta para ajustarse a las dimensiones de destino.
- Uniforme: amplía uniformemente el objeto MediaElement para rellenar el espacio de diseño, a la vez que conserva la relación de aspecto de la imagen. Esto garantizará que toda la imagen se muestre, no esté recortada y no esté recortada. Esto puede dar lugar a cuadros de letras o pillarboxing en la parte superior o lateral de la imagen, en función de la relación de aspecto del contenido.