VBAをある程度書けるようになると、こういうコードに行き当たります。
Dim names(100) As String Dim prices(100) As Double Dim counts(100) As Long
商品名・単価・数量を、それぞれ別の配列で管理している状態です。これは「3番目の要素」が3つの配列で揃っていることを前提にしており、片方だけ並べ替えたりするとデータがずれます。
クラスモジュールを使うと、関連するデータを1つのまとまりとして扱えます。この記事では、VBAのクラスモジュールの基本を解説します。
クラスモジュールとは
ひとことで言えば「自分で作るオブジェクト」です。
VBAには Worksheet や Range といったオブジェクトがあります。Range は .Value や .Font といったプロパティを持ち、.Copy のようなメソッドを持っています。クラスモジュールは、これと同じ構造のものを自分で定義する仕組みです。
「商品」というオブジェクトを作れば、次のように書けるようになります。
item.名前 = "コピー用紙" item.単価 = 480 item.数量 = 10 MsgBox item.小計 ' 4800
3つの配列を並べて管理するより、何を扱っているかが読み取りやすくなります。
クラスモジュールの作り方
VBE(Alt+F11)でプロジェクトを右クリック →「挿入」→「クラスモジュール」を選びます。
作成されたモジュールは、プロパティウィンドウ(F4)の「(オブジェクト名)」で名前を変更します。ここで付けた名前が、そのままクラス名になります。ここでは Item とします。
標準モジュールとの違いは次の通りです。
| 標準モジュール | クラスモジュール | |
|---|---|---|
| 役割 | 処理(手続き)を書く | データと振る舞いの型を定義する |
| 呼び出し方 | Call マクロ名 で直接実行 |
New でインスタンスを作ってから使う |
| データの保持 | モジュール全体で1つ | インスタンスごとに別々に持てる |
「インスタンス」は、定義(設計図)から作られた実体のことです。Item クラスから100個の実体を作れば、それぞれが独立した名前・単価・数量を持ちます。
最もシンプルな例
Item クラスモジュールに、次のように書きます。
' === クラスモジュール: Item === Option Explicit Public 名前 As String Public 単価 As Double Public 数量 As Long
これだけで使えます。標準モジュールから呼び出してみます。
' === 標準モジュール === Sub UseItem() Dim it As Item Set it = New Item ' インスタンスを作る it.名前 = "コピー用紙" it.単価 = 480 it.数量 = 10 MsgBox it.名前 & " の小計は " & it.単価 * it.数量 & " 円です" End Sub
ポイントは2つです。
- クラスの変数は
Setを使って代入する(Set it = New Item) Newを書いた時点で実体が作られる
計算結果をプロパティにする
小計の計算を毎回書くのは無駄なので、クラス側に持たせます。Property Get を使うと、読み取り専用のプロパティになります。
' === クラスモジュール: Item === Option Explicit Public 名前 As String Public 単価 As Double Public 数量 As Long ' 読み取り専用プロパティ Public Property Get 小計() As Double 小計 = 単価 * 数量 End Property ' 税込金額(税率10%) Public Property Get 税込金額() As Double 税込金額 = Int(小計 * 1.1) End Property
呼び出し側では、普通のプロパティと同じように書けます。
Sub ShowSubtotal() Dim it As Item Set it = New Item it.名前 = "コピー用紙" it.単価 = 480 it.数量 = 10 Debug.Print it.小計 ' 4800 Debug.Print it.税込金額 ' 5280 End Sub
計算ロジックが1か所にまとまるため、税率が変わったときもクラスを直すだけで済みます。
入力値をチェックする
Property Let を使うと、値を設定するときに検査を挟めます。
' === クラスモジュール: Item === Option Explicit Public 名前 As String Public 数量 As Long Private m_単価 As Double ' 内部で保持する変数 Public Property Get 単価() As Double 単価 = m_単価 End Property Public Property Let 単価(ByVal value As Double) If value < 0 Then Err.Raise 5, "Item", "単価にマイナスは設定できません" End If m_単価 = value End Property
it.単価 = -100 と書いた時点でエラーになるため、おかしな値がデータに紛れ込むのを防げます。内部変数に m_ を付けるのは、プロパティ名と区別するための慣習です。
メソッド(処理)を持たせる
クラスの中に Sub や Function を書くと、そのオブジェクトのメソッドになります。
' === クラスモジュール: Item === ' シートの指定行に書き出す Public Sub シートへ出力(ByVal ws As Worksheet, ByVal rowNo As Long) ws.Cells(rowNo, 1).Value = 名前 ws.Cells(rowNo, 2).Value = 単価 ws.Cells(rowNo, 3).Value = 数量 ws.Cells(rowNo, 4).Value = 小計 End Sub
Sub WriteOne() Dim it As Item Set it = New Item it.名前 = "封筒" it.単価 = 12 it.数量 = 500 it.シートへ出力 ActiveSheet, 2 End Sub
複数件をまとめて扱う:Collection
クラスの利点が出るのは、複数件を扱うときです。Collection に入れると、件数を気にせず追加できます。
Sub LoadItems() Dim items As Collection Dim it As Item Dim ws As Worksheet Dim lastRow As Long Dim i As Long Dim total As Double Set ws = ActiveSheet Set items = New Collection lastRow = ws.Cells(ws.Rows.Count, 1).End(xlUp).Row ' シートからクラスへ読み込む For i = 2 To lastRow Set it = New Item ' ループの中で毎回新しく作る it.名前 = ws.Cells(i, 1).Value it.単価 = ws.Cells(i, 2).Value it.数量 = ws.Cells(i, 3).Value items.Add it Next i ' まとめて処理する For Each it In items If it.小計 >= 10000 Then Debug.Print it.名前 & ": " & it.小計 End If total = total + it.小計 Next it MsgBox "合計 " & items.Count & " 件 / " & Format(total, "#,##0") & " 円" End Sub
Set it = New Item をループの中に書くのが重要です。 ループの外に出すと、同じ実体を使い回すことになり、全要素が最後の行の値になってしまいます。これはクラスを使い始めたときに必ず一度は踏む落とし穴です。
初期化処理:Class_Initialize
インスタンスが作られた瞬間に動く処理を書けます。既定値の設定に使います。
' === クラスモジュール: Item === Private Sub Class_Initialize() 数量 = 1 ' 既定値 m_単価 = 0 End Sub Private Sub Class_Terminate() ' 破棄されるときの処理(後片付けが必要な場合に使う) End Sub
配列・Dictionaryとの使い分け
クラスが常に最善というわけではありません。
| 用途 | 向いているもの |
|---|---|
| 単純な値の並び(数値のリストなど) | 配列 |
| キーで高速に引きたい(商品コード→単価) | Dictionary |
| 1件が複数の項目を持ち、計算や判定も伴う | クラス |
| 大量データを高速に一括処理したい | 配列 |
数万件を単純にループするだけなら、配列のほうが確実に速く動きます。クラスは項目数が多く、1件あたりの処理ルールが複雑な場合に効果を発揮します。
「商品」「社員」「伝票」といった、現実の書類に対応するまとまりを扱うときが使いどころです。
まとめ
- クラスモジュールは「自分で作るオブジェクト」
Public 変数を書くだけでもプロパティとして使えるProperty Getで計算結果を、Property Letで入力チェックを実装できる- Collectionに入れると複数件をまとめて扱える
- ループ内の
Set 変数 = New クラスを忘れると全件が同じ値になる - 速度優先なら配列、構造の分かりやすさ優先ならクラス
最初は「3つの配列で管理していた処理を1つのクラスに置き換える」ところから試すと、利点が実感しやすくなります。
他の記事でもExcel VBAの実務的なテクニックを紹介していますので、ぜひチェックしてみてください。