インハムシステムの自動化ノート

現役エンジニアが、Excel VBA・Google Apps Scriptによる業務効率化のヒントをお届けします。

【Excel VBA】クラスモジュールの基本|データのまとまりを扱いやすくする

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の実務的なテクニックを紹介していますので、ぜひチェックしてみてください。