FrameworkElement.VerticalAlignment プロパティ

定義

名前空間:

Microsoft.UI.Xaml

パネルや項目コントロールなどの親オブジェクトで構成されている場合に FrameworkElement に適用される垂直方向の配置特性を取得または設定します。

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

VerticalAlignment VerticalAlignment();

void VerticalAlignment(VerticalAlignment value);

public VerticalAlignment VerticalAlignment { get; set; }

var verticalAlignment = frameworkElement.verticalAlignment;
frameworkElement.verticalAlignment = verticalAlignment;

Public Property VerticalAlignment As VerticalAlignment

<frameworkElement VerticalAlignment="verticalAlignmentMemberName"/>

プロパティ値

VerticalAlignment

列挙体の値としての垂直方向の配置設定。 既定では、 Stretchです。

例

この例では、値Centerが HorizontalAlignmentVerticalAlignment に割り当てられ、Grid セルの中央に TextBlock 要素が配置されます。

<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 派生クラスまたは Panel 派生クラス、または発表者) によって解釈されます。 子要素に配置プロパティを設定しても、何も起こる保証はありません。動作は、レイアウト構成と関係する親要素によって異なります。

Height プロパティと Width プロパティがオブジェクトに対して明示的に設定または計算される場合、これらの測定値は一般的なレイアウト ロジックにとってより重要であり、Stretch に設定VerticalAlignmentした効果を取り消すことができます。 レイアウト制約プロパティ ( MaxHeight など) は、レイアウト状況の最大レイアウト サイズまたは最小レイアウト サイズ Stretch にも影響します。 Stretch は既定値であるため、明示的な測定がない場合にアダプティブ レイアウト手法を使用しやすくなります。 ただし、 と Width または のどちらかHeightのクリッピングがある場合、レイアウトは 値が のVerticalAlignment場合と同様に機能します。通常Leftは TopHorizontalAlignment (Right右から左のカルチャ情報または明示的な FlowDirection 値の場合)。 詳しくは、「配置、余白、およびパディング」をご覧ください。

は絶対配置に基づいているためCanvas、キャンバスはレイアウトを作成するときに使用VerticalAlignmentしません。 一般に、 の VerticalAlignment 値は、1 つ以上の FrameworkElement オブジェクトを子コンテンツとして持つことが可能なオブジェクトによって異なる方法で扱われる可能性があります。 このような各親オブジェクトは、独自のレイアウト ロジックを持つことができます。

各 XAML UI 要素は、暗黙的な スタイルのスタイル セッターに基づいて、このプロパティを異なる方法で適用する場合があります。 各 UI 要素の の明らかな "既定値" VerticalAlignment は異なる場合があります。 たとえば、 Button コントロールは 値 Centerで始まります。 UI 要素がコントロールの場合、値は VerticalAlignment コントロールのビジュアル テンプレートにも影響する可能性があります。

コンテンツ コントロールでは、多くの場合、コントロール テンプレートは {TemplateBinding} マークアップ拡張式を 使用して VerticalContentAlignment プロパティを VerticalAlignment 、発表者やコンテンツ領域として使用される要素などのテンプレート内の要素のプロパティにバインドします。

こちらもご覧ください

• Width
• HorizontalAlignment
• 配置、余白、およびパディング