Control.HorizontalContentAlignment Control.HorizontalContentAlignment Control.HorizontalContentAlignment Control.HorizontalContentAlignment Property


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

 property System::Windows::HorizontalAlignment HorizontalContentAlignment { System::Windows::HorizontalAlignment get(); void set(System::Windows::HorizontalAlignment value); };
public System.Windows.HorizontalAlignment HorizontalContentAlignment { get; set; }
member this.HorizontalContentAlignment : System.Windows.HorizontalAlignment with get, set
Public Property HorizontalContentAlignment As HorizontalAlignment

Property Value


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

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

        btn7.HorizontalContentAlignment = HorizontalAlignment.Left;
        btn7.Content = "HorizontalContentAlignment";
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


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.

Dependency Property Information

Identifier field HorizontalContentAlignmentProperty
Metadata properties set to true None

Applies to