Excel VBAコードの読み方|基本構造・オブジェクト・プロパティ・メソッドを解説

Level5 VBA・マクロ

Level5 VBA|クエスト3

勇者たんたん
勇者たんたん

VBAって知らない英単語ばかりで、何をしているコードなのか分からない……

VBAコードを見ると、英単語や記号が並んでいて、どこから読めばよいのか分からないことがあります。

たとえば、次のコードを見ても、初めてVBAを学ぶ段階では意味を想像しにくいかもしれません。

Worksheets("売上表").Range("A1").Value = "完了"

VBAコードは、すべての命令を暗記しなくても読めます。

まずはコードを、「何を」「どうする」に分けて考えましょう。

さらに、VBAでよく使われる次の3つの用語を理解すると、コードの役割を見分けやすくなります。

  • オブジェクト
  • プロパティ
  • メソッド

この記事では、SubとEnd Subで囲まれたVBAコードの基本構造と、オブジェクト・プロパティ・メソッドの読み方を解説します。

今回のゴール

VBAコードを見たときに、操作する対象と実行する処理を読み取れるようになりましょう。

VBAコードは上から順番に実行される

基本的なVBAコードは、上の行から順番に実行されます。

次のコードを見てみましょう。

Sub 売上表を準備する()

    Worksheets("売上表").Activate
    Range("A1").Value = "売上実績"
    Range("A2:C10").ClearContents

End Sub

このコードでは、次の処理が上から順番に実行されます。

  1. 「売上表」シートを操作対象にする
  2. A1セルへ「売上実績」と入力する
  3. A2からC10までのセル内容を消す

日本語の文章と同じように、コードにも読む順番があります。

最初からすべての単語を詳しく理解しようとするのではなく、まずはどの処理が、どの順番で実行されるのかを確認しましょう。

SubとEnd Subは処理の開始と終了を表す

VBAの基本構造

マクロとして実行される処理は、SubとEnd Subの間に記述します。

Sub マクロ名()

    実行する処理

End Sub

VBAで1つのマクロを作成するときは、基本的にコードをSubとEnd Subで囲みます。

Sub 売上表を準備する()

    Worksheets("売上表").Activate
    Range("A1").Value = "売上実績"

End Sub

このコードでは、次の部分がマクロの開始位置です。

Sub 売上表を準備する()

Subの後ろに書かれている「売上表を準備する」がマクロ名です。

そして、次の部分がマクロの終了位置です。

End Sub
処理目的がわかるようにマクロ名をつける

VBAコードを読むときは、最初にマクロ名を確認しましょう。マクロ名だけでも、コード全体の目的を予想できる場合があります。

ただし、マクロ名はコードを作成した人が自由に付けられます。実際の処理内容と完全に一致しているとは限らないため、マクロ名だけで判断せず、内部のコードも確認してください。

VBAコードは「何を・どうする」で読む

VBAコードを読むときは、英単語を1つずつ日本語に訳すのではなく、次の2つを探します。

VBAコードの読み方
  • 何を操作するのか(オブジェクト.プロパティ)
  • どのような処理をするのか(メソッド)
操作する対象.実行する処理

VBAにはさまざまな命令がありますが、最初から名前をすべて暗記する必要はありません。

たとえば、次のコードを見てみましょう。

Range("A1").Copy

このコードは、次のように分けられます。

  • Range("A1"):A1セルを
  • .Copy:コピーする

つまり、「A1セルをコピーする」という処理です。

もう1つ例を見てみましょう。

ThisWorkbook.Save

このコードは、次のように読めます。

  • ThisWorkbook:このマクロが保存されているブックを
  • .Save:保存する

VBAコードでは、操作する対象と処理の間にピリオドを付けることがあります。

コードを見たときに、「何を」「どうする」に分けて考えることが、VBAコードを読む第一歩です。

オブジェクトとは操作する対象のこと

VBAで操作する対象を、オブジェクトと呼びます。

Excelでは、次のようなものがオブジェクトに当たります。

  • Excelブック
  • ワークシート
  • セル
  • セル範囲
  • グラフ
  • 図形

オブジェクトは、VBAコードを「何を・どうする」で読んだときの「何を」に当たる部分です。

オブジェクト操作する対象指定例
WorkbookExcelブックWorkbooks("売上管理.xlsm")
WorksheetワークシートWorksheets("売上表")
Rangeセル・セル範囲Range("A1:C10")
Level5でよく利用するオブジェクト例

WorkbookはExcelブックを表す

Workbookは、1つのExcelブックを表すオブジェクトです。
一方、Workbooksは、Excelで開いている複数のブックをまとめたものです。

Workbooks("売上管理.xlsm")

このコードでは、開いているブックの中から「売上管理.xlsm」という1つのWorkbookオブジェクトを指定できます。

また、ブックを変数へ代入する場合は、次のようにWorkbookを使用します。

Dim 転記先 As Workbook
Set 転記先 = Workbooks("売上管理.xlsm")

Worksheetはワークシートを表す

Worksheetは、1枚のワークシートを表すオブジェクトです。
一方、Worksheetsは、ブック内にある複数のワークシートをまとめたものです。

Worksheets("売上表")

このコードでは、ブック内のワークシートから「売上表」という1つのWorksheetオブジェクトを指定できます。

また、ワークシートを変数へ代入する場合は、次のようにWorksheetを使用します。

Dim 転記元 As Worksheet
Set 転記元 = Worksheets("売上表")

Rangeはセルやセル範囲を表す

Rangeは、セルまたはセル範囲を表すオブジェクトです。

A1セルを指定する場合は、次のように記述します。

Range("A1")

A1からC10までのセル範囲を指定する場合は、次のように記述します。

Range("A1:C10")
Cells

セルを指定する方法には、RangeのほかにCellsを使う方法もあります。

しかし、Cellsは行番号と列番号を数字で指定するため、Excel初心者にはRangeより直感的に分かりにくい場合があります。本ブログでは、セル番地から対象を判断しやすいRangeを基本として扱います。

Range("A1")
Cells(1, 1)

大きな対象から小さな対象へ絞り込む

ブック、ワークシート、セルを組み合わせると、操作する対象を詳しく指定できます。

Workbooks("売上管理.xlsm").Worksheets("売上表").Range("A1")

左から順番に見てみましょう。

  1. Workbooks("売上管理.xlsm"):売上管理.xlsmというブック
  2. Worksheets("売上表"):その中にある売上表シート
  3. Range("A1"):そのシートにあるA1セル

このコードでは、ブックからワークシート、ワークシートからセルへと、操作する対象を絞り込んでいます。

コードが長いときは、ピリオドの位置で区切ると、それぞれの役割を確認しやすくなります。

プロパティとはオブジェクトの情報・状態・設定のこと

オブジェクトが持っている情報・状態・設定を、プロパティと呼びます。

Excelのセルには、次のような情報があります。

  • 入力されている値
  • 行番号
  • 列番号
  • 表示形式
  • 文字の色
  • 背景色

ブックやワークシートにも、名前や保存場所などの情報があります。

プロパティ表す情報・状態コード例
Valueセルに入っている値Range("A1").Value
Nameブックやシートなどの名前Worksheets(1).Name
Rowセルの行番号Range("A5").Row
Pathブックが保存されている場所ThisWorkbook.Path
Level5でよく利用するプロパティ例

Valueはセルの値を表す

Valueは、セルに入っている値を表すプロパティです。

Range("A1").Value = "完了"

このコードは、次のように読めます。

  • Range("A1"):A1セルの
  • .Value:値を
  • = "完了":「完了」にする

つまり、A1セルへ「完了」と入力するコードです。

Valueは、セルに値を書き込むだけでなく、セルから値を取得するときにも使用します。

Range("B1").Value = Range("A1").Value

このコードでは、A1セルの値をB1セルへ代入しています。

  • Range("B1").Value:B1セルの値を
  • Range("A1").Value:A1セルの値と同じにする

ブック間で値を転記する場合も、基本的な考え方は同じです。

VBAでの「=」は「←」

VBAにおける「=」には2つ役割があります。

  • 左矢印「←」として代入
  • 条件判定での完全一致

Nameは名前を表す

Nameは、ブックやワークシートなどの名前を表すプロパティです。

Worksheets(1).Name = "売上表"

このコードは、次のように読めます。

  • Worksheets(1):1番目のワークシートの
  • .Name:名前を
  • = "売上表":「売上表」にする

つまり、1番目のワークシートの名前を「売上表」へ変更する処理です。

Rowはセルの行番号を表す

Rowは、セルの行番号を表すプロパティです。

Range("A5").Row

この場合、A5セルの行番号である5を取得できます。

Level5では、データが入力されている最終行を調べたり、繰り返し処理の対象行を指定したりするときに、行番号を扱うことがあります。

Pathはブックの保存場所を表す

Pathは、ブックが保存されているフォルダーの場所を表すプロパティです。

ThisWorkbook.Path

このコードは、次のように読めます。

  • ThisWorkbook:このマクロが保存されているブックの
  • .Path:保存場所

ThisWorkbookは、実行しているVBAコードが保存されているブックを表します。

Pathは、別のブックを開いたり、処理後のファイルを保存したりするときに使用することがあります。

メソッドとはオブジェクトに実行させる処理のこと

オブジェクトに実行させる動作や処理を、メソッドと呼びます。

「何を・どうする」で読む場合、メソッドは主に「どうする」に当たります。

メソッド実行する処理コード例
CopyセルなどをコピーするRange("A1").Copy
ClearContentsセルの内容を消すRange("A1").ClearContents
Selectセルなどを選択するRange("A1").Select
Saveブックを保存するThisWorkbook.Save
Closeブックを閉じるWorkbooks("売上.xlsx").Close
Openブックを開くWorkbooks.Open "C:\売上.xlsx"
Deleteシートなどを削除するWorksheets("一時表").Delete
Activateブックやシートを操作対象にするWorksheets("売上表").Activate
Level5でよく利用するメソッド例

Copyは対象をコピーする

Copyは、セルやセル範囲などをコピーするメソッドです。

Range("A1").Copy

このコードは、次のように読めます。

  • Range("A1"):A1セルを
  • .Copy:コピーする

コピーしたデータは、別のセルやワークシート、ブックなどへ貼り付けられます。

ClearContentsはセルの内容を消す

ClearContentsは、セルに入力されている値や数式を消すメソッドです。

Range("A1:C10").ClearContents

このコードは、A1からC10までのセル内容を消します。

セルに設定されている書式は、基本的に残ります。そのため、作成済みの表へ新しいデータを転記する前に、古い内容を消す処理などで使用できます。

Selectは対象を選択する

Selectは、セルやセル範囲などを選択するメソッドです。

Range("A1").Select

このコードを実行すると、A1セルが選択されます。

Save・Close・Openはブックを操作する

Saveは、ブックを保存するメソッドです。

ThisWorkbook.Save

Closeは、ブックを閉じるメソッドです。

Workbooks("売上.xlsx").Close

Openは、指定したブックを開くメソッドです。

Workbooks.Open "C:\売上.xlsx"

Openの後ろにある"C:\売上.xlsx"は、開くファイルの場所です。
ファイル場所込みのフルパスの調べ方はこちらをご覧ください。

ブック間転記では、次のような流れで複数のメソッドを使用することがあります。

  1. Openで転記先ブックを開く
  2. Copyなどでデータを転記する
  3. Saveで転記先ブックを保存する
  4. Closeで転記先ブックを閉じる

それぞれの詳しい書き方はこちらをご覧ください。

Deleteは対象を削除する

Deleteは、シートなどを削除するメソッドです。

Worksheets("一時表").Delete

このコードを実行すると、「一時表」というワークシートが削除されます。

Deleteは確認必須

Deleteを実行すると、指定したシートなどが削除されます。VBAで削除した内容は元に戻せない場合があるため、ブック名やシート名を確認してから実行してください。

Activateは操作対象を切り替える

Activateは、指定したブックやワークシートを操作対象にするメソッドです。

Worksheets("売上表").Activate

このコードを実行すると、「売上表」シートが画面へ表示され、操作対象になります。

SelectとActivateは必ず必要とは限らない

SelectとActivateは、マクロの記録で作成したコードによく登場します。

Worksheets("売上表").Activate
Range("A1").Select
ActiveCell.Value = "完了"

このコードでは、「売上表」シートへ切り替え、A1セルを選択してから「完了」と入力しています。

しかし、操作する対象を直接指定すれば、次のように書くこともできます。

Worksheets("売上表").Range("A1").Value = "完了"

この場合、「売上表」シートを画面へ表示したり、A1セルを選択したりしなくても処理できます。

SelectやActivateが間違いというわけではありません。ただし、操作する対象を直接指定できる場合は、省略することでコードを短くできることがあります。

オブジェクト・プロパティ・メソッドを見分ける

オブジェクト・プロパティ・メソッド
  • オブジェクト:操作する対象である「何を」
  • プロパティ:対象が持つ「情報・状態・設定」
  • メソッド:対象に実行させる「動作・処理」

ここまでの内容を、同じ対象を使ったコードで比較してみましょう。

Worksheets("売上表").Range("A1").Value = "完了"

このコードには、オブジェクトとプロパティが使用されています。

  • Worksheets("売上表"):売上表シートを表すオブジェクト
  • Range("A1"):A1セルを表すオブジェクト
  • Value:セルの値を表すプロパティ
  • = "完了":プロパティへ設定する内容

コード全体では、「売上表シートにあるA1セルの値を『完了』にする」と読めます。

続いて、メソッドを使用したコードを見てみましょう。

Worksheets("売上表").Range("A1").Copy
  • Worksheets("売上表"):売上表シートを表すオブジェクト
  • Range("A1"):A1セルを表すオブジェクト
  • Copy:対象をコピーするメソッド

コード全体では、「売上表シートにあるA1セルをコピーする」と読めます。

同じA1セルを操作するコードでも、Valueを指定すればセルの値を扱い、Copyを指定すればセルをコピーする処理を実行します。

長いVBAコードを読む手順

長いコードを見るときも、最初からすべてを理解する必要はありません。

次の順番で確認しましょう。

コードの読み方
  1. Subの後ろにあるマクロ名を確認する
  2. コードを上から順番に確認する
  3. ピリオドの位置でコードを区切る
  4. 「何を・どうする」に置き換える

1.Subの後ろにあるマクロ名を確認する

Sub 売上データを転記する()

まずは、マクロ名からコード全体の目的を予想します。

この例では、売上データを転記するためのマクロだと考えられます。

2.コードを上から順番に確認する

基本的なVBAコードは、上の行から順番に実行されます。

最初にブックを開き、その後にセルの値を転記し、最後に保存するコードであれば、処理全体の流れを把握できます。

3.ピリオドの位置でコードを区切る

Workbooks("売上管理.xlsm").Worksheets("売上表").Range("A1").Value

長いコードは、ピリオドの位置で区切ってみましょう。

  • Workbooks("売上管理.xlsm")
  • Worksheets("売上表")
  • Range("A1")
  • Value

ブックからワークシート、ワークシートからセルへ対象を絞り込み、最後にセルの値を指定していることが分かります。

4.「何を・どうする」に置き換える

Workbooks("売上管理.xlsm").Save

このコードなら、次のように読みます。

  • 何を:売上管理.xlsmを
  • どうする:保存する
Worksheets("一時表").Delete

このコードなら、次のように読めます。

  • 何を:一時表シートを
  • どうする:削除する

知らない単語があっても、操作する対象と処理を見つけられれば、コードの大まかな役割を判断できます。

まとめ|VBAコードを「何を・どうする」で読もう

VBAコードは、すべての命令を暗記しなくても読めます。

このクエストで覚えること
  • SubからEnd Subまでが1つのマクロの基本範囲
  • 基本的なコードは上から下へ実行される
  • オブジェクトは操作する対象
  • プロパティは対象の情報・状態・設定
  • メソッドは対象に実行させる処理
  • 長いコードはピリオドの位置で区切る
  • VBAコードは「何を・どうする」に置き換えて読む

コード内の英単語をすべて覚える必要はありません。

分からない単語が出てきたときは、その都度意味を調べれば問題ありません。

VBAコードを暗記するのではなく、コードの構造を読み取り、必要な部分を安全に変更できることを目指しましょう。

次のクエストへ

今回のクエストでは、VBAの基本構造を学習しました。

次のクエストでは、VBAでセルやセル範囲を指定するときに使用するRangeについて、さらに詳しく確認します。

コード内のセル番地を安全に変更し、目的に合った範囲を指定できるようになりましょう。

Level5の学習順序を確認したい方は、Level5攻略フローをご覧ください。

コメント

タイトルとURLをコピーしました