Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

FrameworkElement.VerticalAlignment Property

Gets or sets the vertical alignment characteristics applied to this element when it is composed within a parent element such as a panel or items control. This is a dependency property.

Namespace: System.Windows
Assembly: PresentationFramework (in presentationframework.dll)
XML Namespace:  http://schemas.microsoft.com/winfx/2006/xaml/presentation

public VerticalAlignment VerticalAlignment { get; set; }
/** @property */
public VerticalAlignment get_VerticalAlignment ()

/** @property */
public void set_VerticalAlignment (VerticalAlignment value)

public function get VerticalAlignment () : VerticalAlignment

public function set VerticalAlignment (value : VerticalAlignment)

<object VerticalAlignment="VerticalAlignment" .../>

Property Value

A vertical alignment setting. The default is Stretch.

Identifier field

VerticalAlignmentProperty

Metadata properties set to true

AffectsArrange

When Height and Width properties are explicitly set on an element, these measurements take layout precedent and cancel the regular effects of setting this property to Stretch.

VerticalAlignment is the Microsoft .NET property accessor for what is in reality a dependency property. This particular dependency property quite frequently has its apparent "default" value set differently in derived element classes, particularly controls. This generally occurs in one of two ways: the dependency property is re-registered to a particular derived class, but with different metadata for setting its defaults; or there is a default style being applied that sets that dependency property value differently. For example, the apparent "default" of VerticalAlignment for a ComboBoxItem control will be Center, even though ComboBoxItem inherits VerticalAlignment direct from FrameworkElement. This is because that value was reset within the default style of ComboBoxItem, within the style's control template.

Canvas does not use VerticalAlignment when composing layout, because Canvas is based on absolute positioning.

When inherited by ComboBoxItem or any derived classes, ComboBoxItem redefines the default value of this property to be Center.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.