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

【本日のミッション】

リストボックスにListプロパティを使って、配列に格納した複数列のセルデータを値リストとして設定せよ。

ミッションの概要

複数列のセル範囲データを配列に格納し、リストボックスにListプロパティを使って値リストとして設定せよ、というのが今回のミッションです。

リストボックスにListプロパティを使って 配列に格納したセルデータを値リストとして設定する(Excel VBA)では一列だけのデータを値リストにしていましたが、今回は複数列を値リストにしてみます。

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


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

ユーザーフォームに リストボックスを作る

ユーザーフォームを開く

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

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

リストボックスを作るためのツールボックスを、下記方法で表示させます。

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

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

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

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

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

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

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

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

リストボックスの作成

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

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

ユーザーフォームのリストボックスを配置したい位置に、左上からクリックのまま右下までドラッグします。

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

ユーザーフォームにリストボックスが作成されます。

左のプロパティウインドウを確認すると、このリストボックスのオブジェクト名が「ListBox1」ということが確認できます。

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

ユーザーフォームの Initialize 処理で、リストボックスの値リストを設定する

UserForm_Initialize に記述した処理は、ユーザーフォームが画面表示される時に行われます。ユーザーフォームに設置したオブジェクト(リストボックス・コンボボックス・テキストボックス等)で、

  • プルダウンを開いた時に出てきて欲しい値リスト
  • 初めから表示されていて欲しい選択リスト
  • テキストの初期値
  • 値リストの列幅・列数

等は、ユーザーフォームが開くと同時に設定されるようにしておきます。

今回は、ユーザーフォーム「frmMain」が画面表示される時に、リストボックス「ListBox1」に値リストが表示されるようにします。

ユーザーフォームのコードウィンドウを表示

プロジェクトエクスプローラーから、リストボックスを設置しているユーザーフォームを右クリックします。

[コードの表示]をクリックし、コードウィンドウを表示させます。([F7]キーでもコード表示できます。)

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

UserFormの選択

コードウィンドウ上部の「(General)」と表示されているプルダウンを開き、「UserForm」を選択します。

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

自動的に下記コードが挿入されますが、削除するとUserFormの選択が解除されるため、そのままにしておきます。

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

Initializeの選択

右側のプルダウン(「Click」と表示されています。)を開き、「Initialize」を選択します。

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

下記コードが表示されます。

ここで先ほどの「Private Sub UserForm_Click() ~ End Sub」は不要になりますので、削除しておきましょう。

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

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

UserForm_Initialize にコードの追加

Private Sub UserForm_Initialize ~ End Sub 内に下記の通り、コードを追加します。

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

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

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

ユーザーフォームの実行

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

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

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

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

リストボックスの値を選択すると、青色に反転します。

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

今回は、[閉じる]ボタンを付けていないため[×]ボタンでユーザーフォームを閉じます。

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

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

Listプロパティ

Listプロパティを使用すると、配列に格納したデータを一括で値リストに設定することができます。

リストボックスオブジェクト.List = 配列

Listプロパティで設定した値リストは、RowSourceプロパティで設定した値リストと異なり

  • AddItemメソッドでの追加が可能
  • Clear、RemoveItem メソッドでの削除が可能

になります。

ワークシートのセル範囲のデータとリンクしていないため、リストの内容に変更がある場合は、AddItemメソッド、Clear・RemoveItem メソッドを使って、値リストを直接編集します。

RowSourceプロパティを使って 複数列のセル範囲とリストボックスの値リストをリンク設定(Excel VBA)ではColumnHeadsプロパティを使って値リストの上部に列見出しを表示することができましたが、Listプロパティで設定した値リストには列見出しをつけることはできません。

ColumnCountプロパティ

リストボックスに表示する列数を設定します。既定値は1です。

今回は「ID」「名前」「性別」「年齢」の4列にしています。

ListBox1.ColumnCount = 4

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

ColumnWidthsプロパティ

リストボックスの値リストの各列の幅を設定します。列幅と列幅の間に「;」セミコロンを入れて区切ります。
「0」を指定すると、その列は非表示になります。
空白を指定すると、既定の列幅での表示になります。
単位の規定値は「ポイント」ですが、ほかの単位を指定することもできます。

今回は全ての列を表示させています。

ListBox1.ColumnWidths = "40;45;40;40"

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

「0」に指定した列は非表示に、空白を指定した列は規定幅に設定されます。

ListBox1.ColumnWidths = "0;45;;40"

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

数値の後ろに単位を入れれば、ポイント以外の単位を使うことも可能です。

ListBox1.ColumnWidths = "1cm;2cm;40;40"

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

Withステートメント

1つのオブジェクトに対して、複数のプロパティやメソッドを記述する際、Withステートメントを使用して、コードを簡略化することができます。

今回は ListBox1に対して、下記のような処理を指定するのですが「ListBox1.」が何度も出てきて、画面がゴチャゴチャしていますよね。

ListBox1.ColumnCount = 4               '表示列数
ListBox1.ColumnWidths = "40;45;40;40"  '列幅
ListBox1.List = ary_d                  '参照範囲

Withステートメントを使うと、このように簡略化できます。

With ListBox1
    .ColumnCount = 4               '表示列数
    .ColumnWidths = "40;45;40;40"  '列幅
    .List = ary_d                  '参照範囲
End with

ColumnHeadsプロパティは使用不可

リストボックスに列見出しを表示する・表示しないを設定する「ColumnHeadsプロパティ」は、Listプロパティで設定した値リストに使用することはできません。

RowSourceプロパティで設定した値リストでは使用できるので、下記ページをご参照ください。

RowSourceプロパティを使って 複数列のセル範囲とリストボックスの値リストをリンク設定(Excel VBA)

内容
True列見出しを表示します。
False列見出しを表示しません。(既定値)

【参考】

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)

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