リストボックス TextプロパティとValueプロパティの違い(Excel VBA)

【本日のミッション】

リストボックスで値を取得するプロパティに「Textプロパティ」と「Valueプロパティ」の2つがあるが、違いを検証せよ。

ミッションの概要

リストボックスで値を取得する「Textプロパティ」と「Valueプロパティ」の違いを検証するのが、今回のミッションです。

今回のミッションは、リストボックスにListプロパティを使って配列に格納した複数列のセルデータを値リストとして設定(Excel VBA)で作成したリストボックスにコマンドボタン2つを追加し、両プロパティの結果の違いを検証します。

コマンドボタンの設置方法はリストボックス 複数列の値リストで選択しているデータを、列指定してListプロパティで取得(Excel VBA)をご参照ください。

リストボックス TextプロパティとValueプロパティの違い(Excel VBA)
↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓
リストボックス TextプロパティとValueプロパティの違い(Excel VBA)
↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓

リストボックス TextプロパティとValueプロパティの違い(Excel VBA)

列指定するプロパティが異なる

Textプロパティで取得する列は、TextColumnプロパティで指定します。
Valueプロパティで取得する列は、BoundColumnプロパティで指定します。

Private Sub UserForm_Initialize()
    Dim ary_d 'リストに設定するデータ用配列
    ary_d = Worksheets("サザエさん").Range("A2:D9")
    With ListBox1
        .ColumnCount = 4               '表示列数
        .TextColumn = 2                'Textプロパティで取得する値
        .BoundColumn = 1               'Valueプロパティで取得する値の列
        .ColumnWidths = "40;45;40;40"  '列幅
        .List = ary_d                  '参照範囲
    End With
End Sub

Private Sub Textプロパティを取得_Click()
    If ListBox1.Text = "" Then
        MsgBox "データが選択されていません。"
    Else
        MsgBox ListBox1.Text 
    End If
End Sub

Private Sub Valueプロパティを取得_Click()
    If IsNull(ListBox1.Value) Then
        MsgBox "データが選択されていません。"
    Else
        MsgBox ListBox1.Value
    End If
End Sub

リストボックス TextプロパティとValueプロパティの違い(Excel VBA)

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

TextプロパティとTextColumnプロパティ

TextColumnプロパティで指定した列は、Textプロパティで値取得される列になります。規定値は1列目です。

ListBox1.TextColumn = 2
↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓
MsgBox ListBox1.Text

上記コードでは、TextColumnプロパティで2列目の「名前」を指定しています。これをTextプロパティで取得すると「マスオ」がダイアログ表示されます。

リストボックス TextプロパティとValueプロパティの違い(Excel VBA)

リストボックス TextプロパティとValueプロパティの違い(Excel VBA)

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

ValueプロパティとBoundColumnプロパティ

BoundColumnプロパティで指定した列は、Valueプロパティで値取得される列になります。規定値は1列目です。

ListBox1.BoundColumn = 1
↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓
MsgBox ListBox1.Value

上記コードでは、BoundColumnプロパティで1列目の「ID」を指定しています。これをValueプロパティで取得すると「ID04」がダイアログ表示されます。

リストボックス TextプロパティとValueプロパティの違い(Excel VBA)

リストボックス TextプロパティとValueプロパティの違い(Excel VBA)

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

リストボックスで何も選択していないときの結果が異なる

Textプロパティは空欄「””」を返し、Valueプロパティはエラーになります。

Textプロパティ

Textプロパティでは、データが選択されていない時 空欄「””」が表示されます。
下記コードで、空欄表示を回避をする必要があります。

If ListBox1.Text = "" Then
    MsgBox "データが選択されていません。"
Else
    MsgBox ListBox1.Text 
End

リストボックス TextプロパティとValueプロパティの違い(Excel VBA)
↓↓↓↓↓↓↓↓↓
リストボックス TextプロパティとValueプロパティの違い(Excel VBA)

Valueプロパティ

Valueプロパティでは下記エラーが表示されてしまいます。

実行時エラー '94':
Nullの使い方が不正です。

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

If IsNull(ListBox1.Value) Then
    MsgBox "データが選択されていません。"
Else
    MsgBox ListBox1.Value
End if

リストボックス TextプロパティとValueプロパティの違い(Excel VBA)
↓↓↓↓↓↓↓↓↓
リストボックス TextプロパティとValueプロパティの違い(Excel VBA)

【参考】

VBA(マクロ)作成の前、リボンに開発タブを表示させる(Excel VBA)
ユーザーフォームの作成方法 準備(Excel VBA)
ユーザーフォームのオブジェクトの名前を「UserForm1」から変更する方法(Excel VBA)
ユーザーフォームの上のバー(タイトルバー)の名前を「UserForm1」から変更する(Excel VBA)
ユーザーフォームのオブジェクトウィンドウとコードウィンドウを表示切替させる方法(Excel VBA)
「オブジェクト名が不正です」を出さないようにユーザーフォームオブジェクト名を命名規則に従って変更(Excel VBA)
エクセルファイルが開いた時にユーザーフォームを表示させる方法(Excel VBA)
エクセル フォームのラベルのテキストを縦書きにする方法(Excel VBA)
AddItemメソッドを使ってリストボックスの値リストを設定する(Excel VBA)
RowSourceプロパティを使ってセル範囲とリストボックスの値リストをリンク設定させる(Excel VBA)
RowSourceプロパティでリンク設定したリストボックス値リストにデータを追加・削除する(Excel VBA)
リストボックスにListプロパティを使って 配列に格納したセルデータを値リストとして設定する(Excel VBA)
既存のリストボックスの値リストにAddItemメソッドでデータを追加する(Excel VBA)
既存のリストボックスの値リストのデータを、Clearメソッドで全て削除して初期化する(Excel VBA)
既存のリストボックスの値リストの項目を1件 RemoveItemメソッドで削除する(Excel VBA)
リストボックス リストから初期値としてはじめに選択しておく値を設定する(Excel VBA)
リストボックスの値リストに設定された項目の件数を取得する(Excel VBA)
RowSourceプロパティを使って 複数列のセル範囲とリストボックスの値リストをリンク設定(Excel VBA)
リストボックスにListプロパティを使って配列に格納した複数列のセルデータを値リストとして設定(Excel VBA)
リストボックス 複数列の値リストの列幅を変えたり非表示にしたりする設定(Excel VBA)
リストボックスで選択しているデータがリストの上から何番目(インデックス値)かを取得(Excel VBA)
リストボックス 1列の値リストで選択しているデータをTextプロパティで取得(Excel VBA)
リストボックス 1列の値リストで選択しているデータをValueプロパティで取得(Excel VBA)
リストボックス 1列の値リストで選択しているデータをListプロパティで取得(Excel VBA)
リストボックス 複数列の値リストで選択しているデータを、列指定してTextプロパティで取得(Excel VBA)
リストボックス 複数列の値リストで選択しているデータを、列指定してValueプロパティで取得(Excel VBA)
リストボックス 複数列の値リストで選択しているデータを、列指定してListプロパティで取得(Excel VBA)
指定した行(インデックス値)のデータをリストボックスの値リストから選択する(Excel VBA)
リストボックスの値リストに列見出しを表示する設定/ColumnHeadsで見出しが設定できない理由(Excel VBA)
リストボックス値リストAddItemメソッド・RowSourceプロパティ・Listプロパティ違い Excel VBA
リストボックス TextプロパティとValueプロパティの違い(Excel VBA)

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