メインコンテンツへスキップ

StackPanel「コントロールを縦または横に並べる」 - WPF超入門

    1. StackPanelとは?

    StackPanelは、WPFで複数のコントロールを縦方向、または横方向に並べるためのレイアウト用パネルです。

    WPFには、GridやCanvasなど、さまざまなレイアウト用パネルがあります。

    その中でもStackPanelは、特に単純な仕組みを持っています。

    • コントロールを縦方向に並べる

    • コントロールを横方向に並べる

    • 配置した順番にコントロールが並ぶ

    • コントロールの大きさに応じて配置を調整する

    複雑な設定を必要とせず、複数のコントロールを順番に並べたい場合に便利です。

    WPFでGUIアプリを作る際に、使用頻度の高いパネルのひとつです。

    2. 基本的な使い方

    まずは、3つのボタンを縦方向に並べてみます。

    <StackPanel>
    
        <Button Content="ボタン1"/>
        <Button Content="ボタン2"/>
        <Button Content="ボタン3"/>
    
    </StackPanel>

    <text></text>

    この場合、ボタンは次の順番で表示されます。

    ┌──────────────┐
    │   ボタン1    │
    ├──────────────┤
    │   ボタン2    │
    ├──────────────┤
    │   ボタン3    │
    └──────────────┘

    StackPanelは、標準では縦方向にコントロールを配置します。

    つまり、次のように指定した場合と同じです。

    <StackPanel Orientation="Vertical">

    Orientationプロパティは、コントロールを並べる方向を指定するためのものです。

    • Vertical — 縦方向に並べる(既定値)

    • Horizontal — 横方向に並べる

    3. 横方向に並べる

    コントロールを横方向に並べる場合は、Orientation="Horizontal"を指定します。

    <StackPanel Orientation="Horizontal">
    
        <Button Content="ボタン1"/>
        <Button Content="ボタン2"/>
        <Button Content="ボタン3"/>
    
    </StackPanel>

    この場合、ボタンは次のように配置されます。

    ┌─────────┬─────────┬─────────┐
    │ ボタン1 │ ボタン2 │ ボタン3 │
    └─────────┴─────────┴─────────┘

    ボタンだけでなく、TextBlockやTextBoxなども同じように並べられます。

    例えば、次のような書き方ができます。

    <StackPanel Orientation="Horizontal">
    
        <TextBlock
            Text="名前:"
            VerticalAlignment="Center"/>
    
        <TextBox
            Width="200"/>
    
    </StackPanel>

    この場合、左側に「名前:」という文字列、右側に入力欄が表示されます。

    VerticalAlignment="Center"は、TextBlockを縦方向の中央に配置するための指定です。

    4. コントロールの間隔を調整する

    StackPanelでは、子コントロールのMarginを使用して間隔を調整できます。

    <StackPanel>
    
        <Button
            Content="ボタン1"
            Margin="0,0,0,10"/>
    
        <Button
            Content="ボタン2"
            Margin="0,0,0,10"/>
    
        <Button Content="ボタン3"/>
    
    </StackPanel>

    この場合、ボタンの間に10の余白が設けられます。

    Marginは、コントロールの外側の余白を指定するプロパティです。

    Margin="左,上,右,下"

    例えば、次のような指定ができます。

    • Margin="10" — 四方向に10の余白

    • Margin="10,5" — 左右に10、上下に5の余白

    • Margin="0,0,0,10" — 下側に10の余白

    なお、WPFのStackPanelには、子要素の間隔を一括指定するSpacingプロパティはありません。

    そのため、基本的にはMarginを使用して調整します。

    5. StackPanelを入れ子にする

    StackPanelの中に、別のStackPanelを配置することもできます。

    例えば、全体を縦方向に並べながら、一部分だけ横方向に並べる場合です。

    <StackPanel Margin="20">
    
        <TextBlock
            Text="名前を入力してください"
            Margin="0,0,0,5"/>
    
        <TextBox
            Margin="0,0,0,10"/>
    
        <StackPanel Orientation="Horizontal">
    
            <Button
                Content="OK"
                Width="100"
                Margin="0,0,10,0"/>
    
            <Button
                Content="キャンセル"
                Width="100"/>
    
        </StackPanel>
    
    </StackPanel>

    この場合、TextBlockとTextBoxは縦方向に並び、2つのボタンは横方向に並びます。

    StackPanelの入れ子を使えば、比較的簡単な画面構成ならGridを使用せずに作ることもできます。

    6. コントロールの配置と大きさ

    StackPanelでは、コントロールを並べる方向によって、サイズの扱いが変わります。

    例えば、縦方向のStackPanelでは、子コントロールは内容に応じた高さを確保して、上から順番に配置されます。

    一方、横方向については、標準では利用できる幅に合わせて引き伸ばされます。

    <StackPanel>
    
        <Button Content="幅を指定しないボタン"/>
    
        <Button
            Content="幅100のボタン"
            Width="100"/>
    
    </StackPanel>

    最初のボタンは横幅いっぱいに広がり、2番目のボタンは指定した幅100で表示されます。

    ボタンを中央に配置したい場合は、HorizontalAlignmentを使用します。

    <StackPanel>
    
        <Button
            Content="中央配置"
            Width="120"
            HorizontalAlignment="Center"/>
    
    </StackPanel>

    また、StackPanelでは、並べる方向に利用可能な空間があっても、子コントロールを自動的に均等配分するわけではありません。

    例えば、画面を上下2分割して、それぞれの領域をウィンドウの高さに合わせて伸縮させたい場合は、Gridの方が適しています。

    7. StackPanelの注意点

    自動的に折り返されない

    横方向のStackPanelに多数のコントロールを配置すると、表示領域の幅を超える場合があります。

    <StackPanel Orientation="Horizontal">
    
        <Button Content="ボタン1"/>
        <Button Content="ボタン2"/>
        <Button Content="ボタン3"/>
        <Button Content="ボタン4"/>
        <Button Content="ボタン5"/>
    
    </StackPanel>

    StackPanelは、表示領域の端まで達しても、自動的には折り返しません。

    折り返して配置したい場合は、WrapPanelという別のパネルが用意されています。

    画面全体のレイアウトにはGridが便利

    StackPanelは、コントロールを順番に並べる場合に便利ですが、複雑な画面構成にはあまり向いていません。

    例えば、次のような場合です。

    • 画面を上下左右に分割する

    • 複数の入力欄の位置をそろえる

    • ウィンドウのサイズに応じて表示領域を伸縮させる

    このような場合は、Gridを使用した方が簡単になることがあります。

    実際のアプリケーションでは、Gridで画面全体を構成し、その中にStackPanelを配置する方法もよく使われます。

    8. サンプル:簡単な設定画面

    最後に、StackPanelを使用して簡単な設定画面を作ってみます。

    今回はレイアウトの確認が目的なので、C#のコードビハインドは使用しません。

    MainWindow.xaml

    <Window
        x:Class="WpfApp1.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="StackPanel Sample"
        Width="450"
        Height="320">
    
        <StackPanel Margin="20">
    
            <TextBlock
                Text="アプリケーション設定"
                FontSize="20"
                FontWeight="Bold"
                Margin="0,0,0,20"/>
    
            <TextBlock
                Text="ユーザー名"
                Margin="0,0,0,5"/>
    
            <TextBox
                Height="30"
                Margin="0,0,0,15"/>
    
            <CheckBox
                Content="通知を有効にする"
                Margin="0,0,0,10"/>
    
            <CheckBox
                Content="起動時に自動実行する"
                Margin="0,0,0,20"/>
    
            <StackPanel Orientation="Horizontal"
                        HorizontalAlignment="Right">
    
                <Button
                    Content="保存"
                    Width="100"
                    Height="35"
                    Margin="0,0,10,0"/>
    
                <Button
                    Content="キャンセル"
                    Width="100"
                    Height="35"/>
    
            </StackPanel>
    
        </StackPanel>
    
    </Window>

    ※ WpfApp1は、使用するプロジェクトの名前空間に合わせて変更してください。

    このサンプルでは、全体を縦方向のStackPanelで構成しています。

    そして、最後の保存ボタンとキャンセルボタンだけ、横方向のStackPanelを使用しています。


    画像

    また、HorizontalAlignment="Right"を指定することで、ボタンのグループ全体を右寄せにしています。

    このように、StackPanelを組み合わせることで、シンプルな設定画面を作成できます。

    なお、ボタンには処理を実装していないため、クリックしても保存やキャンセルは実行されません。

    9. 最後に

    今回は、WPFのStackPanelについて、基本的な使い方を紹介しました。

    StackPanelは、コントロールを縦方向または横方向に並べるための、非常にシンプルなレイアウト用パネルです。

    基本的に覚えることは、次の3つです。

    • Orientation — コントロールを並べる方向

    • Margin — コントロール間の余白

    • HorizontalAlignment、VerticalAlignment — コントロールの配置位置

    特にOrientationを変更するだけで、縦方向と横方向を切り替えられる点は便利です。

    Gridと比べると機能は限定的ですが、単純にコントロールを並べたい場合には、StackPanelの方が簡潔に記述できます。

    Gridを画面全体の基本レイアウトに使用し、StackPanelを部分的な配置に使用するなど、目的に応じて使い分けると良いでしょう。


    参考資料

    あなたへのおすすめ