ListBoxコントロール

ListBoxコントロール

　ListBoxコントロールはWebページにリストボックスを表示します。DropDownListコントロールと似たような扱い方ができます。

■　主なプロパティ

プロパティ名 概要
Items ListBoxコントロールの項目のコレクションを取得する
SelectedIndex ListBoxコントロール内の選択された項目のインデックスを取得・設定する
SelectedItem ListBoxコントロール内の選択された項目を取得・設定する
SelectedValue ListBoxコントロール内の選択された項目の値を取得・設定する
SelectionMode ListBoxコントロールの選択モードを取得・設定する
ListBoxの主なプロパティ

■　主なイベント

イベント名 概要
SelectedIndexChanged ListBoxコントロール内の選択項目が変更されたときに発生する
ListBoxの主なイベント

　ListBoxコントロールはSelectionModeプロパティでユーザーがListBoxコントロール内で一度に選択できる項目数や、複数の項目を選択するかどうかを設定できます。Itemsプロパティのコレクションが持っているAddメソッドで項目を追加します。

プロジェクトの種類 ASP.NET Webアプリケーション
プロジェクト名 ListBoxTest

サンプルダウンロード

○　デザイン

　Webフォームを追加して、次の図のように各コントロールを配置してください。

コントロールの配置例
コントロールの配置例

○　プログラム

　次のように各イベントハンドラを記述してください。

index.aspx.vb

  1. Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load
  2. 　'ポストバックのときは処理しない
  3. 　If Me.IsPostBack Then
  4. 　　Return
  5. 　End If
  7. 　'項目を追加する
  8. 　Me.lstFruits.Items.Add("りんご")
  9. 　Me.lstFruits.Items.Add("みかん")
  10. 　Me.lstFruits.Items.Add("もも")
  11. 　Me.lstFruits.Items.Add("なし")
  12. End Sub
  14. Protected Sub btnChange_Click(sender As Object, e As EventArgs) Handles btnChange.Click
  15. 　'選択をクリアにする
  16. 　Me.lstFruits.ClearSelection()
  18. 　'選択方法を切り替える
  19. 　If Me.lstFruits.SelectionMode = ListSelectionMode.Single Then
  20. 　　Me.lstFruits.SelectionMode = ListSelectionMode.Multiple
  21. 　　Me.btnChange.Text = "単一選択に切り替え"
  22. 　Else
  23. 　　Me.lstFruits.SelectionMode = ListSelectionMode.Single
  24. 　　Me.btnChange.Text = "複数選択に切り替え"
  25. 　End If
  26. End Sub
  28. Protected Sub btnSend_Click(sender As Object, e As EventArgs) Handles btnSend.Click
  29. 　'ラベルの表示内容をクリア
  30. 　Me.lblMessage.Text = String.Empty
  32. 　'選択されている場合は内容を表示
  33. 　If Me.lstFruits.SelectedIndex > -1 Then
  34. 　　'項目ごとに選択されているかをチェック
  35. 　　For Each li As ListItem In Me.lstFruits.Items
  36. 　　　If li.Selected Then
  37. 　　　　Me.lblMessage.Text &= li.Text & " "
  38. 　　　End If
  39. 　　Next
  40. 　Else
  41. 　　'選択されていない場合はメッセージを表示
  42. 　　Me.lblMessage.Text = "項目が選択されていません。"
  43. 　End If
  44. End Sub

○　実行結果

実行結果
実行結果

○　解説

　22~28行目は、LibtBoxコントロールの選択方法を変更しています。SelectionModeプロパティに現在の選択方法が格納されています。

 

　36~46行目は選択した項目を表示しています。SelectedIndexプロパティは選択されていない場合は-1が格納されています。それ以外の場合は何かが選択されています。38~42行目では、複数の項目が選択されているかもしれないので、ListBoxコントロールの項目をループして選択されているかどうかを確認しています。各項目(ListItemオブジェクト)のSelectedプロパティに選択状態が格納されています。

前へ   次へ