リストボックス複数列の値リストで選択しているデータを、列指定してListプロパティで取得（Excel VBA)

リストボックス複数列の値リストで選択しているデータを、列指定してListプロパティで取得せよ。

1 ミッションの概要
2 ユーザーフォームにコマンドボタンを追加する
3 値リストで選択しているデータを取得するコードを、コマンドボタンに設定
4 ユーザーフォームを表示して動作を確認
5 ListIndex プロパティ
- 5.1 値リストで選択しているデータの行位置（インデックス値）の取得
- 5.2 指定した行位置（インデックス値）のデータ選択
6 Listプロパティ
- 6.1 値リストで指定した「行」「列」のデータを取得
- 6.2 データが選択されていないときの値
7 【参考】

ミッションの概要

リストボックス複数列の値リストで選択しているデータを、列指定してListプロパティで取得せよ、というのが今回のミッションです。

リストボックスにListプロパティを使って配列に格納した複数列のセルデータを値リストとして設定（Excel VBA)で作成したリストボックスの下に、

値リストで選択しているデータを取得するコマンドボタン

を作り、選択しているデータをダイアログ表示します。

【その他リストボックスからデータを取得する方法】
リストボックス 1列の値リストで選択しているデータをTextプロパティで取得（Excel VBA)
リストボックス 1列の値リストで選択しているデータをValueプロパティで取得（Excel VBA)
リストボックス 1列の値リストで選択しているデータをListプロパティで取得（Excel VBA)
リストボックス複数列の値リストで選択しているデータを、列指定してTextプロパティで取得（Excel VBA)
リストボックス複数列の値リストで選択しているデータを、列指定してValueプロパティで取得（Excel VBA)

ユーザーフォームにコマンドボタンを追加する

ユーザーフォームを表示させる

画面左のプロジェクトエクスプローラーから、ユーザーフォームをダブルクリックして表示させます。

ツールボックスを表示させる

ツールボックスを、下記方法で表示させます。

ツールボックスを表示する方法1

[表示]－[ツールボックス]

ツールボックスを表示する方法2

標準ツールバーの［ツールボックス］ボタンをクリックします。

標準ツールバーが表示されていない場合は、［表示］－[ツールバー］－[標準］で表示されます。

■■■スポンサーリンク■■■

ユーザーフォームにコマンドボタンを配置する

ツールボックスから「コマンドボタン」をクリックします。

リストボックスの下にコマンドボタンを作成します。
リストボックス・コマンドボタンの位置は、程よく調整します。

左のプロパティウインドウで確認すると、コマンドボタンのオブジェクト名が「CommandButton1」ということが確認できます。

この「CommandButton1」というオブジェクト名を「データを取得」、Captionも「データを取得」に変更します。Captionを変更することで、ボタンの表示名が「CommandButton1」から「データを取得」に変更されます。

値リストで選択しているデータを取得するコードを、コマンドボタンに設定

［データを取得］ボタンをダブルクリックすると、コードウィンドウが表示され、下記コードが追加されています。

「Private Sub 〇〇〇_Click()」に書いた処理は、〇〇〇をクリックした時に行われます。

Private Sub データを取得_Click()

End Sub

ここに［データを取得］ボタンをクリックした時の動作を追加します。

「ListBox1」でデータが選択されていない時のダイアログ表示
「ListBox1」で選択しているデータをダイアログ表示

Private Sub UserForm_Initialize() 
    Dim ary_d                  'リストに設定するデータ用配列 
    ary_d = Worksheets("サザエさん").Range("A2:D9")
    With ListBox1
        .ColumnCount = 4                '表示列数
        .ColumnWidths = "40;45;40;40"   '列幅
        .List = ary_d                   '参照範囲
    End With
End Sub

Private Sub データを取得_Click()
    If ListBox1.ListIndex = -1 Then
        MsgBox "何も選択されていません。"
    Else
        MsgBox ListBox1.List(ListBox1.ListIndex, 1)
    End If
End Sub

■■■スポンサーリンク■■■

ユーザーフォームを表示して動作を確認

このコード内にカーソルを置いたまま、［F5］キーをクリックすると（ユーザーフォームの実行）ユーザーフォームが表示されます。

配列に入れるデータの参照先にシート名が含まれていないと、アクティブになっているシートのセルデータが使用されるので注意が必要です。シート名を参照先に含めていない場合は、参照データのシートをアクティブにしてからマクロを実行してください。

ary_d = Worksheets("サザエさん").Range("A2:D9")

「配列」参照：セル範囲を一気に変数（配列）に入れる～バリアント型(Variant)変数を配列として使用する～（Excel VBA）

メイン画面が表示されます。

値リストから「マスオ」さんを選択し、<データを取得>ボタンをクリックします。
選択しているデータの2列目「マスオ」さんがダイアログ表示されます。

ListIndex プロパティ

ListIndex プロパティには「値リストで選択しているデータの行位置（インデックス値）の取得」「指定した行位置（インデックス値）のデータ選択」の機能があります。

値リストで選択しているデータの行位置（インデックス値）の取得

リストボックスで選択しているデータの行位置（インデックス値）を取得することができます。データを選択していない場合のインデックス値は「-1」になります。

インデックス値は、1つ目の「サザエ」さんを「0」として数えます。「マスオ」さんはインデックス値「3」になります。

参考：リストボックスで選択しているデータがリストの上から何番目（インデックス値）かを取得（Excel VBA)

指定した行位置（インデックス値）のデータ選択

リストボックスのリストから、指定した行位置（インデックス値）のデータを選択します。

ListBox1.ListIndex = 選択したいデータの行位置（インデックス値）

インデックス値は、値リストの一番上の項目を「0」として数えます。
「3」を指定すると、4つ目の「マスオ」さんが選択されます。

ListBox1.ListIndex = 3

また、インデックスに「-1」を指定すると、何も選択していない状態になります。

ListBox1.ListIndex = -1

Listプロパティ

値リストで指定した「行」「列」のデータを取得

Listプロパティと言えば、リストボックスに値リストを設定するプロパティなのでは？
（参照：リストボックスにListプロパティを使って配列に格納した複数列のセルデータを値リストとして設定（Excel VBA)）

その他にListプロパティには、設定した値リストから「行」「列」を指定してデータを取得する機能もあります。

リストボックスオブジェクト.List（値を取得したい行,値を取得したい列）

値を取得したい行：値リストの1行目を「0」として数えます。
値を取得したい列：値リストの1列目を「0」として数えます。

値を取得したい行も値を取得したい列も、省略した場合は「0」が指定されます。

今回は「値を取得したい行」に「ListBox1.ListIndex」を指定しています。
ListIndexプロパティは、リストボックスで選択しているデータの行位置（インデックス値）を取得します。インデックス値は、1行目を「0」として数えます。
（参照：リストボックスで選択しているデータがリストの上から何番目（インデックス値）かを取得（Excel VBA)）

値を取得したい行=3
値を取得したい列=1

と指定しているので、結果は「マスオ」さんになります。

データが選択されていないときの値

Listプロパティでデータを取得する際、値リストから何も選択されていないと下記エラーが表示されます。

実行時エラー '381':
Listプロパティの値を取得できません。プロパティの配列のインデックスが
無効です。

値リストからデータが選択されていない場合、「ListBox1.ListIndex」は「-1」を返します。値リストの行に「-1」は無いのでエラーになります。

下記コードで、エラー回避をする必要があります。

If ListBox1.ListIndex = -1 Then
    MsgBox "データが選択されていません。"
Else
    MsgBox ListBox1.List(ListBox1.ListIndex, 1)
End If

【参考】

■■■スポンサーリンク■■■