StackPanel.Orientation Property (System.Windows.Controls)

Switch View :

ScriptFree

.NET Framework Class Library

StackPanel.Orientation Property

Gets or sets a value that indicates the dimension by which child elements are stacked.

Namespace: System.Windows.Controls
Assembly: PresentationFramework (in PresentationFramework.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

Syntax

Visual Basic

Public Property Orientation As Orientation
	Get
	Set

public Orientation Orientation { get; set; }

Visual C++

public:
property Orientation Orientation {
	Orientation get ();
	void set (Orientation value);
}

member Orientation : Orientation with get, set

XAML Attribute Usage

<object Orientation="Orientation" .../>

Property Value

Type: System.Windows.Controls.Orientation
The Orientation of child content.

Dependency Property Information

Identifier field	OrientationProperty
Metadata properties set to true	AffectsMeasure

Examples

The following example shows how to use the Orientation property to specify how elements within a StackPanel are stacked (one on top of the other or side by side).

XAML


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

  <!-- This StackPanel stacks two other StackPanels on top of each other. The
       first StackPanel stacks its items horizontally while the second stacks them
       vertically. -->
  <StackPanel>

    <!-- The items under this StackPanel are stacked horizontally. -->
    <StackPanel Orientation="Horizontal">
      <Border Background="SkyBlue">
        <TextBlock>Stacked Item #1</TextBlock>
      </Border>
      <Border Background="CadetBlue">
        <TextBlock>Stacked Item #2</TextBlock>
      </Border>
      <Border Background="LightGoldenRodYellow">
        <TextBlock>Stacked Item #3</TextBlock>
      </Border>
    </StackPanel>

    <!-- The items under this StackPanel are stacked Vertically. Note that Orientation 
         has a default value of "Vertical" but in this example the property is explicitely
         set for clarity. -->
    <StackPanel Orientation="Vertical">
      <Border Background="SkyBlue">
        <TextBlock>Stacked Item #1</TextBlock>
      </Border>
      <Border Background="CadetBlue">
        <TextBlock>Stacked Item #2</TextBlock>
      </Border>
      <Border Background="LightGoldenRodYellow">
        <TextBlock >Stacked Item #3</TextBlock>
      </Border>
    </StackPanel>
  </StackPanel>

</Page>

The screenshot below shows how this example renders.

More Code

How to: Create a StackPanel	This example shows how to create a StackPanel.
How to: Choose Between StackPanel and DockPanel	This example shows how to choose between using a StackPanel or a DockPanel when you stack content in a Panel.
How to: Horizontally or Vertically Align Content in a StackPanel	This example shows how to adjust the Orientation of content within a StackPanel element, and also how to adjust the HorizontalAlignment and VerticalAlignment of child content.

Version Information

.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

StackPanel Class

System.Windows.Controls Namespace

Other Resources

Panels Overview