MediaElement.Stretch Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit une valeur qui décrit comment un élément MediaElement doit être étiré pour remplir le rectangle de destination.
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" />
Valeur de propriété
Valeur de l’énumération Stretch qui spécifie le rendu du média visuel source. La valeur par défaut est Uniform.
Exemples
Voici un code qui montre comment créer un effet de zoom, similaire à msZoom dans l’application Windows à l’aide de JavaScript. Le contenu MediaElement remplira tout l’espace de disposition tout en préservant le rapport d’aspect du contenu. Cela peut entraîner un rognage si le rapport d’aspect du contenu n’est pas le même que l’espace de disposition.
private void ToggleZoom(MediaElement media)
{
if (media.Stretch != Stretch.UniformToFill)
{
// zoom
media.Stretch = Stretch.UniformToFill;
}
else
{
// unzoom
media.Stretch = Stretch.Uniform;
}
}
Remarques
Voici ce que les valeurs Stretch représentent pour le contenu MediaElement :
- Aucun : la taille d’origine du contenu est conservée.
- Remplissage : le contenu est redimensionné pour remplir les dimensions de destination. Le format de la vidéo n’est pas conservé.
- UniformToFill : étire uniformément l’élément MediaElement pour remplir l’espace de disposition disponible tout en préservant le rapport d’aspect du contenu. Si le rapport d’aspect du rectangle de destination diffère de la source, le contenu source est coupé pour s’adapter aux dimensions de destination.
- Uniforme : étire uniformément l’élément MediaElement pour remplir l’espace de disposition tout en conservant le rapport d’aspect de l’image. Cela garantit que l’image entière est affichée, non faussée et non rognée. Cela peut entraîner une boîte à lettres ou un pillarboxing en haut ou sur les côtés de l’image, en fonction du rapport d’aspect du contenu.