Edit

Share via


Control.HorizontalContentAlignment Property

Definition

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

public:
 property System::Windows::HorizontalAlignment HorizontalContentAlignment { System::Windows::HorizontalAlignment get(); void set(System::Windows::HorizontalAlignment value); };
[System.ComponentModel.Bindable(true)]
public System.Windows.HorizontalAlignment HorizontalContentAlignment { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.HorizontalContentAlignment : System.Windows.HorizontalAlignment with get, set
Public Property HorizontalContentAlignment As HorizontalAlignment

Property Value

One of the HorizontalAlignment values. The default is Left.

Attributes

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>
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";
    }
}
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

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.

Dependency Property Information

Item Value
Identifier field HorizontalContentAlignmentProperty
Metadata properties set to true None

Applies to