MediaElement.StretchDirection Property

Reference

Definition

Namespace:: System.Windows.Controls

Assembly:: PresentationFramework.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets a value that determines the restrictions on scaling that are applied to the image.

public:
 property System::Windows::Controls::StretchDirection StretchDirection { System::Windows::Controls::StretchDirection get(); void set(System::Windows::Controls::StretchDirection value); };

public System.Windows.Controls.StretchDirection StretchDirection { get; set; }

member this.StretchDirection : System.Windows.Controls.StretchDirection with get, set

Public Property StretchDirection As StretchDirection

Property Value

StretchDirection

The value that specifies the direction the element is stretched. The default is Both.

Examples

<Page xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  x:Class="SDKSample.StretchMediaElementExample" >

  <StackPanel>
  <!-- This Canvas creates the bounding rectangle around the MediaElement.
       How the rendered media fills this rectangle depends on the value
       of the MediaElement's Stretch property. -->
    <StackPanel Width="380" Height="250" Background="Green" Orientation="Horizontal"  >
      <MediaElement Source="media\bee.wmv" Name="myMediaElement" Stretch="UniformToFill" 
       />
    </StackPanel>


    <!-- Buttons below change the value of the Stretch property. -->
    <Button Name="btnFill" Click="OnClickChangeStretch">Fill</Button>
    <Button Name="btnNone" Click="OnClickChangeStretch">None</Button>
    <Button Name="btnUniform" Click="OnClickChangeStretch">Uniform</Button>
    <Button Name="btnUniformToFill" Click="OnClickChangeStretch">UniformToFill</Button>
    <TextBlock Name="txt1"></TextBlock>
  </StackPanel>


</Page>

<Page xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  x:Class="SDKSample.StretchMediaElementExample" >

  <StackPanel>
  <!-- This Canvas creates the bounding rectangle around the MediaElement.
       How the rendered media fills this rectangle depends on the value
       of the MediaElement's Stretch property. -->
    <StackPanel Width="380" Height="250" Background="Green" Orientation="Horizontal"  >
      <MediaElement Source="media\bee.wmv" Name="myMediaElement" Stretch="UniformToFill" 
       />
    </StackPanel>


    <!-- Buttons below change the value of the Stretch property. -->
    <Button Name="btnFill" Click="OnClickChangeStretch">Fill</Button>
    <Button Name="btnNone" Click="OnClickChangeStretch">None</Button>
    <Button Name="btnUniform" Click="OnClickChangeStretch">Uniform</Button>
    <Button Name="btnUniformToFill" Click="OnClickChangeStretch">UniformToFill</Button>
    <TextBlock Name="txt1"></TextBlock>
  </StackPanel>


</Page>

Remarks

Dependency Property Information

Item	Value
Identifier field	StretchDirectionProperty
Metadata properties set to `true`	AffectsMeasure

Applies to

Share via