コンボボックスとリストボックス

ユーザーが選択できる項目の一覧を提供するには、コンボボックス (ドロップダウンリストとも呼ばれる) を使用します。コンボボックスは、最初はコンパクトな状態で、展開すると選択可能な項目の一覧が表示されます。リストボックスはコンボボックスに似ていますが、折りたたむことができず、コンパクトな状態がありません。リストボックスの詳細については、この記事の最後で詳細を確認できます。

コンボボックスを閉じると、現在の選択が表示されるか、選択された項目がない場合は空です。ユーザーがコンボボックスを展開すると、選択可能な項目の一覧が表示されます。

コンパクトな状態のドロップダウンリストの画像。

これは適切なコントロールですか?

ドロップダウンリストを使用すると、ユーザーは 1 行のテキストで適切に表現できる項目のセットから 1 つの値を選択できます。
複数行のテキストまたは画像を含む項目を表示するには、コンボボックスではなく、リストビューまたはグリッドビューを使用します。
項目が 5 個未満の場合は、ラジオボタン (1 つの項目しか選択できない場合) またはチェックボックス (複数の項目を選択できる場合) の使用を検討してください。
選択項目がアプリのフローで二次的に重要な場合は、コンボボックスを使用します。ほとんどの状況でほとんどのユーザーに既定のオプションが推奨されている場合、リストビューを使用してすべてのアイテムを表示すると、必要以上にオプションに注意が向く可能性があります。コンボボックスを使用すると、領域を節約し、注意散漫を最小限に抑えることができます。

例示

コンパクトな状態のコンボボックスではヘッダーを表示できます。

コンパクトな状態のドロップダウンリストを示すスクリーンショット。

コンボボックスは、長い文字列の長さを表示するために拡張できますが、読みにくく長すぎる文字列は避けてください。

長いテキスト文字列を含むドロップダウンリストの例

コンボボックス内のコレクションが十分な長さである場合は、それに対応するようにスクロールバーが表示されます。リスト内の項目を論理的にグループ化します。

ドロップダウンリストのスクロールバーの例

推奨事項

コンボボックス項目のテキストコンテンツを 1 行に制限します。
コンボボックス内の項目を最も論理的な順序で並べ替えます。関連するオプションをグループ化し、最も一般的なオプションを上部に配置します。名前をアルファベット順、数値順に並べ替え、日付を時系列で並べ替えます。

リストボックス

リストボックスを使用すると、ユーザーはコレクションから 1 つの項目または複数の項目を選択できます。リストボックスはドロップダウンリストに似ていますが、リストボックスは常に開いています。リストボックスのコンパクトな (展開されていない) 状態はありません。すべてを表示するスペースがない場合は、リスト内の項目をスクロールできます。

リストボックスは適切なコントロールですか?

リストボックスは、リスト内の項目が目立つように表示するのに重要な場合や、完全なリストを表示するのに十分な画面スペースがある場合に役立ちます。
リストボックスを使用すると、ユーザーは、重要な選択肢の完全な一式に注意を向けることができます。これに対し、ドロップダウンリストを使用すると、ユーザーは、最初に選択した項目に注意が向きます。
次の場合は、リストボックスを使用しないでください。
- リストの項目の数が非常に少ない。常に同じ 2 つのオプションを持つ単一選択リストボックスは、ラジオボタンとして表示することをお勧めします。また、リストに 3 つまたは 4 つの静的項目がある場合は、ラジオボタンの使用も検討してください。
- リストボックスが単一選択であり、オプションが常に同じ 2 項目で、その一方が他方の否定を意味している場合 ("オン" と "オフ" など)。このような場合は、単一のチェックボックスまたは切り替えスイッチを使用してください。
- 非常に多くの項目がある。長いリストの場合は、グリッドビューとリストビューを選択することをお勧めします。グループ化されたデータの非常に長いリストの場合は、セマンティックズームが推奨されます。
- 項目が連続した数値である。その場合は、スライダーの使用を検討してください。
- 選択項目は、アプリのフローにおいて二次的な重要性を持っているか、ほとんどの状況でほとんどのユーザーに対して既定のオプションが推奨されます。代わりにドロップダウンリストを使用してください。

リストボックスについての推奨事項

リストボックス内のアイテムの理想的な範囲は 3 ~ 9 です。
リストボックスは、項目が動的に変化する場合に適切に機能します。
可能であれば、リストボックスのサイズを設定して、項目のリストをパンまたはスクロールする必要がないようにします。
リストボックスの目的と、現在選択されている項目が明確であることを確認します。
タッチフィードバックと、選択した項目の状態の視覚効果とアニメーションを予約します。
リストボックス項目のテキストコンテンツを 1 行に制限します。項目がビジュアルの場合は、サイズをカスタマイズできます。項目に複数行のテキストまたは画像が含まれている場合は、代わりにグリッドビューまたはリストビューを使用します。
ブランドのガイドラインで別のフォントを使用することが示されていない限り、既定のフォントを使用します。
リストボックスを使用してコマンドを実行したり、他のコントロールを動的に表示または非表示にしたりしないでください。

コンボボックスを作成する

重要な API: ComboBox クラス、IsEditable プロパティ、Text プロパティ、TextSubmitted イベント、ListBox クラス

WinUI 3 ギャラリーアプリを開き、ComboBox の動作を確認する

WinUI 3 ギャラリーアイコン WinUI 3 ギャラリーアプリには、WinUI コントロールと機能の対話型の例が含まれています。 Microsoft Store からアプリを取得するか、GitHub でソースコードを参照します。

コンボボックスを設定するには、オブジェクトを直接 Items コレクションに追加するか、データソースに ItemsSource プロパティをバインドします。 ComboBox に追加した項目は、ComboBoxItem コンテナーにラップされます。

XAML で追加した項目を含むシンプルなコンボボックスを次に示します。

<ComboBox Header="Colors" PlaceholderText="Pick a color" Width="200">
    <x:String>Blue</x:String>
    <x:String>Green</x:String>
    <x:String>Red</x:String>
    <x:String>Yellow</x:String>
</ComboBox>

次の例では、FontFamily オブジェクトのコレクションへのコンボボックスのバインディングを示します。

<ComboBox x:Name="FontsCombo" Header="Fonts" Height="44" Width="296"
          ItemsSource="{x:Bind fonts}" DisplayMemberPath="Source"/>

ObservableCollection<FontFamily> fonts = new ObservableCollection<FontFamily>()
{
    fonts.Add(new FontFamily("Arial"));
    fonts.Add(new FontFamily("Courier New"));
    fonts.Add(new FontFamily("Times New Roman"));
};

項目の選択

ListView や GridView のように、ComboBox は Selector から派生するため、標準と同じ方法でユーザーの選択を取得できます。

SelectedItem プロパティを使用して、コンボボックスの選択された項目を取得または設定することができ、SelectedIndex プロパティを使用して、選択された項目のインデックスを取得または設定することができます。

選択されたデータ項目の特定のプロパティの値を取得するには、SelectedValue プロパティを使用できます。この場合は、SelectedValuePath を設定して、選択された項目のどのプロパティの値を取得するかを指定します。

ヒント

既定の選択を示すために SelectedItem または SelectedIndex を設定する場合、コンボボックスの Items コレクションを設定する前にプロパティを設定すると、例外が発生します。 XAML で Items を定義しない場合は、コンボボックスの Loaded イベントを処理し、Loaded イベントハンドラー内に SelectedItem または SelectedIndex を設定することをお勧めします。

XAML でこれらのプロパティにバインドするか、SelectionChanged イベントを処理して、選択の変更に応答することができます。

イベントハンドラーのコードでは、SelectionChangedEventArgs.AddedItems プロパティから、選択された項目を取得できます。以前に選択されていた項目 (ある場合) は、SelectionChangedEventArgs.RemovedItems プロパティから取得できます。 AddedItems と RemovedItems のコレクションには、それぞれ 1 つの項目のみが含まれます (コンボボックスが複数選択をサポートしていないため)。

この例では、SelectionChanged イベントを処理する方法のほか、選択された項目にバインドする方法も示します。

<StackPanel>
    <ComboBox x:Name="colorComboBox" Width="200"
              Header="Colors" PlaceholderText="Pick a color"
              SelectionChanged="ColorComboBox_SelectionChanged">
        <x:String>Blue</x:String>
        <x:String>Green</x:String>
        <x:String>Red</x:String>
        <x:String>Yellow</x:String>
    </ComboBox>

    <Rectangle x:Name="colorRectangle" Height="30" Width="100"
               Margin="0,8,0,0" HorizontalAlignment="Left"/>

    <TextBlock Text="{x:Bind colorComboBox.SelectedIndex, Mode=OneWay}"/>
    <TextBlock Text="{x:Bind colorComboBox.SelectedItem, Mode=OneWay}"/>
</StackPanel>

private void ColorComboBox_SelectionChanged(object sender, SelectionChangedEventArgs e)
{
    string colorName = e.AddedItems[0].ToString();
    Color color;
    switch (colorName)
    {
        case "Yellow":
            color = Colors.Yellow;
            break;
        case "Green":
            color = Colors.Green;
            break;
        case "Blue":
            color = Colors.Blue;
            break;
        case "Red":
            color = Colors.Red;
            break;
    }
    colorRectangle.Fill = new SolidColorBrush(color);
}

既定では、SelectionChanged イベントは、ユーザーが一覧にある項目を対象にクリック、タップ、または Enter キーを押すことで選択を確定し、コンボボックスが閉じたときに発生します。開いているコンボボックスの一覧をユーザーがキーボードの方向キーを使って移動しても、選択は変更されません。

開いている一覧をユーザーが方向キーを押して移動している間に "ライブ更新" されるコンボボックスを作成するには (フォント選択ドロップダウンリストなど)、SelectionChangedTrigger を Always に設定します。これにより、開いている一覧にある別の項目にフォーカスが変更されたときに、SelectionChanged イベントが発生します。

テキスト検索

コンボボックスは、コレクション内の検索を自動的にサポートします。ユーザーが開いているコンボボックスまたは閉じたコンボボックスにフォーカスを合わせながら、物理キーボードに文字を入力すると、ユーザーの文字列に一致する候補が表示されます。この機能は、長いリストを移動するときに特に役立ちます。たとえば、州のリストが含まれているドロップダウンを操作するとき、“w” キーを押すと、“Washington” (ワシントン) がビューに表示され、すばやく選ぶことができます。検索するときに、大文字と小文字は区別されません。

IsTextSearchEnabled プロパティを false に設定すると、この機能を無効にすることができます。

コンボボックスを編集可能にする

既定では、コンボボックスを使用すると、ユーザーは事前に定義されたオプションの一覧から選択できます。ただし、一覧に有効な値のサブセットのみが含まれていて、一覧にないその他の値をユーザーが入力できる場合があります。これをサポートするために、コンボボックスを編集可能にすることができます。

コンボボックスを編集可能にするには、IsEditable プロパティを true に設定します。次に TextSubmitted イベントを処理して、ユーザーが入力した値を処理します。

既定では、ユーザーがカスタムテキストを確定したときに、SelectedItem 値が更新されます。 TextSubmitted イベント引数で Handled を true に設定することで、この動作をオーバーライドできます。イベントが処理済みとしてマークされると、コンボボックスによるイベント後の操作はそれ以上実行されず、コンボボックスは編集中の状態のままとなります。 SelectedItem は更新されません。

この例では、シンプルな編集可能コンボボックスを示しています。一覧にはシンプルな文字列が含まれていて、ユーザーが入力した値は入力したとおりに使用されます。

"recently used names" (最近使った名前) のセレクターでは、ユーザーはカスタム文字列を入力できます。 'RecentlyUsedNames' の一覧にはいくつかの値が含まれていて、ユーザーはそこから選択できますが、カスタムの新しい値を追加することもできます。 'CurrentName' プロパティは、現在入力されている名前を表します。

<ComboBox IsEditable="true"
          ItemsSource="{x:Bind RecentlyUsedNames}"
          SelectedItem="{x:Bind CurrentName, Mode=TwoWay}"/>

送信されたテキスト

TextSubmitted イベントを処理して、ユーザーが入力した値を処理できます。イベントハンドラーでは、通常、ユーザーが入力した値が有効であることを検証してから、その値をアプリで使用します。状況に応じて、将来使用するためにコンボボックスのオプションの一覧に値を追加することもできます。

TextSubmitted イベントは、これらの条件が満たされたときに発生します。

IsEditable プロパティが true
ユーザーがコンボボックスの一覧で既存のエントリに一致しないテキストを入力する
ユーザーが Enter キーを押すか、コンボボックスからフォーカスを移動する

ユーザーがテキストを入力してから一覧を上下に移動しても、TextSubmitted イベントは発生しません。

サンプル - 入力を検証してローカルに使用する

この例では、フォントサイズのセレクターには、フォントサイズの変化に対応する値のセットが含まれていますが、ユーザーは一覧にないフォントサイズを入力できます。

一覧にない値をユーザーが追加すると、フォントサイズが更新されますが、その値はフォントサイズの一覧に追加されません。

新しく入力された値が無効な場合は、SelectedValue を使用して Text プロパティを既知の最新の正しい値に戻します。

<ComboBox x:Name="fontSizeComboBox"
          IsEditable="true"
          ItemsSource="{x:Bind ListOfFontSizes}"
          TextSubmitted="FontSizeComboBox_TextSubmitted"/>

private void FontSizeComboBox_TextSubmitted(ComboBox sender, ComboBoxTextSubmittedEventArgs e)
{
    if (byte.TryParse(e.Text, out double newValue))
    {
        // Update the app's font size.
        _fontSize = newValue;
    }
    else
    {
        // If the item is invalid, reject it and revert the text.
        // Mark the event as handled so the framework doesn't update the selected item.
        sender.Text = sender.SelectedValue.ToString();
        e.Handled = true;
    }
}

サンプル - 入力を検証して一覧に追加する

ここでは、"favorite color セレクター" には、好きな色として最も一般的な色 (赤、青、緑、オレンジ色) が含まれていますが、ユーザーは一覧にない好きな色を入力できます。ユーザーが有効な色 (ピンクなど) を追加すると、その新しく入力された色が一覧に追加され、アクティブな "favorite color" (好きな色) として設定されます。

<ComboBox x:Name="favoriteColorComboBox"
          IsEditable="true"
          ItemsSource="{x:Bind ListOfColors}"
          TextSubmitted="FavoriteColorComboBox_TextSubmitted"/>

private void FavoriteColorComboBox_TextSubmitted(ComboBox sender, ComboBoxTextSubmittedEventArgs e)
{
    if (IsValid(e.Text))
    {
        FavoriteColor newColor = new FavoriteColor()
        {
            ColorName = e.Text,
            Color = ColorFromStringConverter(e.Text)
        }
        ListOfColors.Add(newColor);
    }
    else
    {
        // If the item is invalid, reject it but do not revert the text.
        // Mark the event as handled so the framework doesn't update the selected item.
        e.Handled = true;
    }
}

bool IsValid(string Text)
{
    // Validate that the string is: not empty; a color.
}

テキストコントロール
スペルチェックのガイドライン
TextBox クラス
PasswordBox クラス
String.Length プロパティ

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-03-05

次の方法で共有

コンボ ボックスとリスト ボックス

これは適切なコントロールですか?

例示

推奨事項

リスト ボックス

リスト ボックスは適切なコントロールですか?