Control.HorizontalContentAlignment Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Gets or sets the horizontal alignment of the control's content.

Namespace:   System.Windows.Controls
Assembly:  PresentationFramework (in PresentationFramework.dll)

Public Property HorizontalContentAlignment As HorizontalAlignment

Property Value

Type: System.Windows.HorizontalAlignment

One of the HorizontalAlignment values. The default is HorizontalAlignment.Left.

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.

Identifier field


Metadata properties set to true


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

<Button Name="btn7" 
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."


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

.NET Framework
Available since 3.0
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Return to top