FrameworkElement.HorizontalAlignment Свойство

public:
 property HorizontalAlignment HorizontalAlignment { HorizontalAlignment get(); void set(HorizontalAlignment value); };

HorizontalAlignment HorizontalAlignment();

void HorizontalAlignment(HorizontalAlignment value);

public HorizontalAlignment HorizontalAlignment { get; set; }

var horizontalAlignment = frameworkElement.horizontalAlignment;
frameworkElement.horizontalAlignment = horizontalAlignment;

Public Property HorizontalAlignment As HorizontalAlignment

<frameworkElement HorizontalAlignment="horizontalAlignmentMemberName"/>

Значение свойства

Параметр горизонтального выравнивания в качестве значения перечисления. Значение по умолчанию — Stretch.

Примеры

В этом примере для Center размещения элементов TextBlock в центре ячеек Сетки назначается HorizontalAlignment значение и вертикальныйAlignment.

<Grid x:Name="LayoutRoot" Background="Coral" Width="300" Height="100">
    <Grid.ColumnDefinitions>
        <ColumnDefinition />
        <ColumnDefinition />
    </Grid.ColumnDefinitions>
    <Grid.RowDefinitions>
        <RowDefinition />
        <RowDefinition />
    </Grid.RowDefinitions>
    <TextBlock Grid.Column="0" Grid.Row="0" Text="First Name" 
        HorizontalAlignment="Center" VerticalAlignment="Center" />
    <TextBlock Grid.Column="0" Grid.Row="1" Text="Last Name" 
        HorizontalAlignment="Center" VerticalAlignment="Center" />
    <TextBox Grid.Column="1" Grid.Row="0" />
    <TextBox Grid.Column="1" Grid.Row="1" />

</Grid>

Комментарии

Свойства выравнивания предназначены для указания требуемого макета контейнеру адаптивного макета. Обычно они задаются в дочерних элементах FrameworkElement и интерпретируются другим родительским объектом контейнера FrameworkElement (обычно производным классом ContentControl или производным классом Панели или, возможно, выступающим). Настройка свойств выравнивания для дочернего элемента не гарантирует, что все происходит; Поведение зависит от композиции макета и родительских элементов.

Если свойства высоты и ширины явно заданы или вычисляются для объекта, эти измерения более важны для типичной логики макета и могут отменять эффекты параметра HorizontalAlignmentStretch. Свойства ограничения макета (например , MaxWidth) также влияют на максимальный или минимальный размер макета для ситуации макета Stretch . Stretch — это значение по умолчанию, чтобы было проще использовать методы адаптивного макета в тех случаях, когда явного измерения нет. Но если имеется высота и ширина или вырезка, макет действует так, как если бы значение было Top для VerticalAlignment, обычно Left для HorizontalAlignment (Right для сведений о региональных параметрах справа налево или явных значений FlowDirection ). Дополнительные сведения см. в разделе Выравнивание, отступы и заполнение.

Холст не используется HorizontalAlignment при создании макета, так как Холст основан на абсолютном расположении. Как правило, значение HorizontalAlignment потенциально обрабатывается по-разному любым объектом, способным иметь один или несколько объектов FrameworkElement в качестве дочернего содержимого. Каждый такой родительский объект может иметь собственную логику макета.

Каждый элемент пользовательского интерфейса XAML может применять это свойство по-разному на основе наборов стилей для неявного стиля. Очевидное значение по умолчанию для HorizontalAlignment каждого элемента пользовательского интерфейса может отличаться. Например, элемент управления Button начинается со значения Left. Если элемент пользовательского интерфейса является элементом управления, HorizontalAlignment это значение также может повлиять на визуальный шаблон элемента управления.

В элементах управления содержимым шаблон элемента управления часто использует выражения расширения разметки {TemplateBinding} , чтобы привязать свойство HorizontalContentAlignment к HorizontalAlignment свойству определенного элемента в его шаблоне, например выступающий или элемент, используемый в качестве области содержимого.

См. также раздел

• Width
• VerticalAlignment
• выравнивание, отступ и заполнение