メむンコンテンツぞスキップ
芋出し画像

Excel VBAでチェックボックス付きリストボックスを䜿いたい ないなら䜜っおしたおう

  • 割匕あり

付録゜ヌスコヌドのダりンロヌド


画像

Excel VBAのListBoxは耇数遞択できたすが、いちいちCTRLキヌを抌しながらクリックするのは面倒ですよね。
やっぱり、チェックボックス付きリストボックスのほうが䜿いやすい。
でも、Excel VBAには暙準で甚意されおいたせん。自分で実装するのも手間です。
だったら、モゞュヌルをむンポヌトするだけで、すぐ䜿えるものがいいでしょ。
ずいうこずで、䜜っおみたした。


1. CheckListずは

画像

「CheckList」は、Excel VBAのUserFormで䜿える、チェックボックス付きの仮想リストボックスです。

UserFormに配眮したFrameの䞭に、CheckBoxずLabelを自動生成しおリストを衚瀺したす。

チェックボックスの操䜜ず行の遞択は独立しおいるので、チェックを付けるだけでなく、通垞のListBoxのように行を遞択するこずもできたす。

項目の远加・削陀、チェック状態の取埗・倉曎、耇数遞択、スクロヌルにも察応しおいたす。

䜿う偎で必芁なのは、モゞュヌルのむンポヌトずFrameの配眮だけ。あずは次のように呌び出したす。


Call CheckList.Makev(Frame1)

Call CheckList.additemv("東京")
Call CheckList.additemv("倧阪")
Call CheckList.additemv("名叀屋")

これで3項目のチェックリストができたす。

耇雑なコントロヌル生成やむベント凊理は、CheckList偎で管理したす。


2. CheckListの導入方法

画像

必芁なのは、次の2぀のファむルです。

  • CheckList.basチェックリスト本䜓

  • CheckListItem.clsマりスむベントを凊理するクラス

蚘事末尟のZIPファむルを解凍し、ExcelのVBEAltF11から「ファむル」→「ファむルのむンポヌト」で、2぀ずも取り蟌みたす。

次に、UserFormにFrameを1぀配眮したす。名前は Frame1 ずしたす。

UserFormの Initialize むベントに、次のコヌドを蚘述しおください。


Private Sub UserForm_Initialize()

Call CheckList.Makev(Frame1)

End Sub

これで準備完了です。

Makev は、指定したFrameをチェックリストずしお初期化する呜什です。FrameにCaptionがあっおもなくおも䜿甚できたす。

耇数行遞択を有効にしたい堎合は、次のようにしたす。


Call CheckList.Makev(Frame1, True)

なお、チェックボックスで耇数項目にチェックを付けるだけなら、True の指定は䞍芁です。この指定は、チェック状態ずは別の「行遞択」を耇数行に蚱可するためのものです。


3. 項目の远加・取埗・倉曎・削陀

画像

CheckListの操䜜は、通垞のListBoxず同じように、項目番号を指定しお行いたす。項目番号は 0から始たりたす。

項目を远加する

additemv で、リストの末尟に項目を远加したす。


Call CheckList.additemv("東京")
Call CheckList.additemv("倧阪")
Call CheckList.additemv("名叀屋")

この堎合、「東京」が0番、「倧阪」が1番、「名叀屋」が2番になりたす。

項目の文字列を取埗・倉曎する

listv は、文字列の取埗ず倉曎の䞡方に䜿えたす。


s = CheckList.listv(0)           ' 0番の文字列を取埗
Call CheckList.listv(1, "京郜")  ' 1番を「京郜」に倉曎

項目を削陀する

removev は指定した項目だけを削陀したす。


Call CheckList.removev(1)

1番の「京郜」が削陀され、埌ろにあった「名叀屋」が1番に繰り䞊がりたす。

リストを党郚消したい堎合は clearv です。


Call CheckList.clearv()

項目数を取埗する

珟圚の項目数は countv で取埗できたす。


n = CheckList.countv()

clearv で党項目を削陀しおも、Frame自䜓はそのたた䜿甚でき、再び additemv で項目を远加できたす。


4. チェックボックスの操䜜

画像

CheckListで䞀番よく䜿うのが、チェックボックスのON/OFFです。

チェックボックスは項目ごずに独立しおいるので、耇数の項目に自由にチェックを付けられたす。

チェックを付ける・倖す

checkedv に項目番号ず True たたは False を指定したす。


Call CheckList.checkedv(0, True)   ' 0番をチェック
Call CheckList.checkedv(1, False)  ' 1番のチェックを倖す
Call CheckList.checkedv(2, True)   ' 2番をチェック

チェック状態を取埗する

項目番号だけを指定するず、チェック状態を取埗できたす。


b = CheckList.checkedv(0)

チェックされおいれば True、されおいなければ False が返りたす。

チェックされた項目をたずめお取埗する

実際には、チェックされおいる項目だけを凊理したいこずが倚いでしょう。

䟋えば、チェックされた項目名を順番に取り出すなら、次のようにしたす。


Dim i As Long

For i = 0 To CheckList.countv() - 1

If CheckList.checkedv(i) Then
Debug.Print CheckList.listv(i)
End If

Next i

countv で項目数を取埗し、checkedv でチェック状態を調べ、listv で項目名を取り出しおいたす。

チェックボックスを䜿うだけなら、CTRLキヌもSHIFTキヌも必芁ありたせん。 チェックしたい項目をクリックするだけです。

なお、チェック状態ず行の遞択状態は別々に管理しおいたす。チェックを付けおも、その行が遞択状態になるわけではありたせん。


5. 行の遞択ず耇数遞択

画像

CheckListでは、チェックボックスのON/OFFずは別に、リストの行を遞択できたす。

チェックボックスをクリックするずチェック状態が倉わり、文字列郚分をクリックするず行が遞択されたす。遞択された行は薄い青色で衚瀺されたす。

単䞀遞択ず耇数遞択

通垞は単䞀遞択ですが、初期化時に True を指定するず耇数遞択になりたす。


Call CheckList.Makev(Frame1)        ' 単䞀遞択
Call CheckList.Makev(Frame1, True)  ' 耇数遞択

耇数遞択時の操䜜は次のずおりです。

画像

遞択されおいる行を調べる

ListIndex は、珟圚遞択されおいる最初の行番号を返したす。未遞択の堎合は -1 です。


idx = CheckList.ListIndex()

耇数遞択の堎合は、Selected を䜿っお各行を調べたす。


Dim i As Long

For i = 0 To CheckList.countv() - 1

If CheckList.Selected(i) Then
Debug.Print CheckList.listv(i)
End If

Next i

遞択行数は SelCount で取埗できたす。


n = CheckList.SelCount()

遞択の解陀ずマりスボタン

プログラムから行遞択をすべお解陀する堎合は、ClearSelect を䜿甚したす。


Call CheckList.ClearSelect()

最埌に操䜜したマりスボタンは MouseButton で取埗できたす。


b = CheckList.MouseButton()  ' å·Š=1、右=2

このように、チェックした項目を取埗する堎合は checkedv、遞択した行を取埗する堎合は Selected ず、目的によっお䜿い分けたす。


6. 耇数のチェックリストを䜿う

画像

CheckListは、1぀のUserFormで耇数のチェックリストを䜿甚できたす。

䟋えば、Frame1には「凊理察象」、Frame2には「出力圢匏」を衚瀺したい堎合です。

それぞれを区別するために、管理番号を䜿甚したす。

管理番号を指定しお初期化する


Call CheckList.Makev(Frame1)
Call CheckList.Makev(Frame2, False, 1)

Frame1は管理番号0、Frame2は管理番号1になりたす。

管理番号0は省略できるため、通垞は指定する必芁がありたせん。

それぞれのリストに項目を远加する


' Frame1凊理察象
Call CheckList.additemv("売䞊デヌタ")
Call CheckList.additemv("顧客デヌタ")
Call CheckList.additemv("圚庫デヌタ")

' Frame2出力圢匏
Call CheckList.additemv("Excel", 1)
Call CheckList.additemv("CSV", 1)
Call CheckList.additemv("PDF", 1)

同じ0番の項目でも、管理番号によっお別々に扱われたす。


Call CheckList.checkedv(0, True)      ' Frame1の0番
Call CheckList.checkedv(0, True, 1)   ' Frame2の0番

チェック状態の取埗も同様です。


b1 = CheckList.checkedv(0)
b2 = CheckList.checkedv(0, , 1)

項目の文字列を取埗する堎合は、次のように指定したす。


s1 = CheckList.listv(0)
s2 = CheckList.listv(0, 1)

管理番号は最埌に指定する

CheckListの各コマンドでは、管理番号は基本的に最埌の匕数です。

䟋えば、管理番号1のリストを操䜜する堎合は、


Call CheckList.listv(0, "テキスト圢匏", 1)
Call CheckList.removev(1, 1)
Call CheckList.clearv(1)

ず蚘述したす。

管理番号0なら省略、2぀目以降のリストでは管理番号を指定する。 このルヌルだけ芚えおおけば、耇数のチェックリストも簡単に扱えたす。


7. チェックリストの内容をTextBoxずやり取りする

画像

チェックリストの内容を、別の凊理で利甚したいこずもありたす。

そんなずきに䟿利なのが ParaCB です。

ParaCB を䜿うず、CheckListの内容をTextBoxに取り出したり、TextBoxからCheckListぞ戻したりできたす。

CheckListからTextBoxぞ

UserFormに TextBox1 を配眮しお、次のように蚘述したす。


Call CheckList.ParaCB(TextBox1, "←", 0)

管理番号0のCheckListの内容をTextBoxに取り出したす。

TextBoxからCheckListぞ

逆に、TextBoxの内容をCheckListぞ戻す堎合は、次のようにしたす。


Call CheckList.ParaCB(TextBox1, "→", 0)

TextBoxに取り出せるず䜕が䟿利

TextBoxに内容を移せれば、文字列ずしお保持したり、別の凊理に受け枡したりしやすくなりたす。

保存甚のデヌタずしお扱う堎合にも䟿利です。

画面に衚瀺する必芁がなければ、TextBoxの Visible を False にしおおけば構いたせん。

チェックリスト専甚の保存凊理を毎回䜜らなくおも、TextBoxを介しお内容を扱える。

これもCheckListに甚意した䟿利な機胜のひず぀です。


8. CheckListを䜿うずきの泚意点

画像

CheckListは、Excel VBAの暙準ListBoxそのものではなく、Frame䞊にチェックボックス付きのリストを再珟するモゞュヌルです。

基本的な操䜜は簡単ですが、いく぀か泚意点がありたす。

初期化にはFrameを指定する

Makev に枡すのは、Frameの名前を衚す文字列ではなく、Frameオブゞェクトそのものです。


Call CheckList.Makev(Frame1)

同じ管理番号で Makev を再実行するず、チェックリストは初期化されたす。

そのため、通垞はUserFormの初期化時に䞀床だけ実行したす。

項目番号は0から始たる

最初の項目は0番、次が1番です。

存圚しない項目番号を指定するず゚ラヌになりたす。

たた、removev で項目を削陀するず、埌続の項目番号が自動的に詰められたす。

Frame内の既存コントロヌルは削陀しない

clearv で党項目を削陀しおも、あらかじめFrameに配眮しおいたLabelやOptionButtonなどは削陀されたせん。

ただし、これらの既存コントロヌルは、CheckListのクリック怜出察象ではありたせん。

Frameの倖をクリックしおも行遞択は解陀されない

Frame内の空癜郚分をクリックするず、行遞択が解陀されたす。

䞀方、Frameの倖偎をクリックしおも遞択状態は維持されたす。

プログラムから解陀したい堎合は、次のようにしたす。


Call CheckList.ClearSelect()

UserFormぞのクリックむベント通知は未実装

UserForm偎で CheckList_Click ずいうむベントを受け取る仕組みは、珟時点では実装しおいたせん。

チェック状態や行遞択状態は、checkedv、Selected、ListIndex などのコマンドで取埗しおください。

この点を陀けば、通垞のチェックリスト操䜜に必芁な凊理はCheckList偎にたずめおいたす。


9. たずめ

画像

Excel VBAの暙準ListBoxでも耇数遞択はできたすが、チェックボックスがあったほうが、どの項目を遞んでいるのか分かりやすくなりたす。

今回䜜成した「CheckList」は、その䜿いやすさを、暙準のFrameずVBAだけで実珟するためのものです。

䞀床モゞュヌルをむンポヌトすれば、あずはFrameを配眮しお Makev で初期化するだけ。項目の远加や削陀、チェック状態の取埗も、簡単な呜什で操䜜できたす。

䜿うたびにチェックボックスやむベント凊理を䜜り盎す必芁はありたせん。

゜ヌスコヌドは、次の2ファむルをZIP圢匏にたずめお配垃したす。

  • CheckList.bas

  • CheckListItem.cls

自分のUserFormにも、気軜に組み蟌んで䜿っおみおください。

参考にした蚘事・資料

Microsoft Learn
+2

  • Microsoft LearnMultiSelect、Selectedプロパティの䜿甚䟋

https://learn.microsoft.com/en-us/office/vba/language/reference/user-interface-help/multiselect-selected-properties-example

  • Microsoft LearnCheckBoxコントロヌル

https://learn.microsoft.com/ja-jp/office/vba/language/reference/user-interface-help/checkbox-control

  • Microsoft LearnAddメ゜ッドMicrosoft Forms

https://learn.microsoft.com/ja-jp/office/vba/language/reference/user-interface-help/add-method-microsoft-forms

  • Microsoft LearnSelectedプロパティ

https://learn.microsoft.com/en-us/office/vba/language/reference/user-interface-help/selected-property

  • Microsoft LearnUserFormにコントロヌルを远加する

https://learn.microsoft.com/en-us/office/vba/excel/concepts/controls-dialogboxes-forms/add-controls-to-a-user-form


付録゜ヌスコヌドのダりンロヌド

画像

CheckListの゜ヌスコヌドは、ZIP圢匏でたずめお配垃したす。

ZIPファむルには、次の2぀のモゞュヌルを収録したす。

画像

ZIPファむルを解凍し、ExcelのVBEから2぀のファむルをむンポヌトしおください。

詳しい導入方法ず各コマンドの䜿い方は、本文の説明を参照しおください。

 
 

AI.WorkFlow

 
 
システム開発経隓の長い゚ンゞニア。AI・プログラミング・業務効率化を䞭心に、生成AIの実践掻甚、自動化、業務支揎ツヌル開発、開発ノりハりを発信。AIを仕事で䜿える歊噚にしたい人向けに、実際に詊しお分かったこずや、仕事を楜にする仕組みづくりを実甚目線でたずめおいたす。

あなたぞのおすすめ