VBAのIE制御

document.ReadyStateプロパティはHTMLDocumentオブジェクトのドキュメントの読み込み状態を示します。InternetExplorerの状態をチェックするのに利用するとより安全に処理を行うことができます。こちらでは、その点も含めて解説しています。

目次

• document.ReadyStateプロパティとは
• Webページの完全読込待機処理をするサンプルコード
  • 実行結果
  • 解説
• 利用されているコンテンツ
• InternetExplorerオブジェクトのプロパティ

document.ReadyStateプロパティとは

document.ReadyStateプロパティはHTMLDocumentオブジェクトのドキュメントの読み込み状態を示します。読み込み状態は4段階で、文字列で返す点にご注意ください。こちらもWebページの完全読み込み待機処理で利用します。

objIE.document.readyState = "uninitialized"/"loading"/
"interactive"/"complete"
変数 = objIE.document.readyState

戻り値

Webページの完全読込待機処理をするサンプルコード

Sub sample()

  Dim objIE As InternetExplorer

  'IE(InternetExplorer)のオブジェクトを作成する
  Set objIE = CreateObject("InternetExplorer.Application")

  'IE(InternetExplorer)を表示する
  objIE.Visible = True

  '指定したURLのページを表示する
  objIE.navigate "http://www.vba-ie.net/"

  '完全にページが表示されるまで待機する
  Do While objIE.Busy = True Or objIE.readyState <> 4
    DoEvents
  Loop

  '完全にドキュメントが読み込まれるまで待機する
　Do Until objIE.document.ReadyState = "complete"
　　DoEvents
　Loop

End Sub

※ドラッグ(スワイプ)すると全体を確認できます。

実行結果

「VBAのIE制御」サイトのトップページが表示されます。

解説

Sub sample()
　Dim objIE As InternetExplorer

※ドラッグ(スワイプ)すると全体を確認できます。

sampleのSubステートメントは引数の設定なしです。次に、Dimステートメントを利用して変数objIEをInternetExplorer型で宣言します。

'IE(InternetExplorer)のオブジェクトを作成する
Set objIE = CreateObject("InternetExplorer.Application")

※ドラッグ(スワイプ)すると全体を確認できます。

SetステートメントとCreateObject関数を利用してIEのオブジェクトを作成します。オブジェクト作成によりプロパティやメソッドを利用することができます。

'IE(InternetExplorer)を表示する
objIE.Visible = True

※ドラッグ(スワイプ)すると全体を確認できます。

VisibleプロパティにTrueを設定することで、ブラウザを表示させます。

'指定したURLのページを表示する
objIE.Navigate "http://www.vba-ie.net/"

※ドラッグ(スワイプ)すると全体を確認できます。

Navigateメソッドの第一引数に「http://www.vba-ie.net/」を設定しています。これにより「VBAのIE制御」サイトのトップページが表示されます。

'完全にページが表示されるまで待機する
Do While objIE.Busy = True Or objIE.ReadyState <> 4
　DoEvents
Loop

※ドラッグ(スワイプ)すると全体を確認できます。

こちらは、Do...Loop ステートメントを利用して、ページが完全に読み込まれるまでループさせる処理を行っています。
それぞれのプロパティでWebページが完全に読み込まれた場合の戻り値は、BusyプロパティがFalse、ReadyStateプロパティが4になりますので、たとえBusyプロパティでFalseになったとしてもReadyStateプロパティが4でない場合はループから抜け出すことはできません。
こちらを抜け出すためには、BusyプロパティとReadyStateプロパティの両方が完全に読み込み完了状態になった場合のみとなります。
ということは、ページが完全に読み込まれるまで次の処理へ移動せず待機するということになります。
ちなみにDoEvents関数を設定しているのでは、無限ループに陥った場合に制御を戻しておくためです。

'完全にドキュメントが読み込まれるまで待機する
Do Until objIE.document.ReadyState = "complete"
　DoEvents
Loop

※ドラッグ(スワイプ)すると全体を確認できます。

こちらも、Do...Loop ステートメントを利用して、ドキュメントが完全に読み込まれるまでループさせる処理を行っています。objIEオブジェクトのReadyStateプロパティは読み込み完了時に4を返しますが、HTMLDocumentオブジェクトのReadyStateプロパティは"complete"を返します。
どのオブジェクトのReadyStateプロパティかによって戻り値が異なりますので注意が必要です。ここでは、"complete"を返したときにループ処理を抜けるような処理をしています。

End Sub

※ドラッグ(スワイプ)すると全体を確認できます。

最後はEndステートメントを利用してsampleプロシージャを終了させます。

利用されているコンテンツ

ReadyStateプロパティは、IE(InternetExplorer)を表示させるには必須のプロパティになります。ほとんどのコンテンツで利用されていますので、ここでは代表的なコンテンツを紹介します。

• 指定したURLをIE(InternetExplorer)で起動する
• プログラムのサブルーチン化について
• 指定URLをIEで起動するサブルーチンの作成

InternetExplorerオブジェクトのプロパティ