APIについて（Win32API）｜ExcelマクロVBA入門

最終更新日：2019-07-22

第123回.APIについて（Win32API）

一般的にはAPIは、アプリケーションプログラミングインタフェースのことです、
ソフトウェアコンポーネントが互いにやりとりするのに使用するインタフェースの仕様です。

ここでは、Windows標準のWin32APIについて解説します。
APIを使用するには、
まず、Declareステートメントで宣言が必要となります。

Declare ステートメン

ダイナミックリンクライブラリ (DLL) の外部プロシージャへの参照を宣言します。
モジュールレベルで使います。

構文 1
[ Public | Private ]Declare****Sub名前Lib"libname" [ Alias "aliasname"] [([ arglist ])]
構文 2
[ Public | Private ]Declare****関数名前Lib"libname" [ Alias "aliasname"] [([ arglist ])] [ **** 型]

構文を見ても、結局何をどうしたら良いのか分からないと思います。
APIごとに引数の指定が違いますし、つまりは引数の指定方法が知りたいはずです。
使いたいAPIのサンプルを書籍やネットで探して、基本的にはそのまま使えば良いでしょう。

Excel 64Bit版の場合

PtrSafe キーワードが必要になります。
ネット等のサンプルは、ほとんどが32Bit版ですので、適宜PtrSafeキーワードを追加します。
また、
アドレス参照(ポインターおよびハンドルを格納する場合) の引数は、
32Bit版では、Long型ですが、
64Bit版では、LongPtr型 または Longlong型になります。

LongPtr型について

32 ビット環境と64 ビット環境でそれぞれ以下に変換されます。
32ビットシステムでは、符号付き32ビット (4 バイト) の数値
64ビットシステムでは、符号付き64ビット (8 バイト) の数値

Longlong型について

Longlongは、64ビットでのみ有効な宣言型で、64ビット (8 バイト) の符号付き数値になります。
APIの中には、LongPtr型ではなくLonglong型を指定しなければならないものもあるようです。

Excel2010以降では、32BitでもPtrSafe キーワードを入れることができます。
つまり、2010以降でしか使わないのであれば、
PtrSafe キーワードは必ず入れておけば良いことになります。

APIの使用例


  
    
      Declare Sub Sleep Lib "kernel32" (ByVal dwMilliseconds As Long)

      '64bit版のExcelの場合は、以下のようにPtrSafeを付けて下さい。

      'Declare PtrSafe Sub Sleep Lib "kernel32" (ByVal dwMilliseconds As Long)


      Sub untilReady(objIE As Object)

      　　Dim starttime As Date

      　　starttime = Now()

      　　Do While objIE.Busy = True Or objIE.ReadyState <> READYSTATE_COMPLETE

      　　　　Sleep 100

      　　　　DoEvents

      　　　　If Now() > DateAdd("S", 10, starttime) Then

      　　　　　　Exit Do

      　　　　End If

      　　Loop

      End Sub

Sleepはプログラムを任意の時間だけ待機させることができます。
Declare Sub Sleep Lib "kernel32" (ByVal dwMilliseconds As Long)
これで定義し、
Sleep 100
これで、100ミリ秒待機させています。

いろいろなAPIについて

以下のサンプルでは、keybd_eventを使用しています。
全シートの画面キャプチャを取得する（keybd_event）

資料等の作成で、画面キャプチャすることがあると思います。そこで、全シートの画面キャプチャを、新規シートに全て取得するプログラムです。Alt+PrntScrnで、エクセルのウインドウのみキャプチャしています。

マイクロソフトのmsdnで、
よく使われる一部の Windows API をリストし、日本語ドキュメントと英語ドキュメントへのリンクを案内しています。
Windows API リスト
良く使うと書かれていても、膨大な数になっています。
この中から目的の機能を持ったAPIを探すというのは厳しいとは思いますが、いつか役に立つこともあるかと思い掲載しておきます。