【ExcelVBA】モジュール・プロシージャとは？使い方も徹底解説！

こんにちは、フリーランスエンジニア兼ライターのワキザカ サンシロウです。

皆さんは、VBAのプロシージャが何かわかりますか？VBAを初めて間もない方だと、プロシージャの意味や使い方がわからない方も多いのではないでしょうか。

そこで今回は、

といった基礎的なことから、

といった応用的な方法まで、徹底的に解説します！

VBAプロジェクトの構成とは？

まず、VBAプロジェクトの構成について簡単に解説します。VBAは以下のように、「プロジェクト→モジュール→プロシージャ→ステートメント」の構成でできています。

モジュールの中に複数のプロシージャがあり、プロシージャはステートメントでできています。これだけだとよくわからないと思うので、実際にVBEの画面で何がどれに該当するかわかるような画像を用意しました。

赤枠で囲っている部分がプロジェクトです。プロジェクト内にはモジュール(Module1)があります。Module1のコードが、右側に表示されているウィンドウの青枠部分です。

モジュール内には、Test1とTest2のプロシージャがあり、オレンジ色に下線を引いた1行ずつのコードがステートメントです。全ての言葉を覚える必要はありませんが、

程度にまずはざっくりと覚えておけばOKです！

プロシージャとは

次に、プロシージャについて簡単に解説します。プロシージャは、VBAの処理をまとめた機能です。さきほど解説した通り、モジュール内に書くことで作ることができます。

プロシージャの作り方は次のとおりです。プロシージャの作り方：

Sub プロシージャ名()
  'ここにVBAの処理を書く
End Sub

また、引数を使えば、値を渡して処理を実行することもできます。引数を使った例：

Sub プロシージャ名(引数の変数名1 as 型名,引数の変数名2 as 型名)
  'ここにVBAの処理を書く
End Sub

たとえば、「数値Xと数値Yをかけた結果を計算する処理」などをプロシージャで作る場合です。数値Xと数値Yをかけた結果を表示するサンプル：

Sub Test2(X As Integer, Y As Integer)
  
  'XとYをかけた結果をメッセージで表示
  MsgBox X * Y

End Sub

このように、引数を使ってプロシージャを作ることもできます。

プロシージャの作り方

次に、プロシージャの作り方について解説します。

事前準備：標準モジュールの作成

先ほど伝えた通り、プロシージャはモジュールに内に書いていくため、最初に標準モジュールを追加します。以下のように、「右クリック→挿入→標準モジュール」の順で選択することで、追加できます。

追加すると右側にコードウィンドウが表示されます。

Subプロシージャの作成方法

次に、Subプロシージャの作り方について解説します。「Sub プロシージャ名」を入力してからエンターキーを押すことで、Subプロシージャを作ることができます。

プロシージャ名にTestを入力してエンターキーを押した場合は、次のようなコードができます。作ったコード：

Sub Test()

End Sub

この中に処理(ステートメント)を書くことで、VBAの処理を作っていけるわけですね。

簡単なコードを書く方法

次に、簡単なサンプルコードを書く方法について解説します。「Sub プロシージャ名() ~ End Sub」の中に処理を書いていきます。

サンプルコード：

Sub Test()
  Range("A1").Value = "侍エンジニア"
End Sub

今回は、セルに値を書き込むRangeメソッドを使ったサンプルを用意しています。「Range(セル位置).Value = 値」でセルに値を書き込むことができます。

Rangeメソッドの詳しい使い方については以下で解説しているので、気になる方は見てみてくださいね！

プロシージャを実行する方法

次に、作ったプロシージャを実行する方法を解説します。プロシージャ内にカーソルを置いて、実行ボタンをクリックすることで簡単に作ったプロシージャを実行することができます。

実行方法：

実行後のセルデータ：

このように、簡単に作ったプロシージャを実行することができます。

補足：他のプロシージャから呼び出すことも可能

ちなみに、プロシージャは別のプロシージャから実行することもできます。別のプロシージャから実行する場合は、Callステートメントを使って次のように書きます。

Callステートメントで別のプロシージャを呼び出す方法：

Call プロシージャ名

先ほど作ったサンプルを実行する場合は、次のようになります。

サンプルコード：

Sub Main()
  
  'Testプロシージャを実行
  Call Test

End Sub

Sub Test()
  Range("A1").Value = "侍エンジニア"
End Sub

実行結果：

複雑な処理を1つのプロシージャだけで書いてしまうと、コードが読みづらくなってしまいます。また、エラーの原因も見つけづらくなってしまうため、適度にプロシージャを分けてCallステートメントで呼び出して作るのがおすすめです！

覚えておくと便利なFunctionプロシージャとは

プロシージャにはSubプロシージャ以外にも、Functionプロシージャがあります。Subプロシージャとの大きな違いは、「戻り値で結果を返すことができること」です。

たとえば、最初に紹介した「数値Xと数値Yをかけた結果を表示するサンプル」を、Functionプロシージャで書き換えると次のようになります。

Functionプロシージャで書き換えたサンプル：

Sub Main()
  
  'Functionプロシージャ(Test2)を実行
  MsgBox Test2(10, 5)

End Sub

Function Test2(X As Integer, Y As Integer) As Integer
  
  'XとYをかけた結果を返す
  Test2 = X * Y

End Function

実行結果：

XとYをかけた結果を返すFunctionプロシージャをTest2の名前で作成し、MainでTest(10,5)のように書くことで、10(Xの値)と5(Yの値)をかけた結果を取得して、MsgBoxで結果をメッセージに表示しています。

SubをFunctionに書き換えて、戻り値に設定する型を「as Integer」でプロシージャ名の右に追加しています。

このように、「処理した結果を返すプロシージャ」を作ることができるので、Functionプロシージャはとても便利です。Funcitonプロシージャの詳しい使い方については以下で解説しているので、気になる方は見てみてくださいね！

まとめ

今回は、プロシージャの使い方について解説しました。まずは、Subプロシージャの作り方・Callで実行する方法をやってみてください。

作るのが慣れてきたら、Functionプロシージャに置き換える方法を試す流れがおすすめです。ぜひ、やってみてくださいね！