【ExcelVBA フォーム＆コントロール】リストボックスに列見出しを表示する方法を教えて！

構文
使い方
プログラミング例
まとめ

構文

構文は以下の通りです。

リストボックス名.ColumnHeads = True / False

解説

リストボックスに列見出しを表示するには、ColumnHeadsプロパティを使用します。設定値をTrueにすると列見出しを表示し、Falseを指定すると列見出しを非表示にします。列見出しを表示する事で、データが整然と表示され、ユーザーが情報を迅速に理解できるようになります。

使い方

具体的な使い方を紹介します。

Private Sub UserForm_Initialize()
' フォームが初期化されたときに実行されるコード
ListBox1.ColumnCount = 3 ' 列数を設定
ListBox1.ColumnHeads = True ' 列見出しを有効にする
' 列見出しの設定
ListBox1.List(0, 0) = "学生ID"
ListBox1.List(0, 1) = "氏名"
ListBox1.List(0, 2) = "点数"
' データの追加
ListBox1.List(1, 0) = 1
ListBox1.List(1, 1) = "田中太郎"
ListBox1.List(1, 2) = 95
' 他のデータも同様に追加可能
End Sub

この例では、UserForm_Initializeというフォーム初期化時に呼ばれるイベントで、列数を設定し、列見出しとデータを設定しています。

プログラミング例

以下に、プログラミング例を紹介します。

（例1）条件に基づいて列見出しを動的に変更する

Private Sub UserForm_Initialize()
' 初期化時に条件に基づいて列見出しを設定する
' シートとリストボックスを定義
Dim ws As Worksheet
Set ws = ThisWorkbook.Sheets("生徒データ")
Dim listBox As MSForms.ListBox
Set listBox = Me.ListBox1
' 条件に基づいて列見出しを設定
If ws.Cells(1, 1).Value = "学年" Then
' 学年が列見出しの場合
listBox.ColumnHeads = True
listBox.List(0, 0) = "学年"
listBox.List(0, 1) = "氏名"
listBox.List(0, 2) = "成績"
ElseIf ws.Cells(1, 1).Value = "ID" Then
' IDが列見出しの場合
listBox.ColumnHeads = True
listBox.List(0, 0) = "ID"
listBox.List(0, 1) = "氏名"
listBox.List(0, 2) = "出席日数"
End If
End Sub

この例では、ワークシートの最初のセルが「学年」か「ID」かによって、列見出しを動的に変更しています。これにより、異なるデータ構造に対応できます。

（例2）特定の条件を満たす行だけを表示する

Private Sub UserForm_Initialize()
' 初期化時に特定の条件を満たす行だけをリストボックスに表示する
' シートとリストボックスを定義
Dim ws As Worksheet
Set ws = ThisWorkbook.Sheets("生徒データ")
Dim listBox As MSForms.ListBox
Set listBox = Me.ListBox1
' 条件に基づいて該当するデータをリストボックスにセット
Dim lastRow As Long
lastRow = ws.Cells(ws.Rows.Count, 1).End(xlUp).Row
Dim i As Long, rowIndex As Long
rowIndex = 0
For i = 2 To lastRow ' ヘッダー行以外を確認
If ws.Cells(i, 3).Value >= 80 Then ' 成績が80以上の行のみを表示
rowIndex = rowIndex + 1
listBox.AddItem ws.Range("A" & i & ":C" & i).Value
End If
Next i
' 列見出しを表示する
If rowIndex > 0 Then
listBox.ColumnHeads = True
listBox.List(0, 0) = "学年"
listBox.List(0, 1) = "氏名"
listBox.List(0, 2) = "成績"
End If
End Sub

この例では、成績が80以上の生徒のデータのみをリストボックスに表示します。条件を変更することで、他の特定の条件に基づいた表示も簡単に実現できます。