ExcelVBAでWindows APIの基本と使い方

Windows API

Windows API（アプリケーションプログラミングインターフェイス）は、Windowsオペレーティングシステムが提供する関数の集合で、アプリケーションがシステムとやり取りするためのものです。これは、コンピュータとその上で動作するプログラムが互いにコミュニケーションをとるのを助ける一連のツールのようなものです。

APIとは

APIは、レストランのメニューのようなものです。メニューを見れば、そのレストランが作れる料理をすべて見ることができます。料理を注文するとき、キッチンでどのように作られているかを知る必要はなく、ただ料理を受け取るだけです。同様に、APIはプログラムで使用できる関数やコマンドの一覧を提供し、オペレーティングシステムの内部動作を知る必要なく、これらの関数を使用できます。

なぜWindows APIを使うのか？

Windows APIを使用すると、以下のようなタスクを実行できます。
（1）ウィンドウやダイアログボックスの操作： 作成、移動、サイズ変更、閉じるなど。
（2）ファイルやディレクトリの操作： 開く、読み書き、削除など。
（3）システムとのやり取り： システム情報の取得、プロセスの管理など。
これらのタスクは非常に強力で、より複雑で効率的なプログラムを作成することができます。

Windows API関数の呼び出し方法

プログラムでWindows API関数を呼び出すには、いくつかのステップがあります。
（1）APIの宣言： 使用するAPIをプログラムに知らせます。
（2）APIの呼び出し： コード内でAPIを使用してタスクを実行します。
以下で各々のステップを紹介します。

（1）APIの宣言

まず、VBAモジュールの先頭でAPIを宣言します。

Declare PtrSafe Function MessageBox Lib "user32" Alias "MessageBoxA" ( _
    ByVal hwnd As LongPtr, _
    ByVal lpText As String, _
    ByVal lpCaption As String, _
    ByVal uType As Long _
) As Long

・PtrSafe: 32ビットと64ビットシステムの両方に対応します。
・Lib "user32": 関数が存在するライブラリを指定します。
・Alias "MessageBoxA": ライブラリ内の関数の正確な名前を指定します。

（2）APIの呼び出し

次に、VBAコード内でAPIを呼び出します。

Sub メッセージボックスを表示()
    Dim 結果 As Long
    結果 = MessageBox(0, "こんにちは、これはメッセージボックスです！", "APIの例", 0)
End Sub

・0: オーナーウィンドウのハンドル（0はオーナーなしを意味します）。
・"こんにちは、これはメッセージボックスです！": 表示するテキスト。
・"APIの例": メッセージボックスのタイトル。
・0: メッセージボックスの種類（0はOKボタンのみを意味します）。
メッセージボックスを表示サブルーチンを実行すると、指定したテキストが表示されたメッセージボックスが表示されます。

結論

Windows APIを理解し使用することで、VBAだけでは実現できない、または非常に手間のかかるタスクを実行できるようになります。