MediaElement.StretchDirection Property

Definition

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

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

Identifier field	StretchDirectionProperty
Metadata properties set to true	AffectsMeasure

See also

• FlowDirection