メインコンテンツへスキップ
見出し画像

Excel(VBA)で「干支タイピング」を作る!解説編

    こんにちは「つけらっとゲームス」プログラム担当のとちです。
    今回はExcel(VBA)で作った簡単なタイピングゲームの中身を解説します。
    解説対象は応用編を適用したものとなります。

    続きの記事です。同テーマの前回記事はコチラからどうぞ!


    プログラムの大まかな構造

    コード解説をする前に「干支タイピング」のおおまかな構造を確認してみましょう。ゲーム本体の.xlsmファイルと周辺のフォルダを振り返ります。

    画像
    .xlsmファイル周辺

    ゲーム本体が入っている.xlsmファイル(Excelのファイル)と同じ階層に2つのフォルダがあります。imageフォルダとsoundフォルダですね。

    imageフォルダにはタイピングの問題とタイトル画像が入っています。

    画像
    imageフォルダの中身

    soundフォルダにはゲーム中に再生されるBGMとSEが入っています。

    画像
    soundフォルダの中身

    次にプロジェクトエクスプローラー(下のスクショ)をご覧ください。
    これは.xlsmファイルを開いて開発環境に入ると左上に表示されるものです。

    シートが2つあって、ユーザーフォームが1つ、標準モジュールが1つ追加されていることがわかりますね。それぞれを軽く説明します。

    画像

    Sheet1(EtoData) はタイピングゲームの答えが設定されています。
    十二支の漢字とひらがな表記が並んでいます。応用編で追加されたBGMとSEの音量もここで設定されています。

    Sheet2(Ranking) は10問解答に成功するまでの時間が記録されます。
    漢字とひらがなOKモードと、漢字のみのモードのベスト5を記録します。

    フォーム EtoTyping はゲーム画面ですね。ゲームを構成するプログラムのほとんどがコチラにあります。プレイヤーから見るとフォームしか見えていませんし、当然と言えば当然ですが…

    標準モジュール Module1 にはタイムアタック系のゲームでは必須のタイマー処理関連のコードがあります。逆に言えばこの機能を表現できなければタイムアタック系のゲームは味気ないモノになります。

    つまり、Module1 が非常に重要な部分だったりします。


    プロシージャまとめ

    実際のコードの中身を確認する前に、プロシージャがどれくらいあるのかを確認してみましょう。

    プロシージャとは「プログラムの部品」のようなものです。
    ゲームという大きなプログラムを組み立てるための1つの部品(パーツ)のようなモノだと考えてください。

    画像

    上の図を見ると、それぞれのプロシージャが大まかな処理を担っているのがわかると思います。ではゲームが正常に動作している場合、これらのプロシージャがどのように関連付いて動いているのかを図にしてみます。

    画像

    上図の左側はゲームの流れに沿って動くプロシージャを表現しています。
    点線から右側は特定のタイミングで呼び出されるプロシージャです。

    それぞれの役割を各プロシージャに持たせることによって、必要に応じて何回もプロシージャを呼び出すことができます。

    これは他のゲームであっても、使うツール(ゲームエンジン)が違っていても同じようなことが言えます。クラス、関数、サブルーチンなどと呼ばれる部品にわけておくと再利用ができるわけです。便利ですね!


    コード解説

    ここから以降はコード解説になりますが、コメント部分に1行毎の解説が記載されています。コメントを読んで理解できるのであれば以下の解説は不要です。

    コードを自分なりに解析してみるのも良い練習になります。
    もし可能であればチャレンジしてみてね!

    それでは各プロシージャの中身を確認していきますね。


    OnTimeStart()

    まずは標準モジュールの OnTimeStart の周囲からチェックします!

    Option Explicit
    
    Public STtime As Date                                               '【変数定義】ゲーム開始タイム
    Public DPtime As Date                                               '【   〃   】次の処理タイム(1秒後)
    
    '--------------------------------------------------------------------
    '  OnTimeStart  タイマー処理開始 (1秒後の処理予約)
    '
    '   引数    なし
    '
    '   戻値    なし
    '
    '--------------------------------------------------------------------
    Sub OnTimeStart()
        EtoTyping.GameTime.Caption = Format(Now() - STtime, "h:nn:ss")  ' 現在時から開始時を引き算してゲーム表示タイムを算出
        DPtime = Now() + TimeValue("00:00:01")                          ' 次の処理タイム(1秒後)を算出
        Call Application.OnTime(DPtime, "OnTimeStart")                  ' 1秒後の処理予約
    End Sub

    最初の1行目にある「Option Explicit」ですが、おまじないのようなものだと思っていただいて構いません。が、説明をするとコチラの記事の「冒頭部分の解説」に詳しくあります。気になったら読んでみてくださいね!

    2~3行目は、このゲームのプログラムであればどこからでも参照できるpublic変数を定義しています。このような変数はユーザーフォームからも参照できます。タイムアタックに必要なタイム関連の変数を管理します。

    いよいよ OnTimeStart の中身に入るわけですが、ここではタイマー処理の開始をします。

    EtoTyping.GameTime.Caption = ~ の行では経過時間を画面表示します。

    単純に10問解答までの時間を計測するのであれば、開始時と終了時の時間だけ記憶しておけば大丈夫なんですけど、ゲーム画面に経過タイムを表示したいので、Application.OnTime を使っています。

    ちょっとだけ余談。ゲーム画面に経過タイムを表示したい!

    この欲(?)がゲーム作成に必要な感情といえるでしょう…〇〇を実現したいと思ったら、実現できる方法を考える(または調べる)のです。これを繰り返すことによって色々な処理を覚えるんです。

    忘れちゃっても大丈夫。
    1回作れば、忘れても自分で作ったコードをコピペすればいいんです。

    Application.OnTime は、決まった時間に動く処理を予約しておく仕組みです。このコードでは1秒後に再度このプロシージャを動くようにしています。その1秒後にも更に1秒後に予約をします。

    よって、終了を指示するまで1秒後に予約するを繰り返し、経過時間を画面表示し続けるわけです。


    OnTimeStop()

    ここでは予約されているハズの OnTimeStart() をキャンセルします。

    '--------------------------------------------------------------------
    '  OnTimeStop   タイマー停止 (1秒後の処理予約を取り消し)
    '
    '   引数    なし
    '
    '   戻値    なし
    '
    '--------------------------------------------------------------------
    Sub OnTimeStop()
        On Error Resume Next                                            ' エラーが出ても止まらずに次へ進む
        Call Application.OnTime(DPtime, "OnTimeStart", , False)         ' 予約されている処理をキャンセル
        On Error GoTo 0                                                 ' 通常のエラー処理に戻す
    End Sub
    

    1行目ではエラーが出ても止まることなく次の処理をするように指示しています…というのも予約されていない可能性もあるからです。

    2行目はキャンセル指示ですね。

    3行目は先程エラーが出ても止まることなく次の処理をする指示をしていたので元に戻しています。


    UserForm_Initialize()

    次はフォーム EtoTyping に記述されているコードを確認していきます。
    ここではフォームの初期化時に動作する UserForm_Initialize() と、その周辺を見ていきます。

    Option Explicit
    
    Dim EtoImg(1 To 13)         As Object                           '【配列定義】干支画像
    Dim EtoSW(1 To 13)          As Integer                          '【   〃   】干支画像出題スイッチ [0]未出題 [1]出題済
    Dim AnsTxt(1 To 13, 1 To 2) As String                           '【   〃   】干支正解文字列
    Dim AnsIx                   As Integer                          '【変数定義】干支正解位置index
    Dim QuesNo                  As Integer                          '【   〃   】出題数 (10問でゴール)
    
    Dim SudDire                 As String                           '【変数定義】[AD] サウンドのフォルダパス
    Dim SudStpSW                As Integer                          '【   〃   】[AD] サウンドの停止スイッチ [0]停止する [1]停止しない
    Dim Vol_BGM                 As Integer                          '【   〃   】[AD] 音量BGM
    Dim Vol_SE                  As Integer                          '【   〃   】[AD] 音量SE
    
    Dim RDate(1 To 2, 1 To 6)   As Date                             '【配列定義】[AD] 記録した日時 / [1]漢字かな [2]漢字のみ , 1~6位まで
    Dim RTime(1 To 2, 1 To 6)   As Integer                          '【   〃   】[AD] 記録(秒数)   / [1]漢字かな [2]漢字のみ , 1~6位まで

    冒頭部分はフォームのコードであれば、どこでも使用できる配列および変数を定義しています。3つの塊に分かれて記述されていますね。

    最初の塊では問題と正解に関連するものです。
    使用される干支の画像と、それが出題されたかどうか、答え、正解のある場所、何問目かを判断する出題数が定義されています。

    次の塊はサウンド関連ですね。BGMやSEが置かれているフォルダパス(ディレクトリパス)や音量を保持する変数が定義されています。

    最後の塊は、経過タイムの記録関連です。

    さて、実際にフォーム初期化時の処理に入っていくわけですが、ゲーム開始時の初期設定ですので長いようにみえて大したことをやっていません。

    
    '--------------------------------------------------------------------
    '  フォーム初期化時
    '
    '   引数    なし
    '
    '   戻値    なし
    '
    '--------------------------------------------------------------------
    Private Sub UserForm_Initialize()
        
        Dim ImgPath As String                                       '【変数定義】干支画像のパス
        Dim ImgDire As String                                       '【   〃   】干支画像のフォルダパス
        Dim iNo     As String                                       '【   〃   】干支画像のパス作成用カウンタ
        Dim i       As Integer                                      '【   〃   】ループカウント
        
        Randomize                                                   ' ランダム関数の初期化
        ImgDire = ThisWorkbook.Path & "\Image\"                     ' 干支画像のフォルダパスを取得
        SudDire = ThisWorkbook.Path & "\Sound\"                     ' [AD] サウンド(BGM/SE)のフォルダパスを取得
    
        For i = 1 To 13                                             ' ■ループ
            iNo = i                                                 ' ├パス作成用カウンタを取得
            If i <= 9 Then iNo = "0" & iNo                          ' ├◆ループカウンタが9以下の場合 >> パス作成用カウンタを2桁にする
            ImgPath = ImgDire & "Eto" & iNo & ".jpg"                ' ├干支画像のパスを生成
            Set EtoImg(i) = LoadPicture(ImgPath)                    ' ├干支画像を読み込んで配列に格納
            AnsTxt(i, 1) = Worksheets("EtoData").Cells(i, 1)        ' ├干支正解文字列(漢字)
            AnsTxt(i, 2) = Worksheets("EtoData").Cells(i, 2)        ' ├干支正解文字列(かな)
        Next i                                                      ' └ループ終端
        
        Vol_BGM = Worksheets("EtoData").Cells(14, 2)                ' [AD] ワークシートからBGM音量取得
        Vol_SE = Worksheets("EtoData").Cells(15, 2)                 ' [AD] ワークシートから SE音量取得
    
        For i = 1 To 5                                              ' ■ [AD] これまでのランキングデータを取得するループ
            RDate(1, i) = Worksheets("Ranking").Cells(i + 2, 2)     ' ├ [AD] 漢字かな 記録した日時
            RTime(1, i) = Worksheets("Ranking").Cells(i + 2, 3)     ' ├ [AD] 漢字かな 記録(秒数)
            RDate(2, i) = Worksheets("Ranking").Cells(i + 2, 5)     ' ├ [AD] 漢字のみ 記録した日時
            RTime(2, i) = Worksheets("Ranking").Cells(i + 2, 6)     ' ├ [AD] 漢字のみ 記録(秒数)
            If RTime(1, i) <= 0 Then RTime(1, i) = 9999             ' ├◆ [AD] 漢字かな 記録(秒数)が0以下(初期値)の場合 >> 9999とする
            If RTime(2, i) <= 0 Then RTime(2, i) = 9999             ' ├◆ [AD] 漢字のみ 記録(秒数)が0以下(初期値)の場合 >> 9999とする
        Next i                                                      ' └ [AD] ループ終端

    Randomize はランダムシード(種)の初期化です。
    ランダム関数は同じシードの場合は同じ乱数を取得してしまいます。

    Randomize に引数を与えずに動かすと現在時刻を元にシードを設定してくれるので毎回違う結果が得られるようになります。逆に決まったシード値を与えることで再現性のある乱数を取得できるようになります。

    ・For i = 1 To 13 ~
    このFor文ループでは干支画像(問題画像)と、その正解をシート EtoData から取得しています。

    ・Vol_BGM = ~
    ・Vol_SE = ~
    ここではシート EtoData からサウンドの音量を取得しています。

    ・For i = 1 To 5 ~
    このFor文ループでは10問解答までの経過時間記録をシート Ranking から取得します。まだ記録が入っていない順位には9999秒を入れておきます。

        EtoTyping.Height = 402                                      ' フォーム高
        EtoTyping.Width = 396                                       ' フォーム幅
        ImgTitle.Top = 6                                            ' タイトル画像 y位置
        ImgTitle.Left = 6                                           ' タイトル画像 x位置
        ImgGameOver.Top = 366                                       ' ゲームオーバー画像 y位置
        ImgGameOver.Left = 450                                      ' ゲームオーバー画像 x位置
        TxGameOver.Top = 444                                        ' ゲームオーバーText y位置
        TxGameOver.Left = 450                                       ' ゲームオーバーText x位置
        Btn_Start.Top = 318                                         ' スタートボタン y位置
        Btn_Start.Left = 156                                        ' スタートボタン x位置
        KanaCHK.Top = 318                                           ' [AD] かなチェック y位置
        KanaCHK.Left = 240                                          ' [AD] かなチェック x位置
        
        inpText.Visible = False                                     ' 入力欄 非表示
        Btn_Enter.Visible = False                                   ' 決定ボタン 非表示
        Btn_neko.Visible = False                                    ' ないボタン 非表示
        Btn_Start.Visible = True                                    ' スタートボタン 表示
        Btn_Start.ZOrder (0)                                        ' スタートボタン 最前列へ
        
        QuestionNo.BorderStyle = fmBorderStyleNone                  ' 出題数の枠線 非表示
        GameTime.BorderStyle = fmBorderStyleNone                    ' タイムの枠線 非表示
        TxGameOver.BorderStyle = fmBorderStyleNone                  ' ゲームオーバーTextの枠線 非表示
        
        SudStpSW = 1                                                ' [AD] サウンド停止スイッチを[1]停止しない
        WMP1.settings.volume = Vol_BGM                              ' [AD] WindowsMediaPlayer1 音量変更
        WMP2.settings.volume = Vol_SE                               ' [AD] WindowsMediaPlayer2 音量変更
        WMP1.Controls.stop                                          ' [AD] WindowsMediaPlayer1 停止
        WMP1.Url = SudDire & "BGM1.mp3"                             ' [AD] WindowsMediaPlayer1 に BGM1のファイルパスを入れる
        WMP1.Controls.Play                                          ' [AD] WindowsMediaPlayer1 再生
    
    End Sub

    UserForm_Initialize() の後半は長く見えますが…各オブジェクトのプロパティ設定を行っているだけです。4つの塊に分かれていますね。

    ・EtoTyping.Height = 402 ~
    この塊ではフォームのサイズ(高さや幅)および、各オブジェクトの表示位置を数字で直接指定します。

    ・inpText.Visible = False ~
    ここでは入力欄やボタン類の表示/非表示を切り替えています。

    ・QuestionNo.BorderStyle = ~
    この塊は各オブジェクトの枠線を非表示化しています。

    ・ SudStpSW = 1 ~
    ここではサウンド関連の設定をしています。
    BGMとSEの音量を設定し、BGMを停止(初期化)します。
    再生するBGMのパスを設定し、そのBGMを再生させます。


    UserForm_QueryClose()

    先程のプロシージャはフォーム初期化時の処理でした。コチラはフォームを閉じた時の処理が記述されています。

    '--------------------------------------------------------------------
    '  フォーム閉じた時
    '
    '   引数    Cancel      0以外でQueryCloseイベントが停止する
    '           CloseMode   QueryClose発生原因
    '
    '   戻値    なし
    '
    '--------------------------------------------------------------------
    Private Sub UserForm_QueryClose(Cancel As Integer, CloseMode As Integer)
        Call OnTimeStop                                             ' タイマー処理を停止
        SudStpSW = 0                                                ' [AD] サウンド停止スイッチを[0]停止する に変更
        WMP1.Controls.stop                                          ' [AD] WindowsMediaPlayer1 停止
        WMP2.Controls.stop                                          ' [AD] WindowsMediaPlayer2 停止
    End Sub

    ゲーム中に✕ボタンをクリックして終了する場合もあるでしょう。
    なので、まずは OnTimeStop を呼び出して予約をキャンセルします。

    鳴っているサウンドも停止させる必要があります。
    単純にBGMを停止させると、曲の最後まで流したと勘違いしてループ再生されてしまうので、サウンド停止スイッチを 0 にしています。

    その後は WindowsMediaPlayer を停止させています。
    ちなみに WindowsMediaPlayer つまり WMP1 はBGMを、WMP2 はSEの再生を担当しているオブジェクトです。


    Btn_Start_Click()

    このプロシージャはスタートボタンをクリックした時に動作します。
    プロシージャの中身をみると、大まかに3つの塊に分かれていますね。

    '--------------------------------------------------------------------
    '  スタートボタン クリック時
    '
    '   引数    なし
    '
    '   戻値    なし
    '
    '--------------------------------------------------------------------
    Private Sub Btn_Start_Click()
        Dim i As Integer                                            '【変数定義】ループカウンタ
        
        QuesNo = 0                                                  ' 出題数をクリア
        ImgTitle.Left = 800                                         ' タイトル画像      を画面外へ
        Btn_Start.Left = 800                                        ' スタートボタン    を画面外へ
        ImgGameOver.Left = 800                                      ' ゲームオーバー画像を画面外へ
        TxGameOver.Left = 800                                       ' ゲームオーバーTextを画面外へ
        KanaCHK.Left = 800                                          ' [AD] かなチェック を画面外へ
        inpText.Visible = True                                      ' 入力欄            を表示
        Btn_Enter.Visible = True                                    ' 決定ボタン        を表示
        Btn_neko.Visible = True                                     ' ないボタン        を表示
        Btn_Start.Visible = False                                   ' スタートボタン    を非表示
        KanaCHK.Visible = False                                     ' [AD] かなチェック を非表示
    
        For i = 1 To 13                                             ' ■ループ
            EtoSW(i) = 0                                            ' ├干支画像出題スイッチのクリア
        Next i                                                      ' └ループ終端
        
        Call GetNextQuestion                                        ' 次の問題を取得
        Module1.STtime = Now()                                      ' ゲームスタート時を取得
        Call OnTimeStart                                            ' タイマー処理開始
        Call SoundEffectPlay(5)                                     ' [AD] 決定音の再生
    
    End Sub

    ・QuesNo = 0 ~
    この塊ではタイトル画面に使用されているオブジェクトを画面外に移動させ、ゲーム中に使用するオブジェクトを非表示から表示に切り替えます。

    ・For i = 1 To 13 ~
    このFor文ループでは出題された干支画像の出題済みスイッチを初期化しています。

    はじめてここを通る時は、どの問題も出題されていないのであまり意味がない処理ですが、2回目以降(ゲームを再度プレイした時)に、出題された問題が再度出題されるようになります。

    ・Call GetNextQuestion
    この塊では各プロシージャを呼び出してゲームを開始しています。
    まず出題するために問題を取得します。
    つぎに現在の時間を取得します。これはタイム計測の為ですね。

    3行目では1秒毎のカウントをするために1秒後の処理予約を行います。
    最後にボタンを押下(またはクリック)した時の効果音を鳴らしています。


    Btn_Enter_Click() 

    このプロシージャはタイピング後に「決定」ボタンをクリックした時に動作するイベントプロシージャです。

    クリックした時と説明しましたが、クリックだけじゃなくEnterキーを押下された時も反応します。なのでゲーム中はキーボードだけで操作可能です。

    クリックのみだとしたら操作性が悪いゲームになってしまいます。
    では、なぜ文字入力欄の次に決定ボタンにフォーカスが移るのか?

    これはプロパティ欄をみると仕組みがわかります。

    画像
    各ボタンのプロパティ欄(前々回のものを再掲)

    オレンジ枠の部分を見るとTabStopがTrueとなっており、TabIndexが1~3と順に並んでいます。実際にゲームを動かし入力欄にカーソルがある状態でTabキーを押すと「決定」「ない」ボタンへと移っていきます。

    次、フォーカスが移るオブジェクトはここで指定されているんですね。
    というのを踏まえてコードの中身を確認しましょう。

    '--------------------------------------------------------------------
    '  決定ボタン クリック時
    '
    '   引数    なし
    '
    '   戻値    なし
    '
    '--------------------------------------------------------------------
    Private Sub Btn_Enter_Click()
        
        Dim okSW As Integer                                         '【変数定義】正解スイッチ [0]不正解 [1]正解
        Dim i    As Integer                                         '【   〃   】ループカウンタ
        Dim j    As Integer                                         '【   〃   】[AD] ループ上限
        
        inpText.SetFocus                                            ' 入力欄にカーソル移動
        
        If AnsIx = 13 Then                                          ' ■ AnsIx = 13(猫の場合)
            Call SoundEffectPlay(2)                                 ' ├ [AD] 不正解音を再生
            Exit Sub                                                ' └ この処理を抜ける
        End If
        
        j = 2                                                       ' [AD] 正解チェック時に かな まで含める
        If KanaCHK.Value = False Then j = 1                         ' [AD] ■ かなチェックにチェックが無い場合 >> 正解チェック時に かな を含めない
        
        For i = 1 To j                                              ' ■ ループ
            If inpText.Value = AnsTxt(AnsIx, i) Then okSW = 1       ' ├ ◆入力欄と干支正解文字列(AnsIx)が同じなら正解スイッチに[1]を入れる
        Next i                                                      ' └ ループ終端

    ・inpText.SetFocus
    これは文字入力欄にフォーカス(カーソル)を移動させています。
    決定ボタンでEnterを押下した後は、正解であれ不正解であれ再度文字入力が必要となります。なので文字入力欄をフォーカスしています。

    先程の説明とは逆、カーソルは遡る動きをします。この場合はプロパティ欄ではなくコードで指定してあげましょう。

    ・If AnsIx = 13 Then ~
    AnsIx 
    は後述する GetNextQuestion() で決定します。AnsIx が13というのは、シート EtoData の13番目が答えという意味です。つまりネコの画像が表示されている場合、干支は存在しません。

    ネコが表示されているのに「決定」が押下されているので不正解のSEを再生し、この処理自体を終了します(抜けます)。

    ・j = 2
    ・If KanaCHK.Value = False Then j = 1
    ここでは変数 j に初期値2を格納した後で、KanaCHKの中身を確認しFalseであれば変数 j を1にしています。KanaCHKはタイトル画面に表示されるチェックボックスです。

    チェックボックスにチェックが入っている(True)の場合は漢字とひらがなで正解か判断します。チェックが入っていない(False)場合は漢字のみで正解の判断をします。

    ・For i = 1 To j ~
    このFor文ループで表示されている画像に対する入力が正解かを判断しています。ひとつ前のIf文で変数 j を 2 or 1 にする理由はここにあります。
    変数 j をループの終了条件に使っているところに注目してください。

    正解かどうかの判断を1度だけ、または2度行うことがわかります。
    シート EtoDataのA列は漢字、B列はひらがなで答えが入っています。

    ループ1回目では漢字のチェックをしており、2回目はひらがなのチェックをしているんですね。漢字のみの場合はループを使っていますが1回だけFor文の中を通っています。

    また、このループの中にあるIf文によって入力欄の文字列と答えを比較します。比較した結果、正しければ変数 okSW に1が入ります。不正解であれば okSW には0が入っています。

        If okSW = 0 Then                                            ' ■ [AD] 不正解の場合
            Call SoundEffectPlay(2)                                 ' ├ [AD] 不正解音を再生
            Exit Sub                                                ' └ [AD] この処理を抜ける
        End If
        
        If okSW = 1 Then                                            ' ■ 正解の場合
            inpText.Value = ""                                      ' ├ 入力欄をクリア
            If QuesNo >= 10 Then                                    ' └ ◆ 出題数が10以上の場合
                Call SoundEffectPlay(9)                             '    ├ [AD] クリア音の再生
                Call Rtn_GameOver                                   '    ├ ゴール処理
            Else                                                    '    ◆ 出題数が10以上ではない場合
                Call SoundEffectPlay(1)                             '    ├ [AD] 正解音の再生
                Call GetNextQuestion                                '    └ 次の問題を取得
            End If
        End If
    End Sub

    ・If okSW = 0 Then ~
    ここまでで変数 okSW には正解の場合は1、不正解であれば0が入っているハズです。このIf文では不正解の場合を扱います。不正解の効果音を鳴らして、これ以後の処理を抜けます(処理を行いません)

    ・If okSW = 1 Then ~
    先程は不正解の処理でした。このIf文は正解の場合の処理です。
    正解した場合は入力欄の中身を空文字("")にしています。その後、もう一度If文による判断が行われます。

    ・If QuesNo >= 10 Then ~
    出題数が10問以上の場合はコチラの処理を行います。つまりゲーム終了時の処理です。クリア時の効果音を鳴らしゴール処理である Rtn_GameOver
    プロシージャを呼び出しています。

    これに対し Else 以降は9問以下の場合です。
    正解の効果音を再生し、次の問題を取得する GetNextQuestion プロシージャを呼び出しています。


    Btn_neko_Click()

    「決定」ボタンに対し、こちらは「ない」ボタンをクリックした時(またはEnterキーを押下した時)に発生します。ちなみに、このボタンを使用するタイミングはネコ画像が表示されている時のみです。

    '--------------------------------------------------------------------
    '  ないボタン クリック時 (ネコの場合のみ有効)
    '
    '   引数    なし
    '
    '   戻値    なし
    '
    '--------------------------------------------------------------------
    Private Sub Btn_neko_Click()
        
        inpText.SetFocus                                            ' 入力欄にカーソル移動
        If AnsIx <> 13 Then                                         ' ■ AnsIx <> 13(猫以外の場合)
            Call SoundEffectPlay(2)                                 ' ├ [AD] 不正解音を再生
            Exit Sub                                                ' └ この処理を抜ける
        End If
        If QuesNo >= 10 Then                                        ' ■ 出題数が10以上の場合
            Call SoundEffectPlay(9)                                 ' ├ [AD] クリア音の再生
            Call Rtn_GameOver                                       ' ├ ゴール処理
        Else                                                        ' ■ 出題数が10以上ではない場合
            Call SoundEffectPlay(1)                                 ' ├ [AD] 正解音の再生
            Call GetNextQuestion                                    ' └ 次の問題を取得
        End If
    End Sub

    ・inpText.SetFocus
    文字入力欄にフォーカス(カーソル)を移動させています。
    ないボタンでEnterを押下した後は、正解であれ不正解であれ再度文字入力が必要となるハズ…なので文字入力欄をフォーカスしています。

    ・If AnsIx <> 13 Then ~
    このIf文は AnsIx が13以外の場合の処理をしています。
    AnsIx が13であれば、ネコ(ない)が正解です。13以外ということは十二支が存在しているので、このボタンを押した時点で不正解です。

    なので、不正解の効果音を再生し、この処理を抜けます(処理しない)

    ・If QuesNo >= 10 Then ~
    このIf文は、Btn_Enter_Click()プロシージャにもありますね。
    意味も全く同じです。

    出題数が10問以上の場合はクリアのSEを鳴らしゴール処理を行います。
    Else以後は9問以下なので正解のSEを鳴らし、次の問題を取得します。


    Rtn_GameOver()

    このプロシージャは10問正解後に発生するゴール処理です。
    この処理が行われるとゲームが1セット終了ということですね。

    中身を見ると変数定義以外では大きく5つの塊に分かれています。
    順にチェックしていきましょう。

    '--------------------------------------------------------------------
    '  Rtn_GameOver ゴール処理
    '
    '   引数    なし
    '
    '   戻値    なし
    '
    '--------------------------------------------------------------------
    Private Sub Rtn_GameOver()
    
        Dim wTx As String                                           '【変数定義】表示文字列の編集用
        Dim wHH As Integer                                          '【  〃   】[AD] 記録(時)
        Dim wMM As Integer                                          '【  〃   】[AD] 記録(分)
        Dim wSS As Integer                                          '【  〃   】[AD] 記録(秒)
        
        Call OnTimeStop                                             ' タイマー停止
        wTx = "ゴール!" & Chr(13) & Chr(13)                        ' 表示文字列の編集
        wTx = wTx & "Time : " & GameTime.Caption                    ' 表示文字列の編集
        TxGameOver.Caption = wTx                                    ' ゴールとタイム表示
        
        wHH = Hour(GameTime.Caption)                                ' [AD] 00:00:00 形式の「時」の部分を取得する
        wMM = Minute(GameTime.Caption)                              ' [AD] 00:00:00 形式の「分」の部分を取得する
        wSS = Second(GameTime.Caption)                              ' [AD] 00:00:00 形式の「秒」の部分を取得する
        
        If wHH <= 0 Then                                            ' ■ [AD] 記録(時)が0以下の場合 (1時間超の場合は記録を残さない)
            wSS = wMM * 60 + wSS                                    ' ├ [AD] 分の部分を秒に変換し秒にする。
            If KanaCHK.Value = True Then                            ' ├◆ [AD] かなチェック にチェックが入っている場合
                RDate(1, 6) = Now()                                 ' │├ [AD] 今回のゲームをした日時を取得し、配列の最後尾に代入する
                RTime(1, 6) = wSS                                   ' │├ [AD] 今回のゲームのタイムを取得し、配列の最後尾に代入する
            Else                                                    ' │◆ [AD] かなチェック にチェックが入っていない場合
                RDate(2, 6) = Now()                                 ' │├ [AD] 今回のゲームをした日時を取得し、配列の最後尾に代入する
                RTime(2, 6) = wSS                                   ' │└ [AD] 今回のゲームのタイムを取得し、配列の最後尾に代入する
            End If                                                  ' │
            Call RankSort                                           ' └ 記録の良い順にソートをする
        End If                                                      '
        
        ImgGameOver.Top = 6                                         ' ゲームオーバー画像のy位置
        ImgGameOver.Left = 6                                        ' ゲームオーバー画像のx位置
        TxGameOver.Top = 84                                         ' ゲームオーバーTextのy位置
        TxGameOver.Left = 6                                         ' ゲームオーバーTextのx位置
        
        Btn_Start.Visible = True                                    ' スタートボタンを表示
        Btn_Start.ZOrder (0)                                        ' スタートボタンを最前列に移動
        Btn_Start.SetFocus                                          ' スタートボタンにカーソル移動
        Btn_Start.Caption = "もう1回!"                            ' スタートボタンを「もう1回!」に変更
        inpText.Visible = False                                     ' 入力欄 非表示
        Btn_Enter.Visible = False                                   ' 決定ボタン 非表示
        Btn_neko.Visible = False                                    ' ないボタン 非表示
        Btn_Start.Top = 318                                         ' スタートボタンのy位置
        Btn_Start.Left = 156                                        ' スタートボタンのx位置
        KanaCHK.Top = 318                                           ' [AD] かなチェックのy位置
        KanaCHK.Left = 240                                          ' [AD] かなチェックのx位置
        KanaCHK.Visible = True                                      ' [AD] かなチェックを表示
        
    End Sub

    ・Call OnTimeStop ~
    この塊ではタイマー関連の処理をしています。まずは OnTimeStop を呼び出して予約されているハズの OnTimeStart() をキャンセルします。
    ここまで計測したタイムをTxGameOverラベルに格納しています。

    ・wHH = Hour(GameTime.Caption) ~
    この塊では表示されているタイムを時間(wHH)分(wMM)秒(wSS)に切り分けています。経過時間を秒に変換し、ベスト5に入っているか比較しやすくするための前準備ですね。

    ・If wHH <= 0 Then ~
    まず、前の塊で行ったタイムの切り分けで、もし1時間以上かかっている場合はランク外にしています。10問で1時間以上…多分放置か寝落ちです。
    その次に分に60を掛け算して秒に変換しています。

    このIf文の中には、更にIf文があって処理が分岐しています。

    ・If KanaCHK.Value = True Then ~
    経過時間が59分以内で、且つタイトル画面にあるチェックボックスにチェックが入っている場合は現在日時(記録した日時)とタイム(記録)を二次元配列の1,6に、チェックが無い場合は2,6に格納しています。

    記録はベスト5まで保持する仕様ですが、この時点では6位として二次元配列に格納します。格納し終わったらこの配列にソート(整列)をかけます。
    ソートはプロシージャ RankSort で行われます。

    ・ImgGameOver.Top = 6 ~
    この塊ではゲーム終了画面(ゲームオーバー画面)に必要なオブジェクトの位置をプレイヤーに見える位置に移動させています。

    ・Btn_Start.Visible = True ~
    この塊ではゲームをリスタートする為に必要なオブジェクトの再表示と位置調整をし、ゲーム中に使用していたUIを非表示にしています。


    GetNextQuestion()

    このプロシージャでは次の問題を取得しています。

    '--------------------------------------------------------------------
    '  GetNextQuestion  次の問題を取得
    '
    '   引数    なし
    '
    '   戻値    なし
    '
    '--------------------------------------------------------------------
    Private Sub GetNextQuestion()
    
        AnsIx = fRandom(13, 1)                                      ' 干支正解位置indexをランダムに取得
        Do While True                                               ' ■ ループ
            If EtoSW(AnsIx) = 0 Then Exit Do                        ' ├ ◆ 干支画像出題スイッチがZero(未出題)の場合 ループを抜ける
            AnsIx = AnsIx + 1                                       ' ├ 干支正解位置index +1
            If AnsIx >= 14 Then AnsIx = 1                           ' ├ ◆ 干支正解位置index が14以上の場合 >> 干支正解位置indexを 1 にする
        Loop                                                        ' └ ループ終端
        Image1.Picture = EtoImg(AnsIx)                              ' 干支イメージを表示
        EtoSW(AnsIx) = 1                                            ' 干支画像出題スイッチ [1]出題済 にする
        QuesNo = QuesNo + 1                                         ' 出題数 +1
        QuestionNo.Caption = "問題" & QuesNo                        ' 出題数を画面表示
    End Sub

    ・AnsIx = fRandom(13, 1)
    干支の名称の正解をランダムに取得します。後述する fRandom は引数の範囲内(例では13~1)の値をランダムに取得します。これはシート EtoDataの上から何行目が正解かを意味します。

    ・Do While True~
    このDoループ文の中ではランダムに取得したAnsIxの問題が既に出題されていた場合、AnsIxを+1し、まだ出題されていない問題を探しています。
    もしAnsIxが14以上になると、問題が存在しないのでAnsIxを1に戻します。

    ・Image1.Picture = EtoImg(AnsIx)
    ランダム取得した AnsIx を用いてImage1オブジェクトに干支画像を格納します。これが問題になります。

    ・EtoSW(AnsIx) = 1
    EtoSW配列のAnsIx番目に1を格納することによって、この問題を出題したと記憶しておきます。同じ問題が何度も出ると簡単になっちゃいますからね。

    ・QuesNo = QuesNo + 1 ~
    QuesNo
    は出題数です。10問正解までのタイムアタックなので出題数を数えておきます。また、QuesNoを画面表示しプレイヤーにいま何問目なのかを示しています。


    fRandom()

    最大値と最小値を指定した乱数取得をしています。
    同テーマの記事に何度か出てきているファンクションプロシージャです。
    乱数取得はこれを1つ用意しておくと使いまわしができるので便利です。

    '--------------------------------------------------------------------
    ' fRandom   最大値と最小値を指定した乱数取得ファンクション
    '
    '   引数    dMax    乱数取得範囲の最大値
    '           dMin    乱数取得範囲の最小値
    '
    '   戻値    乱数取得範囲内の値
    '
    '--------------------------------------------------------------------
    Function fRandom(dMax As Integer, dMin As Integer)
        fRandom = Int((dMax - dMin + 1) * Rnd + dMin)               ' 最小~最大値の間の値を乱数を用いて返答する
    End Function

    ・ fRandom = Int((dMax - dMin + 1) * Rnd + dMin)
    Rnd関数は、0以上1未満の値を返答します。
    dMaxは乱数で得られる最大値、dMinは最小値でこのプロシージャの呼び出し元から得られます。

    今回のゲームでは干支(+ネコ)なのでdMaxが13で、dMinが1となります。

    Rndが0.01だったら計算結果は1.13となります。int関数は数値の整数部分だけを取得するので1となりますね。

    Rndが0.99だったら13.87、整数部分だけだと13です。
    1~13の値がランダムで取得されるのがわかりますね。


    RankSort()

    このプロシージャはタイムのベスト5を昇順に並び替える(整列する)処理をしています。中身を見ると変数定義以外の部分では大まかに2つの塊になっています。

    '--------------------------------------------------------------------
    ' RankSort ランキングデータのソート [AD]
    '
    '   引数    なし
    '
    '   戻値    なし
    '
    '--------------------------------------------------------------------
    Private Sub RankSort()
    
        Dim zm     As Integer                                       '【変数定義】整列済添字(第1ループの添字)
        Dim i      As Integer                                       '【  〃   】探索用添字(第2ループの添字)
        Dim wDate  As Date                                          '【  〃   】記録した日時 入替用変数
        Dim wTime  As Integer                                       '【  〃   】記録(秒数)   入替用変数
        Dim sw     As Integer                                       '【  〃   】漢字かな / 漢字のみ切替スイッチ
            
        sw = 2                                                      ' 切替スイッチを[漢字のみ]とする
        If KanaCHK.Value = True Then sw = 1                         ' ■ かなチェックにチェックが入っている場合 >> 切替スイッチを[漢字かな]とする
        For zm = 1 To 6                                             ' ■ 第1ループ
            For i = 6 To zm + 1 Step -1                             ' ├◆ 第2ループ
                If RTime(sw, i - 1) > RTime(sw, i) Then             ' │├▼ 隣り合った配列要素の大小比較
                    wDate = RDate(sw, i)                            ' ││├ 入替処理
                    wTime = RTime(sw, i)                            ' ││├    〃
                    RDate(sw, i) = RDate(sw, i - 1)                 ' ││├    〃
                    RTime(sw, i) = RTime(sw, i - 1)                 ' ││├    〃
                    RDate(sw, i - 1) = wDate                        ' ││├    〃
                    RTime(sw, i - 1) = wTime                        ' ││└    〃
                End If                                              ' ││
            Next i                                                  ' │└ 第2ループ終端
        Next zm                                                     ' └ 第1ループ終端
        
        For i = 1 To 5                                              ' ■ これまでのランキングデータを取得するループ
            If RTime(1, i) <> 9999 Then                             ' ├◆ 記録が9999以外の場合(記録が存在している場合) 漢字かな両対応
                Worksheets("Ranking").Cells(i + 2, 2) = RDate(1, i) ' │├ 漢字かな 記録した日時 をワークシートに入れる
                Worksheets("Ranking").Cells(i + 2, 3) = RTime(1, i) ' │├ 漢字かな 記録(秒数)  をワークシートに入れる
            Else                                                    ' │◆ 記録が9999の場合(記録が存在していない場合)
                Worksheets("Ranking").Cells(i + 2, 2) = Null        ' │├ 漢字かな 記録した日時 をNullとする
                Worksheets("Ranking").Cells(i + 2, 3) = Null        ' │└ 漢字かな 記録(秒数)  をNullとする
            End If                                                  ' │
            If RTime(2, i) <> 9999 Then                             ' ├◆ 記録が9999以外の場合(記録が存在している場合) 漢字のみの場合
                Worksheets("Ranking").Cells(i + 2, 5) = RDate(2, i) ' │├ 漢字のみ 記録した日時 をワークシートに入れる
                Worksheets("Ranking").Cells(i + 2, 6) = RTime(2, i) ' │├ 漢字のみ 記録(秒数)   をワークシートに入れる
            Else                                                    ' │◆ 記録が9999の場合(記録が存在していない場合)
                Worksheets("Ranking").Cells(i + 2, 5) = Null        ' │├ 漢字のみ 記録した日時 をNullとする
                Worksheets("Ranking").Cells(i + 2, 6) = Null        ' │└ 漢字のみ 記録(秒数)  をNullとする
            End If                                                  ' │
        Next i                                                      ' └ ループ終端
    
    End Sub
    

    ・sw = 2 ~
    この塊では配列 RTimeに格納されているタイムを昇順に並び替えています。

    swはタイトル画面のチェックボックスにチェックが入っている場合が1で、無い場合は2になります。これはシートRankingの記録を格納する位置や、二次元配列の第一引数を示しています。

    ・For zm = 1 To 6 ~
    この処理が行われる以前に配列 RTime にはベスト5の記録と、ゲーム終了したばかりの6つ目の記録が格納されています。これを昇順にソートすることで新たなベスト5がわかります。

    この処理はバブルソートというソートアルゴリズムの基本系となりますが、それを説明するだけで記事1つ分になりますので、詳しく知りたい方は次の記事をご覧ください。

    ・For i = 1 To 5 ~
    このプロシージャの後半の塊は、ソートされた配列 RTime および RDate をシート Ranking に書き込む処理です。このループの中で特筆すべきはIf文で経過タイムが9999か、それ以外かの場合が切り分けられている点です。

    ・If RTime(1, i) <> 9999 Then ~
    ・If RTime(2, i) <> 9999 Then ~
    9999
    の判断をするIf文は2つあります。これはタイトル画面のチェックボックスにチェックが入っている場合と、無い場合の2パターンあるからです。シート Rankingで言えば「漢字かな」と「漢字のみ」の2パターンですね。

    9999というのはタイムの初期値です。プロシージャ UserForm_Initialize でシート Ranking からデータを読み込んだ時に記録が入っていない時は9999秒を入れた記憶が残ってますか…ここで伏線回収だったりします。

    なぜ9999秒なのかも説明しましょう。
    ソートをするときに秒数の昇順に並べているからです。記録が無い順位の初期値を0秒にしてしまうと記録更新ができなくなりますよね?
    なので、普通はありえない9999秒を入れておいたのでした!


    WMP1_PlayStateChange()

    WindowsMediaPlayerコントロールのWMP1の再生状態が変化した時というイベントプロシージャです。BGMをループさせたい時にはこれがあると使いまわしできる便利なやつです。

    '--------------------------------------------------------------------
    ' WMP1 再生状態の変化時 [AD]
    '
    '   引数    NewState
    '
    '   戻値    なし
    '
    '--------------------------------------------------------------------
    Private Sub WMP1_PlayStateChange(ByVal NewState As Long)
        If SudStpSW = 0 Then Exit Sub                               ' SudStpSWが[0]停止する の場合 >> このサブルーチンを抜ける
        If NewState = 1 Or NewState = 8 Then WMP1.Controls.Play     ' 再生状態の変化による戻値が 1(停止) or 8(音楽終了) の場合 >> 再び再生する
    End Sub

    この部分については以下の記事の「WMP1 再生状態の変化」で詳しく解説しているのでご覧ください。


    SoundEffectPlay()

    WMP1がBGMを担当しているオブジェクトで、WMP2がサウンドエフェクトを担当しているオブジェクトです。こちらはSEなので単発の再生で大丈夫。ループは必要ありません。

    '--------------------------------------------------------------------
    ' サウンドエフェクト発生処理 [AD]
    '
    '   引数    SENo    [1]正解 [2]不正解 [5]決定音 [9]クリア
    '
    '   戻値    なし
    '
    '--------------------------------------------------------------------
    Private Sub SoundEffectPlay(SENo As Integer)
        WMP2.Controls.stop                                          ' WindowsMediaPlayer2 停止
        WMP2.Url = SudDire & "SE" & SENo & ".mp3"                   ' WindowsMediaPlayer2 に SE + SENo のファイルパスを入れる
        WMP2.Controls.Play                                          ' WindowsMediaPlayer2 再生
    End Sub
    

    ・WMP2.Controls.stop
    ここで一旦WMP2の再生を止めているのは、SEが連続で発生する可能性を考慮して…だったりします。その後はSEが入っているフォルダ(ディレクトリ)とファイル名を指定して再生しています。


    おわりに

    長い記事を読んでくださりありがとうございます。
    そしてコードの解析をされた方はお疲れ様でした!

    VBAで簡単なゲームを作る関連の記事はたくさんあるので好みのゲームを作っていただければ嬉しいです。

    さて次の記事ですが、先日X(Twitter)で同テーマの記事について質問を受けました。解像度によっては表示しきれないゲームの記事がありまして、その対応方法を教えて欲しいとのこと…

    これらの記事は「可能であればほぼ初期設定状態のExcelで動かせるゲーム」を、プログラムを学び始めた方やこれからゲームを作ってみたい方に向けて、UnityやUEといったゲームエンジンや、ツクールやウディタといった専用ツールを使わず、身近なExcelを使って作ってみる!がテーマ。

    そのためWindowsAPI関数はできる限り使わない方が良いのかなーと思っていまして…しかし、それだと不便な点や上手く動かない環境もあります。

    なので、Excel(VBA)で解像度によって表示を変える方法を記事にした方がいいのかなーと思っています…というわけで、それはまた次の機会でっ!


    ここからはオススメ記事の紹介です。

    システム系の勉強したいなーって方にはコチラがオススメです。
    関連記事を以下にまとめてます!(↓)

    「読むとゲームができるマガジン」もオススメです。
    今回のゲームとは別のゲームが色々あります。
    Unityのお話もありますが、Excelである程度のゲームは作れますよ(↓)

    あなたへのおすすめ