Control.HorizontalContentAlignment Property (System.Windows.Controls)

HorizontalContentAlignment Property

Switch on low bandwidth view

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework Class Library

Control..::.HorizontalContentAlignment Property

Gets or sets the horizontal alignment of the control's content. This is a dependency property.

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

Syntax

Visual Basic (Declaration)

<BindableAttribute(True)> _
Public Property HorizontalContentAlignment As HorizontalAlignment

Visual Basic (Usage)

Dim instance As Control
Dim value As HorizontalAlignment

value = instance.HorizontalContentAlignment

instance.HorizontalContentAlignment = value

[BindableAttribute(true)]
public HorizontalAlignment HorizontalContentAlignment { get; set; }

Visual C++

[BindableAttribute(true)]
public:
property HorizontalAlignment HorizontalContentAlignment {
    HorizontalAlignment get ();
    void set (HorizontalAlignment value);
}

JScript

public function get HorizontalContentAlignment () : HorizontalAlignment
public function set HorizontalContentAlignment (value : HorizontalAlignment)

XAML Attribute Usage

<object HorizontalContentAlignment="HorizontalAlignment" .../>

Property Value

Type: System.Windows..::.HorizontalAlignment
One of the HorizontalAlignment values. The default is HorizontalAlignment..::.Left.

Dependency Property Information

Identifier field	HorizontalContentAlignmentProperty
Metadata properties set to true	None

Remarks

In addition to Left, Right, and Center, you can set the HorizontalContentAlignment property to Stretch, which stretches the child element to fill the allocated space of the parent element. For more information, see Alignment, Margins, and Padding Overview.

This property only affects a control whose template uses the HorizontalContentAlignment property as a parameter. On other controls, this property has no impact.

Examples

The following example shows how to set the horizontal content alignment property of a control.

<Button Name="btn7" 
        HorizontalContentAlignment="Left"
        Click="ChangeHorizontalContentAlignment">
  HorizontalContentAlignment
</Button>

Visual Basic

Private Sub ChangeHorizontalContentAlignment(ByVal Sender As Object, ByVal e As RoutedEventArgs)

    If (btn7.HorizontalContentAlignment = HorizontalAlignment.Left) Then

        btn7.HorizontalContentAlignment = HorizontalAlignment.Right
        btn7.Content = "Control horizontal alignment changes from left to right."

    Else

        btn7.HorizontalContentAlignment = HorizontalAlignment.Left
        btn7.Content = "HorizontalContentAlignment"
    End If
End Sub

void ChangeHorizontalContentAlignment(object sender, RoutedEventArgs e)
{
    if (btn7.HorizontalContentAlignment == HorizontalAlignment.Left)
    {
        btn7.HorizontalContentAlignment = HorizontalAlignment.Right;
        btn7.Content = "Control horizontal alignment changes from left to right.";

    }
    else
    {
        btn7.HorizontalContentAlignment = HorizontalAlignment.Left;
        btn7.Content = "HorizontalContentAlignment";
    }
}

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

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

Version Information

.NET Framework

Supported in: 3.5, 3.0

Reference

Control Class

Control Members

System.Windows.Controls Namespace

Other Resources

Control Library